Сегодня мы рассмотрим концепцию SQL-блокнотов в Azure Data Studio для DBA. SQL-блокноты предоставляют мощный инструмент для управления и автоматизации задач в SQL Server. В этой статье мы обсудим модуль PowerShell ADSSQLNotebook, который позволяет работать с SQL-блокнотами в Azure Data Studio.
Модуль ADSSQLNotebook, доступный на GitHub, предлагает три функции, которые упрощают работу с SQL-блокнотами:
- Convert-ADSPowerShellForMarkdown: Эта функция преобразует код PowerShell в формат Markdown, позволяя вставлять код PowerShell в текстовую ячейку в SQL-блокноте.
- New-ADSWorkBookCell: Эта функция создает новую текстовую ячейку или ячейку с кодом, которую можно добавить к команде New-ADSWorkBook.
- New-ADSWorkBook: Эта функция создает новый SQL-блокнот, используя объекты ячеек, созданные с помощью New-ADSWorkBookCell.
Давайте ближе рассмотрим, как можно использовать эти функции:
Convert-ADSPowerShellForMarkdown
Функция Convert-ADSPowerShellForMarkdown позволяет преобразовывать код PowerShell в формат Markdown. Это полезно, когда вы хотите вставить код PowerShell в текстовую ячейку в SQL-блокноте. Вот пример:
Convert-ADSPowerShellForMarkdown -InputText "Get-ChildItem" -LinkText 'This will list the files' -ToClipBoardЭта команда преобразует код PowerShell “Get-ChildItem” в формат Markdown и устанавливает его в буфер обмена для удобной вставки в ячейку блокнота.
New-ADSWorkBookCell
Функция New-ADSWorkBookCell позволяет создавать новую текстовую ячейку или ячейку с кодом. Затем эту ячейку можно добавить к команде New-ADSWorkBook для создания SQL-блокнота. Вот пример:
$introCelltext = "# Добро пожаловать в мой автоматически созданный блокнот
## Автоматизация
С помощью этого мы можем автоматизировать создание блокнотов для наших нужд"
$Intro = New-ADSWorkBookCell -Type Text -Text $introCelltextВ этом примере мы создаем текстовую ячейку Azure Data Studio и устанавливаем ее в переменную для передачи в функцию New-ADSWorkBook. Это позволяет добавить вводный текст в наш SQL-блокнот.
New-ADSWorkBook
Функция New-ADSWorkBook создает новый SQL-блокнот, используя объекты ячеек, созданные с помощью функции New-ADSWorkBookCell. Вот пример:
$introCelltext = "# Добро пожаловать в мой автоматически созданный блокнот
## Автоматизация
С помощью этого мы можем автоматизировать создание блокнотов для наших нужд"
$SecondCelltext = "## Запуск кода
В следующей ячейке будет некоторый код для запуска
## Субъекты сервера
Ниже приведен код для выполнения на вашем экземпляре, чтобы найти включенные субъекты сервера"
$thirdcelltext = "SELECT Name
FROM sys.server_principals
WHERE is_disabled = 0"
$Intro = New-ADSWorkBookCell -Type Text -Text $introCelltext
$second = New-ADSWorkBookCell -Type Text -Text $SecondCelltext
$third = New-ADSWorkBookCell -Type Code -Text $thirdcelltext
$path = 'C:tempAutoGenerated.ipynb'
New-ADSWorkBook -Path $path -cells $Intro,$second,$thirdВ этом примере мы создаем три ячейки с помощью функции New-ADSWorkBookCell: две текстовые ячейки и одну ячейку с кодом. Затем мы используем эти ячейки для создания SQL-блокнота и сохраняем его как “C:tempAutoGenerated.ipynb”.
Установка и совместимость
Для использования модуля ADSSQLNotebook вы можете установить его из PowerShell Gallery с помощью команды “Install-Module ADSNotebook”. Этот модуль был протестирован в Windows PowerShell 5.1, PowerShell Core 6 и PowerShell 7 на Windows 10 и Ubuntu.
SQL-блокноты в Azure Data Studio предоставляют мощный инструмент для управления и автоматизации задач в SQL Server. С помощью модуля ADSSQLNotebook вы можете легко работать с SQL-блокнотами и оптимизировать свой рабочий процесс. Попробуйте и увидите, как он может улучшить ваш опыт работы с SQL Server!
Спасибо за чтение!