API REST per il pool SQL dedicato (in precedenza SQL Data Warehouse) in Azure Synapse Analytics

Articolo
04/23/2024

API REST per gestire il calcolo per il pool SQL dedicato (in precedenza SQL Data Warehouse) in Azure Synapse Analytics.

Nota

Le API REST descritte in questo articolo sono destinate a pool SQL dedicati (in precedenza SQL Data Warehouse) autonomi e non sono applicabili a un pool SQL dedicato in un'area di lavoro di Azure Synapse Analytics. Per informazioni sulle API REST da usare nello specifico per un'area di lavoro di Azure Synapse Analytics, vedere API REST dell'area di lavoro di Azure Synapse Analytics.

Ridimensionare le risorse di calcolo

Per modificare le unità Data Warehouse, usare l'API REST per creare o aggiornare il database. L'esempio seguente imposta le unità Data Warehouse su DW1000 per il database MySQLDW, ospitato nel server MyServer. Il server appartiene al gruppo di risorse di 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"
    }
}

Pause compute (Sospendere le risorse di calcolo)

Per sospendere un database, usare l'API REST per sospendere i database. L'esempio seguente sospende il database Database02 ospitato sul server Server01. Il server appartiene al gruppo di risorse di 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

Resume compute (Riavviare le risorse di calcolo)

Per avviare un database, usare l'API REST per riprendere i database. L'esempio seguente avvia il database Database02 ospitato sul server Server01. Il server appartiene al gruppo di risorse di 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

Controllare lo stato del database

Nota

Attualmente il controllo dello stato del database può restituire ONLINE mentre il database completa il flusso di lavoro online, generando errori di connessione. Se si usa questa chiamata API per attivare i tentativi di connessione, potrebbe essere necessario aggiungere un ritardo di 2-3 minuti nel codice dell'applicazione.

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

Ottenere la pianificazione della manutenzione

Controllare la pianificazione della manutenzione impostata per un pool SQL dedicato (in precedenza SQL Data Warehouse).

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

Impostare la pianificazione della manutenzione

Per impostare e aggiornare una pianificazione della manutenzione in un pool SQL dedicato esistente (in precedenza SQL Data Warehouse).

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

Passaggi successivi

Per altre informazioni, vedere Gestire le risorse di calcolo.

Condividi tramite