APIs REST para o conjunto de SQL dedicado (anteriormente SQL DW) no Azure Synapse Analytics

Artigo
06/01/2023

APIs REST para gerir a computação do conjunto de SQL dedicado (anteriormente SQL DW) no Azure Synapse Analytics.

Nota

As APIs REST descritas neste artigo destinam-se a conjuntos de SQL dedicados autónomos (anteriormente SQL DW) e não são aplicáveis a um conjunto de SQL dedicado numa área de trabalho do Azure Synapse Analytics. Para obter informações sobre as APIs REST a utilizar especificamente para uma área de trabalho do Azure Synapse Analytics, veja Azure Synapse API REST da área de trabalho do Analytics.

Dimensionar computação

Para alterar as unidades do armazém de dados, utilize a API REST Criar ou Atualizar Base de Dados . O exemplo seguinte define as unidades do armazém de dados como DW1000 para a base de dados MySQLDW, que está alojada no servidor MyServer. O servidor está num grupo de recursos do Azure com o nome 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"
    }
}

Colocar em pausa a computação

Para colocar uma base de dados em pausa, utilize a API REST da Base de Dados em Pausa . O exemplo seguinte coloca em pausa uma base de dados com o nome Database02 alojada num servidor com o nome Server01. O servidor está num grupo de recursos do Azure com o nome 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 uma base de dados, utilize a API REST da Base de Dados do Currículo . O exemplo seguinte inicia uma base de dados denominada Base de Dados02 alojada num servidor com o nome Server01. O servidor está num grupo de recursos do Azure com o nome 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 o estado da base de dados

Nota

Atualmente, verificar o estado da base de dados pode devolver ONLINE enquanto a base de dados está a concluir o fluxo de trabalho online, o que resulta em erros de ligação. Poderá ter de adicionar um atraso de 2 a 3 minutos no código da aplicação se estiver a utilizar esta chamada à API para acionar tentativas de ligação.

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

Obter agenda de manutenção

Verifique o agendamento de manutenção que foi definido para um conjunto de SQL dedicado (anteriormente 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 agenda de manutenção

Para definir e atualizar um agendamento de manutenção num conjunto de SQL dedicado existente (anteriormente 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",
                }
                ]
    }
}

Passos seguintes

Para obter mais informações, veja Gerir computação.

Partilhar via