你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Azure Synapse Analytics 中专用 SQL 池（以前称为 SQL DW）的 REST API

项目
06/01/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。以下示例将托管在服务器 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",
                }
                ]
    }
}

后续步骤

有关详细信息，请参阅管理计算。

通过