API REST pour un pool SQL dédié (anciennement SQL DW) dans Azure Synapse Analytics

Article
06/01/2023

API REST pour la gestion du calcul d’un pool SQL dédié (anciennement SQL DW) dans Azure Synapse Analytics.

Notes

Les API REST décrites dans cet article sont destinées aux pools SQL dédiés autonomes (anciennement SQL DW) et ne s’appliquent pas à un pool SQL dédié dans un espace de travail Azure Synapse Analytics. Pour plus d’informations sur les API REST à utiliser spécifiquement pour un espace de travail Azure Synapse Analytics, consultez API REST de l’espace de travail Azure Synapse Analytics.

Mise à l’échelle des ressources de calcul

Pour modifier les unités de l’entrepôt de données, utilisez l’API REST Créer ou mettre à jour une base de données. L’exemple suivant définit les unités de l’entrepôt de données sur DW1000 pour la base de données MySQLDW hébergée sur le serveur MyServer. Le serveur est un groupe de ressources Azure appelé 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"
    }
}

Suspension du calcul

Pour suspendre une base de données, utilisez l’API REST Suspendre la base de données. Dans l’exemple suivant, une base de données appelée Database02 et hébergée sur un serveur appelé Server01 est interrompue. Le serveur est un groupe de ressources Azure appelé 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

Reprise du calcul

Pour démarrer une base de données, utilisez l’API REST Reprendre la base données. Dans l’exemple suivant, une base de données appelée Database02 et hébergée sur un serveur appelé Server01 est démarrée. Le serveur est un groupe de ressources Azure appelé 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

Vérifier l’état de la base de données

Notes

Vérifier à cet instant l’état de la base de données peut retourner ONLINE alors que la base de données effectue le workflow en ligne, ce qui entraîne des erreurs de connexion. Vous devrez peut-être ajouter un délai de 2 à 3 minutes à votre code d’application si vous utilisez cet appel d’API pour déclencher des tentatives de connexion.

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

Obtenir la planification de la maintenance

Vérifiez la planification de la maintenance qui a été définie pour un pool SQL dédié (anciennement 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

Définir la planification de la maintenance

Pour définir et mettre à jour une planification de la maintenance sur un pool SQL dédié (anciennement SQL DW) existant.

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

Étapes suivantes

Pour plus d’informations, voir Gérer le calcul.

Partager via