用於 Azure Synapse Analytics 中專用 SQL 集區 (先前為 SQL DW) 的 REST API

發行項
08/15/2023

用於為 Azure Synapse Analytics 中專用 SQL 集區 (先前為 SQL DW) 管理計算的 REST API

注意

本文所述的 REST API 適用於獨立專用 SQL 集區 (先前稱為 SQL DW)，不適用於 Azure Synapse Analytics 工作區中的專用 SQL 集區。如需要專門用於 Azure Synapse Analytics 工作區的 REST API 的詳細資訊，請參閱 Azure Synapse Analytics 工作區 REST API。

調整計算

若要變更資料倉儲單位，請使用建立或更新資料庫 REST API。下列範例會將資料庫的資料倉儲單位設定為 DW1000，該資料庫 MySQLDW 裝載于伺服器 MyServer 上。此伺服器位於 ResourceGroup1 這個 Azure 資源群組。

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

暫停計算

若要暫停資料庫，請使用暫停資料庫 REST API。下例會暫停裝載在 Server01 伺服器上的 Database02 資料庫。此伺服器位於 ResourceGroup1 這個 Azure 資源群組。

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

繼續計算

若要啟動資料庫，請使用繼續資料庫 REST API。下例會啟動裝載在 Server01 伺服器上的 Database02 資料庫。此伺服器位於 ResourceGroup1 這個 Azure 資源群組。

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

檢查資料庫狀態

注意

目前，檢查資料庫狀態可能會在資料庫正在完成線上工作流程時恢復上線，因而導致連線錯誤。如果使用此 API 呼叫來觸發連線嘗試，則可能需要在應用程式程式碼中增加 2 到 3 分鐘的延遲。

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

取得維護排程

檢查已針對專用 SQL 集區 (先前為 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

設定維護排程

若要在現有的專用 SQL 集區 (先前為 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",
                }
                ]
    }
}

後續步驟

如需詳細資訊，請參閱管理計算能力。