В данном блог посте речь пойдет конкретно о работе с SQL Azure из Powershell. Основные возможности рассмотрим на примерах, кое-где в сравнении с тем, как это можно сделать через Preview версию management портала.
Для старта понадобятся:
1. Powershell 3.0 - команды для управления SQL Azure выполняются минимум с версии 3.0.
2. Windows Azure Powershell - "ажурная" Powershell консоль, с которой в комплекте идут нужные скрипты, которые мы будем импортить. Её можно скачать по указанной ссылке, но лично я пользуюсь Web Platform Installer, что значительно удобнее.
3. Последняя версия Windows Azure SDK. В моем случае - это 1.8.
Позаботьтесь также об удобном Powershell редакторе. В моем случае - это PowershellGUI. Но подойдет хоть блокнот - лишь бы вам было комфортно.
Как вы наверняка знаете, Powershell имеет verb-noun синтаксис. Следовательно, существует перечень команд Get/Set/New/Remove.
Пройдемся по списку команд.
| Команда | Описание |
|---|---|
| Get-AzureSqlDatabaseServer | Возвращает информацию о SQL Azure сервере по указанному имени. Если имя не указано, вернутся все доступные в подписке сервера. |
| Get-AzureSqlDatabase | Возвращает базу данных по указанному имени в конексте указанного сервера. Если же имя БД не указано - возвращает все БД на указанном сервере. |
| Get-AzureSqlDatabaseServerFirewallRule | Возвращает информацию о SQL Azure сервере по указанному имени. Если имя не указано, вернутся все доступные в подписке сервера. |
| New-AzureSqlDatabaseServer | Создает экземпляр Azure SQL Server рамках подписки. |
| New-AzureSqlDatabase | Создает новую БД в контексте указанного сервера. |
| New-AzureSqlDatabaseServerFirewallRule | Добавляет правило работы firewall для указанного сервера в подписке. |
| Remove-AzureSqlDatabase | Удаляет базу данных в указанном контексте. |
| Remove-AzureSqlDatabaseServer | Удаляет указанный экземпляр SQL Azure сервера. |
| Remove-AzureSqlDatabaseServerFirewallRule | Удаляет добавленное правило для firewall в контексте указанного сервера. |
| Set-AzureSqlDatabase | Вносит изменения в настройки указанной БД - имя, макс. размер и т.д. |
| Set-AzureSqlDatabaseServer | Вносит изменения в настройки SQL Azure сервера. Сейчас это только возможность изменить пароль администратора. |
| Set-AzureSqlDatabaseServerFirewallRule | Вносит изменения в уже созданное firewall правило. |
Некоторые из этих команд рассмотрим ниже. Об остальных же достаточно информации можно найти по указанным ссылкам на MSDN.
Итак, открывайте свой редактор и поехали.
С чего начнем
Первым делом необходимо импортировать модуль, который позволит нам работать с SQL Azure Powershell командами.
Import-Module 'C:\Program Files (x86)\Microsoft SDKs\Windows Azure\PowerShell\Azure\Azure.psd1'Расположение этого модуля видно по коду. И вот, собственно, одна из причин, зачем необходимо было установить Azure Powershell.
Выбор подписки
Теперь сконфигурируем подписку, с которой планируем работать. Для этого есть два варианта:
1. Импортировать настройки (subscription id, certificate) из publishsettings файла.
2. Установить необходимые параметры, включая сертификат, вручную.
Воспользуемся первым вариантом. Если у вас есть скачанный pubslishsettings файл - отлично.
Если же нет - один из удобных вариантов его получения - команда Get-AzurePublishSettingsFile. Она запустит браузер по нужной ссылке, где вы сможете скачать файл с настройками.
Импортированные/заданные настройки в итоге будут храниться в системе: C:\Users\username\AppData\Roaming\Windows Azure Powershell.
Позаботьтесь также, чтобы файл с настройками не был readonly. Я не вдавался в подробности, но в моем случае readonly файл был причиной для ошибок. Поэтому просто стоит принять к сведению.
Файл готов? Тогда к делу.
Import-AzurePublishSettingsFile "pathToPublishSettingsFile" Set-AzureSubscription -SubscriptionName "nameOfSubscription"Если убрать вторую строку из примера, то будет выбрана подписка по умолчанию.
Прошло без ошибок? Значит мы готовы для работы с SQL Azure через Powershell.
Создание сервера
Для начала попробуем получить список доступных в подписке серверов SQL Azure.
На портале:
Через Powershell:
$availableServers = Get-AzureSqlDatabaseServer
Затем, создадим экземпляр SQL Azure Server.
Через портал:
Как видно, чекбокс, позволяющий Azure Web сервисам из подписки обращаться к новосозданному серверу - включен.
Через Powershell:
$newSqlServer= New-AzureSqlDatabaseServer -Location "WEST EUROPE" -AdministratorLogin "testUser" -AdministratorLoginPassword "testWorld123"
Firewall
По умолчанию Azure SQL Server позвляет к себе подключиться только IP адресам, указанным как разрешенные в firewall.
Зайдем в конфигурацию нового сервера, созданного через Powershell - в правилах пусто. Стоит обратить внимание, что к данному серверу запрещено подключение Azure сервисам из подписки.
Разработчики не предусмотрели такого параметра для New-AzureSqlDatabaseServer, хотя я считаю, что именно там ему и место.
На помощь приходит Azure Firewall. Если добавить правило, в котором в качестве IP Address будет указан 0.0.0.0, то Azure интерпретирует его именно как разрешение сервисам внутри облака подключаться к данному экземпляру SQL Server.
$newSqlServer| New-AzureSqlDatabaseServerFirewallRule -RuleName "AzureServices" -StartIpAddress "0.0.0.0" -EndIpAddress "0.0.0.0"Также добавим в список правил IP адрес машины, с которой мы планируем далее выполнять наш скрипт. Иначе же при создании контекста все свалится с ошибкой доступа.
Работа с контекстом
New-AzureSqlDatabaseServerContext - создает соединение к указанному серверу.
Для подключения нам понадобятся учетные данные администратора, которые мы указывали при создании сервера.
Создадим объект класса PSCredential и передадим иму имя и пароль. Рекомендую также взглянуть на полезную команду Get-Credential, которая позволит запрашивать имя и пароль непосредственно при выполнении скрипта.
Займемся созданием контекста:
$servercredential = new-object System.Management.Automation.PSCredential("testUser", ("testWorld123"| ConvertTo-SecureString -asPlainText -Force))
#Вариант 1.
$serverContext = $newSqlServer | New-AzureSqlDatabaseServerContext -Credential $serverCredential
#Вариант 2.
$serverContext = $New-AzureSqlDatabaseServerContext -ServerName "ywdddhc9qo" -Credential $serverCredential
В первом варианте - используем уже имеющуюся переменную, где есть вся информация о нашем сервере. Во втором - имя сервера (возможно также указать имя полностью либо ссылку).Контекст получен. Теперь создадим базу данных.
В Powershell это выглядит вот как:
$testDB = New-AzureSqlDatabase $serverContext -DatabaseName "testDB" –Edition "Web" -MaxSizeGB 1 -Collation "SQL_Latin1_General_CP1_CI_AS"
Обязательными в данной команде являются контекст и имя новой БД. Если не указать другие параметры, то их значения будут установлены по умолчанию.
Через портал же это выглядит вот так. И само собой, руками контекст нам получать не надо.
Указываем имя, версию (WEB/Business), максимальный размер, collation, подписку и сервер в указанной подписке.
Теперь получим список с имеющимися на сервере БД. Для этого воспользуемся командой Get-AzureSqlDatabase. Если имя БД указано, то команда попытается найти конкретную базу. Если же не указано - вернет все имеющиеся.
$allDBs = Get-AzureSqlDatabase $serverContext
Выполнение SQL скриптов
Теперь, когда процесс и стандартные возможности работы с SQL Azure ясны, хотелось бы еще написать о работе со структурой базы.
Конечно, можно подключаться к нашей БД через SQL Server Management Studio либо через Management portal, где и выполнять нужный SQL при малейшем изменении. Но если уж автоматизировать, то весь процесс.
К сожалению, хранить весь SQL в одном файлике - не выйдет. Дело в том, что в SQL Azure есть набор команд, которые могут быть единственными в пакете. Если же это правило нарушить - получим ошибку.
В целом, не проблема - будем хранить скрипты в нескольких SQL файлах. Теперь вопрос, как, собственно, выполнить эти скрипты? Для этого воспользуемся sqlcmd.
В Powershell для этого есть команда Invoke-Sqlcmd. Перед её использованием нужно будет добавить пару оснасток (snap-in).
Invoke-Sqlcmd позволяет задать файл, в котором лежит SQL скрипт, а также есть возможность вписать непосредственно Query для выполнения. Параметры взаимоисключающие.
В качестве параметра ServerInstance необходимо передавать полное имя нашего сервера, то есть включая "database.windows.net".
Ну что ж, приступим.
#Добавляем оснастки для работы с SQL Server Add-pssnapin sqlserverprovidersnapin100 Add-pssnapin sqlservercmdletsnapin100 #Выполняем имеющийся SQL скрипт $serverName = "ywdddhc9qo" + ".database.windows.net" Invoke-Sqlcmd -InputFile "pathToSQLFile" -ServerInstance $serverName -Database "testDB" -Username "testUser" -Password "testWorld123"
Подведем итоги
Как вы убедились/знаете, все описанное в посте можно сделать и через портал/management studio. Но когда кол-во БД и серверов возрастает либо в вашем распоряжении несколько environment-ов (DEV/QA/ProdDemo/PROD), то на помощь как раз и приходит столь полезный инструмент для автоматизации.
И все самые необходимые возможности команда Windows Azure нам уже предоставила.
Будем следить за дальнейшим развитием.
