APIs REST para o pool de SQL dedicado (anteriormente conhecido como SQL DW) no Azure Synapse Analytics

Artigo
06/01/2023

APIs REST para gerenciar a computação do pool de SQL dedicado (anteriormente conhecido como SQL DW) no Azure Synapse Analytics.

Observação

As APIs REST descritas neste artigo são para pools de SQL dedicados autônomos (anteriormente SQL DW) e não são aplicáveis a um pool de SQL dedicado em um workspace do Azure Synapse Analytics. Para obter informações sobre as APIs REST para usar especificamente em um workspace do Azure Synapse Analytics, confira API REST do espaço de trabalho do Azure Synapse Analytics.

Computação de escala

Para alterar as unidades do data warehouse, use a API REST Criar ou Atualizar Banco de Dados. O exemplo a seguir define as unidades do data warehouse como DW1000 do banco de dados MySQLDW, hospedado no servidor MyServer. O servidor está em um grupo de recursos do Azure chamado 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"
    }
}

Pausar computação

Para pausar um banco de dados, use a API REST Pausar o banco de dados. O exemplo a seguir pausa um banco de dados chamado Database02 hospedado em um servidor chamado Server01. O servidor está em um grupo de recursos do Azure chamado 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

Retomar a computação

Para iniciar um banco de dados, use a API REST Retornar o banco de dados. O exemplo a seguir inicia um banco de dados chamado Database02 hospedado em um servidor chamado Server01. O servidor está em um grupo de recursos do Azure chamado 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

Verificar estado do banco de dados

Observação

Atualmente, verificar o estado do banco de dados pode retornar ONLINE enquanto o banco de dados estiver concluindo o fluxo de trabalho online, resultando em erros de conexão. Talvez seja necessário adicionar um atraso de 2 a 3 minutos no código do aplicativo se você estiver usando essa chamada à API para disparar tentativas de conexão.

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

Obter o agendamento de manutenção

Verifique o agendamento de manutenção que foi definido para um pool de SQL dedicado (anteriormente conhecido como SQL DW).

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

Definir o agendamento de manutenção

Para definir e atualizar um agendamento de manutenção em um pool de SQL dedicado existente (anteriormente conhecido como SQL DW).

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",
                }
                ]
    }
}

Próximas etapas

Para saber mais, veja Gerenciar computação.

Compartilhar via