REST-APIs für einen dedizierten SQL-Pool (bisher SQL DW) in Azure Synapse Analytics

Artikel
06/01/2023

REST-APIs für die Computeverwaltung für einen dedizierten SQL-Pool (bisher SQL DW) in Azure Synapse Analytics.

Hinweis

Die REST-APIs, die in diesem Artikel beschrieben werden, sind für eigenständige dedizierte SQL-Pools (ehemals SQL DW) bestimmt und nicht auf einen dedizierten SQL-Pool im Azure Synapse Analytics-Arbeitsbereich anwendbar. Informationen zu REST-APIs, die speziell für einen Azure Synapse Analytics-Arbeitsbereich verwendet werden, finden Sie unter Azure Synapse Analytics-Arbeitsbereichs-REST-API.

Skalieren von Computeressourcen

Um die DWUs (Data Warehouse Units) zu ändern, verwenden Sie die REST-API zum Erstellen oder Aktualisieren einer Datenbank. Im folgenden Beispiel werden die Data Warehouse-Einheiten für die Datenbank MySQLDW, die auf dem Server „MyServer“ gehostet wird, auf „DW1000“ festgelegt. Der Server befindet sich in einer Azure-Ressourcengruppe namens „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"
    }
}

Anhalten von Computeressourcen

Zum Anhalten einer Datenbank verwenden Sie die REST-API zum Anhalten der Datenbank. Im folgenden Beispiel wird die auf dem Server „Server01“ gehostete Datenbank mit der Bezeichnung „Database02“ angehalten. Der Server befindet sich in einer Azure-Ressourcengruppe namens „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

Fortsetzen von Computeressourcen

Zum Starten einer Datenbank verwenden Sie die REST-API zum Fortsetzen der Datenbank. Im folgenden Beispiel wird die auf dem Server „Server01“ gehostete Datenbank mit der Bezeichnung „Database02“ gestartet. Der Server befindet sich in einer Azure-Ressourcengruppe namens „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

Überprüfen des Datenbankzustands

Hinweis

Derzeit kann beim Überprüfen des Datenbankzustands ONLINE zurückgegeben werden, während die Datenbank den Online-Workflow ausführt. Dies führt zu Verbindungsfehlern. Sie müssen möglicherweise eine Verzögerung von 2 bis 3 Minuten in Ihrem Anwendungscode hinzufügen, wenn Sie diesen API-Aufruf zum Auslösen von Verbindungsversuchen verwenden.

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

Abrufen des Wartungszeitplans

Überprüfen Sie den Wartungsplan, der für einen dedizierten SQL-Pool (bisher SQL DW) festgelegt wurde.

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

Festlegen des Wartungszeitplans

Festlegen und Aktualisieren eines Wartungsplans für einen dedizierten SQL-Pool (bisher 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",
                }
                ]
    }
}

Nächste Schritte

Weitere Informationen finden Sie unter Verwalten von Computeressourcen in Azure SQL Data Warehouse.

Freigeben über