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 を使用します。 次の例では、サーバー MyServer でホストされているデータベース MySQLDWのデータ ウェアハウス ユニットを DW1000 に設定します。 サーバーは、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
データベースの状態を確認する
注
現在、データベースの状態を確認すると、データベースがオンライン ワークフローを完了している間に ONLINE が返され、接続エラーが発生する可能性があります。 この 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",
}
]
}
}
次のステップ
詳細については、「コンピューティングの 管理」を参照してください。