你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
本文介绍如何使用 REST API 管理和监视 由 Azure 备份 备份备份的 SQL Server 数据库。 还可以使用 Azure CLI 和 Azure 门户 管理 SQL 数据库备份。
若要查看我们今天支持的备份和还原方案,请参阅 支持矩阵。 有关常见问题,请参阅 常见问题。
监视作业
Azure 备份服务会触发在后台运行的作业。 这包括触发备份、还原操作和禁用备份等方案。 可以通过 ID 跟踪这些作业。 详细了解如何管理备份和还原作业。
从操作中获取作业信息
操作(例如触发备份)将返回 jobID 作为响应。
例如:触发备份 REST API操作的最终响应如下所示:
{
"id": "cd2a3b13-d392-4e81-86ac-02ea91cc70b9",
"name": "cd2a3b13-d392-4e81-86ac-02ea91cc70b9",
"status": "Succeeded",
"startTime": "2018-05-28T11:43:21.6516182Z",
"endTime": "2018-05-28T11:43:21.6516182Z",
"properties": {
"objectType": "OperationStatusJobExtendedInfo",
"jobId": "c22eca5d-0c1c-48a0-a40d-69bef708d92a"
}
}
你可以通过 jobId 字段标识备份作业,并且可以如此处所述使用 GET 请求进行跟踪。
跟踪作业
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupJobs/{jobName}?api-version=2016-12-01
{jobName} 是上述提到的jobId。 响应为“200 (正常)”其中 status 字段指示作业的状态。 当状态为“Completed”或“CompletedWithWarnings”之后,extendedInfo部分将显示任务的更多详细信息。
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/Microsoft.RecoveryServices/vaults/SQLServer2012/backupJobs/c22eca5d-0c1c-48a0-a40d-69bef708d92a?api-version=2016-12-01
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 正常 | JobResource (作业资源) | 确定 |
响应示例
提交“GET”URI 后,将返回 200 响应。
HTTP/1.1 200 OK
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: e057b496-8ceb-45b6-bd9e-367f7dd73d6d
x-ms-client-request-id: 1ffda117-b2c0-4a80-a9ba-43ba66eaec9b; 1ffda117-b2c0-4a80-a9ba-43ba66eaec9b
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14999
x-ms-correlation-request-id: e057b496-8ceb-45b6-bd9e-367f7dd73d6d
x-ms-routing-request-id: SOUTHINDIA:20180528T115536Z:e057b496-8ceb-45b6-bd9e-367f7dd73d6d
Cache-Control: no-cache
Date: Mon, 28 May 2018 11:55:35 GMT
Server: Microsoft-IIS/8.0
X-Powered-By: ASP.NET
{
"id": "/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/microsoft.recoveryservices/vaults/SQLServer2012/backupJobs/c22eca5d-0c1c-48a0-a40d-69bef708d92a",
"name": "c22eca5d-0c1c-48a0-a40d-69bef708d92a",
"type": "Microsoft.RecoveryServices/vaults/backupJobs",
"properties": {
"jobType": "AzureWorkloadJob",
"workloadType": "SQLDataBase",
"duration": "00:03:13.6439467",
"actionsInfo": [
1
],
"errorDetails": [
{
"errorCode": 510008,
"errorString": "Operation cancelled as a conflicting operation was already running on the same database.",
"errorTitle": "OperationCancelledBecauseConflictingOperationRunningUserError",
"recommendations": [
"Please try again after sometime."
]
}
],
"extendedInfo": {
"tasksList": [
{
"taskId": "Transfer data to vault",
"status": "Failed"
}
],
"propertyBag": {
"Data Transferred (in MB)": "0"
}
},
"entityFriendlyName": "MSSQLSERVER/msDB [sqlserver-0.contoso.com]",
"backupManagementType": "AzureWorkload",
"operation": "Backup (Full)",
"status": "Failed",
"startTime": "2018-05-28T11:43:21.6516182Z",
"endTime": "2018-05-28T11:46:35.2955649Z",
"activityId": "6b033cf6-f875-4c03-8985-9add07ec2845"
}
}
}
列出受保护的SQL实例和数据库
要列出 SQL 实例及其数据库以实现实例级快照保护,请使用 API 版本 2024-01-31-preview。 用你的保险库详情替换URI占位符。 以下示例展示了选定的响应字段。
列表受保护的SQL实例
按itemType eq 'SQLInstance'筛选受保护项:
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupProtectedItems?api-version=2024-01-31-preview&$filter=backupManagementType eq 'AzureWorkload' and itemType eq 'SQLInstance'
响应包含一个 value 数组。 每个实例都包含其受保护的项目名称、容器名称、子数据库和保护状态。 例如:
{
"value": [
{
"name": "SQLInstance;mssqlserver",
"properties": {
"childDBList": ["MSSQLSERVER;testdb", "MSSQLSERVER;testdb1", "MSSQLSERVER;testdb2"],
"instanceProtectionReadiness": "Ready",
"friendlyName": "mssqlserver",
"serverName": "sqlserver-0",
"protectedItemType": "AzureVmWorkloadSQLInstance",
"backupManagementType": "AzureWorkload",
"workloadType": "SQLInstance",
"containerName": "VMAppContainer;Compute;SQLServerPMDemo;sqlserver-0",
"protectionStatus": "Healthy",
"protectionState": "IRPending",
"protectedItemDataSourceId": "2265943933205758867"
}
}
]
}
保存返回的容器名称和受保护项名称,供后续请求使用。 对于实例时间点还原查询,还需保存 protectedItemDataSourceId。
列出实例下受保护的数据库
列出保管库中的数据库保护项:
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupProtectedItems?api-version=2024-01-31-preview&$filter=backupManagementType eq 'AzureWorkload' and itemType eq 'SQLDatabase'
在返回的 value 数组中,识别出将 protectionLevel 设置为 DatabaseUnderInstance 的数据库。 使用 parentProtectedItem,连同容器和服务器细节,来识别父实例。 数据库项目的属性可以包括:
{
"parentProtectedItem": "mssqlserver",
"protectionLevel": "DatabaseUnderInstance",
"friendlyName": "testdb",
"serverName": "sqlserver-0",
"parentName": "MSSQLSERVER",
"protectedItemType": "AzureVmWorkloadSQLDatabase",
"backupManagementType": "AzureWorkload",
"workloadType": "SQLDataBase"
}
建立一个受保护的SQL实例
要检索一个实例,使用其返回的容器和受保护的项目名称:
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2024-01-31-preview
例如, {protectedItemName} 可以是 SQLInstance;mssqlserver。 响应包括 childDBList、 instanceProtectionReadiness和 protectionState。 如果该项被安排为延迟删除,请同时检查 isScheduledForDeferredDelete、deferredDeleteTimeInUTC 和 softDeleteRetentionPeriod。
修改策略
若要更改保护数据库的策略,请使用与启用保护相同的格式。 但需在请求正文中提供新的策略 ID 并提交请求。 例如:要将 testVM 的策略从“HourlyLogPolicy”更改为“ProdPolicy”,请在请求正文中提供“ProdPolicy”ID 。
{
"properties": {
"backupManagementType": "AzureWorkload",
"workloadType": "SQLDataBase",
"policyId": "/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerSelfHost/providers/microsoft.recoveryservices/vaults/SQLServer2012/backupPolicies/ProdPolicy"
},
"location": "westcentralus"
}
响应将采用与上文所述的启用保护相同的格式。
修改快照保护实例的策略
提交实例保护项的 PUT 请求,并提供新的快照策略ID:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2024-01-31-preview
{
"properties": {
"backupManagementType": "AzureWorkload",
"workloadType": "SQLInstance",
"protectedItemType": "AzureVmWorkloadSQLInstance",
"friendlyName": "MSSQLSERVER",
"policyId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupPolicies/{newPolicyName}",
"childDatabaseNameList": ["model"]
}
}
替换JSON正文中的占位符和URI。 在 childDatabaseNameList 中使用实例选定的数据库名称。
恢复 SQL 实例的备份
要继续备份,请向实例受保护项提交带有快照策略 ID 的 PUT 请求。 以下示例使用空的 childDatabaseNameList 进行恢复操作:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2024-01-31-preview
{
"properties": {
"backupManagementType": "AzureWorkload",
"workloadType": "SQLInstance",
"protectedItemType": "AzureVmWorkloadSQLInstance",
"friendlyName": "MSSQLSERVER",
"policyId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupPolicies/SQLInstanceSnapPolicy",
"childDatabaseNameList": []
}
}
使用实例受保护项名称,例如 SQLInstance;mssqlserver,并将策略 ID 占位符替换为你的保管库实际值。 跟踪生成的操作和作业,如监控作业中所述。
停止保护并保留现有数据
若要取消对已受保护数据库的保护,但保留已备份的数据,请删除用于启用备份的请求正文中的策略,并提交请求。 删除与策略的关联后,将不再触发备份,也不会创建新的恢复点。
{
"properties": {
"protectedItemType": "AzureVmWorkloadSQLDatabase",
"protectionState": "ProtectionStopped",
"sourceResourceId":
"/subscriptions/00000000-0000-0000-0000-0000000000/resourceGroups/SQLServerPMDemo/providers/Microsoft.Compute/virtualMachines/sqlserver-0",
"policyId": ""
}
}
示例响应
停止对数据库的保护是一个异步操作。 此操作会创建另一个需要跟踪的操作。 它将返回两个响应:创建另一个操作时为“202 (已接受)”,该操作完成时为“200”。
成功接受操作时的响应标头:
Status Code:
OK
Headers:
Pragma : no-cache
X-Content-Type-Options : nosniff
x-ms-request-id : 388c9359-e237-4644-8f6c-38ae5eb0dfcb
x-ms-client-request-id : 5ef896e6-d812-431a-ad58-9d9ee1bb8bb3,5ef896e6-d812-431a-ad58-9d9ee1bb8bb3
Strict-Transport-Security : max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-resource-requests: 107
x-ms-correlation-request-id : 388c9359-e237-4644-8f6c-38ae5eb0dfcb
x-ms-routing-request-id : SOUTHINDIA:20211126T054036Z:388c9359-e237-4644-8f6c-38ae5eb0dfcb
Cache-Control : no-cache
Date : Fri, 26 Nov 2021 05:40:36 GMT
Server : Microsoft-IIS/10.0
X-Powered-By : ASP.NET
Body:
{
"id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"name": "TestOBJ",
"status": "Succeeded",
"startTime": "2021-11-26T05:36:36.5262731Z",
"endTime": "2021-11-26T05:36:36.5262731Z",
"properties": {
"objectType": "OperationStatusJobExtendedInfo",
"jobId": "68178d86-d564-460b-9643-829046aac1b1"
}
}
然后,通过发出 GET 命令并使用 Location 标头或 Azure-AsyncOperation 标头来追踪结果操作:
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupoperations/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2016-12-01
响应正文
{
"id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
"name": "TestOBJ",
"status": "Succeeded",
"startTime": "2021-11-26T05:36:36.5262731Z",
"endTime": "2021-11-26T05:36:36.5262731Z",
"properties": {
"objectType": "OperationStatusJobExtendedInfo",
"jobId": "68178d86-d564-460b-9643-829046aac1b1"
}
}
停止保护受实例保护的数据库
对于通过实例快照策略保护的数据库,应向受保护的数据库项提交PUT请求,而非实例项:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/Azure/protectionContainers/{containerName}/protectedItems/SQLDatabase;MSSQLSERVER;tdb2?api-version=2024-01-31-preview
将protectionState设置为ProtectionStopped,并包含实例快照策略 ID:
{
"properties": {
"backupManagementType": "AzureWorkload",
"workloadType": "SQLDataBase",
"friendlyName": "MSSQLSERVER;tdb2",
"protectedItemType": "AzureVmWorkloadSQLDatabase",
"protectionState": "ProtectionStopped",
"policyId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupPolicies/SQLInstanceSnapPolicy"
}
}
将示例数据库项名称替换为为您的数据库返回的名称,并替换策略 ID 占位符。 该操作在保留现有备份数据的同时停止保护。 跟踪本节前述的异步操作。
停止保护并删除备份数据
若要停止保护受保护的文件共享,并删除备份数据,请执行删除操作。
DELETE https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2019-05-13
参数 containerName 和 protectedItemName 在本文的“配置备份”步骤中已进行设置。
响应
删除保护是一种异步操作。 此操作会创建另一个需要单独跟踪的操作。 它将返回两个响应:创建另一个操作时为“202 (已接受)”,然后在该操作完成时为“204 (无内容)”。