REST API для выделенного пула SQL (ранее хранилища данных SQL) в Azure Synapse Analytics

Статья
06/01/2023

REST API для управления вычислительными ресурсами для выделенного пула SQL (ранее хранилища данных SQL) в Azure Synapse Analytics.

Примечание

Описанные в этой статье REST API предназначены для автономных выделенных пулов SQL (ранее — хранилище данных SQL) и неприменимы к выделенным пулам SQL в рабочей области Azure Synapse Analytics. Дополнительные сведения об интерфейсах REST API, специально предназначенных для рабочих областей Azure Synapse Analytics, см. в статье REST API для рабочих областей Azure Synapse Analytics.

Масштабирование вычислительных ресурсов

Чтобы изменить число DWU, используйте REST API создания или обновления базы данных. В следующем примере для единиц хранилища данных устанавливается значение DW1000 для базы данных MySQLDW, размещенной на сервере MyServer. Сервер находится в группе ресурсов Azure с именем ResourceGroup1.

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Sql/servers/{server-name}/databases/{database-name}?api-version=2020-08-01-preview HTTP/1.1
Content-Type: application/json; charset=UTF-8

{
    "location": "West Central US",
    "sku": {
        "name": "DW200c"
    }
}

Приостановка работы вычислительных ресурсов

Чтобы приостановить базу данных, используйте REST API приостановки базы данных. В приведенном ниже примере приостанавливается работа базы данных с именем Database02, размещенной на сервере с именем Server01. Сервер находится в группе ресурсов Azure с именем ResourceGroup1.

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Sql/servers/{server-name}/databases/{database-name}/pause?api-version=2020-08-01-preview HTTP/1.1

Возобновление работы вычислительных ресурсов

Чтобы запустить базу данных, используйте REST API возобновления базы данных. В приведенном ниже примере запускается база данных с именем Database02, размещенная на сервере с именем Server01. Сервер находится в группе ресурсов Azure с именем ResourceGroup1.

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Sql/servers/{server-name}/databases/{database-name}/resume?api-version=2020-08-01-preview HTTP/1.1

Проверка состояния базы данных

Примечание

Сейчас проверка состояния базы данных может вернуть значение В СЕТИ, пока база данных завершает рабочий процесс в сети, что приводит к ошибкам подключения. Может потребоваться добавить в код приложения задержку в 2–3 минуты, если вы используете этот вызов API для активации попыток подключения.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}?api-version=2020-08-01-preview

Получение информации о расписании обслуживания

Проверка расписания обслуживания, установленного для выделенного пула SQL (ранее хранилища данных SQL).

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Sql/servers/{server-name}/databases/{database-name}/maintenanceWindows/current?maintenanceWindowName=current&api-version=2017-10-01-preview HTTP/1.1

Составление расписания обслуживания

Установка и обновление расписания обслуживания в существующем выделенном пуле SQL (ранее хранилище данных SQL).

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Sql/servers/{server-name}/databases/{database-name}/maintenanceWindows/current?maintenanceWindowName=current&api-version=2017-10-01-preview HTTP/1.1

{
    "properties": {
        "timeRanges": [
                {
                                "dayOfWeek": "Saturday",
                                "startTime": "00:00",
                                "duration": "08:00",
                },
                {
                                "dayOfWeek": "Wednesday",
                                "startTime": "00:00",
                                "duration": "08:00",
                }
                ]
    }
}

Дальнейшие действия

Дополнительные сведения см. в статье Управление вычислительными ресурсами в хранилище данных SQL Azure.