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

az sql db ltr-backup

预览
参考

此命令组处于预览状态，正在开发中。参考和支持级别： https://aka.ms/CLI_refstatus

管理 SQL 数据库长期保留备份。

命令

名称	说明	类型	Status
az sql db ltr-backup delete	删除长期保留备份。	核心	预览
az sql db ltr-backup list	列出位置、服务器或数据库的长期保留备份。	核心	预览
az sql db ltr-backup restore	将长期保留备份还原到新数据库。	核心	预览
az sql db ltr-backup show	获取数据库的长期保留备份。	核心	预览
az sql db ltr-backup wait	将 CLI 置于等待状态，直到满足数据库条件。	核心	预览版

az sql db ltr-backup delete

编辑

预览

命令组“sql db ltr-backup”处于预览状态，正在开发中。参考和支持级别： https://aka.ms/CLI_refstatus

删除长期保留备份。

az sql db ltr-backup delete --database
                            --location
                            --name
                            --server
                            [--yes]

示例

删除数据库的长期保留备份。

az sql db ltr-backup delete -l southeastasia -s myserver -d mydb -n "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000"

必需参数

--database -d

Azure SQL 数据库的名称。如果指定（以及服务器名称），则检索此数据库下的所有请求备份。

--location -l

所需备份的位置。

--name -n

LTR 备份的名称。将“az sql db ltr-backup show”或“az sql db ltr-backup list”用于备份名称。

--server -s

Azure SQL Server 的名称。如果指定，则检索此服务器下的所有请求备份。

可选参数

--yes -y

不提示确认。

默认值: False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

az sql db ltr-backup list

编辑

预览

命令组“sql db ltr-backup”处于预览状态，正在开发中。参考和支持级别： https://aka.ms/CLI_refstatus

列出位置、服务器或数据库的长期保留备份。

az sql db ltr-backup list --location
                          [--database]
                          [--database-state]
                          [--latest]
                          [--resource-group]
                          [--server]

示例

列出数据库的长期保留备份。

az sql db ltr-backup list -l southeastasia -s myserver -d mydb

列出服务器的长期保留备份（仅列出属于实时数据库的最新 LTR 备份）。

az sql db ltr-backup list -l southeastasia -s myserver --database-state Live --only-latest-per-database True

列出服务器的长期保留备份（具有资源组参数）。

az sql db ltr-backup list -l southeastasia -g mygroup -s myserver

列出位置的长期保留备份（仅列出属于实时数据库的最新 LTR 备份）。

az sql db ltr-backup list -l southeastasia --database-state Live --only-latest-per-database True

列出位置的长期保留备份（具有资源组参数）。

az sql db ltr-backup list -l southeastasia -g mygroup

必需参数

--location -l

所需备份的位置。

可选参数

--database -d

Azure SQL 数据库的名称。如果指定（以及服务器名称），则检索此数据库下的所有请求备份。

--database-state --state

“All”、“Live”或“Deleted”。仅从处于指定状态的数据库提取备份。如果没有状态支持，则默认为“全部”。

--latest --only-latest-per-database

如果为 true，则仅返回每个数据库的最新备份。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name> 配置默认组。

--server -s

Azure SQL Server 的名称。如果指定，则检索此服务器下的所有请求备份。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

az sql db ltr-backup restore

编辑

预览

命令组“sql db ltr-backup”处于预览状态，正在开发中。参考和支持级别： https://aka.ms/CLI_refstatus

将长期保留备份还原到新数据库。

az sql db ltr-backup restore --backup-id
                             --dest-database
                             --dest-resource-group
                             --dest-server
                             [--assign-identity {false, true}]
                             [--auto-pause-delay]
                             [--availability-zone]
                             [--backup-storage-redundancy]
                             [--capacity]
                             [--compute-model {Provisioned, Serverless}]
                             [--edition]
                             [--elastic-pool]
                             [--encryption-protector]
                             [--encryption-protector-auto-rotation {false, true}]
                             [--family]
                             [--federated-client-id]
                             [--ha-replicas]
                             [--keys]
                             [--license-type {BasePrice, LicenseIncluded}]
                             [--min-capacity]
                             [--no-wait]
                             [--preferred-enclave-type {Default, VBS}]
                             [--read-scale {Disabled, Enabled}]
                             [--service-level-objective]
                             [--tags]
                             [--umi]
                             [--zone-redundant {false, true}]

示例

还原 LTR 备份。

az sql db ltr-backup restore \
--dest-database targetdb --dest-server myserver --dest-resource-group mygroup \
--backup-id "/subscriptions/6caa113c-794c-42f8-ab9d-878d8aa104dc/resourceGroups/mygroup/providers/Microsoft.Sql/locations/southeastasia/longTermRetentionServers/myserver/longTermRetentionDatabases/sourcedb/longTermRetentionBackups/3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000"

必需参数

--backup-id

要还原的长期保留备份的资源 ID。将“az sql db ltr-backup show”或“az sql db ltr-backup list”用于备份 ID。

--dest-database

将创建为还原目标的数据库的名称。

--dest-resource-group

要还原数据库的服务器资源组的名称。

--dest-server

要还原数据库的服务器的名称。

可选参数

--assign-identity -i

为数据库分配标识。

接受的值: false, true

--auto-pause-delay

数据库自动暂停的时间（以分钟为单位）。值为 -1 表示禁用自动暂停。

--availability-zone

可用性区域。

--backup-storage-redundancy --bsr

用于存储备份的备份存储冗余。允许的值包括：Local、Zone、Geo、GeoZone。

--capacity -c

SKU 的容量组件（整数数为 DTU 或 vcore）。

--compute-model

数据库的计算模型。

接受的值: Provisioned, Serverless

--edition --tier -e

SKU 的版本组件。允许的值包括：基本、标准、高级版、GeneralPurpose、BusinessCritical、超大规模。

--elastic-pool

要在其中创建数据库的弹性池的名称或资源 ID。

--encryption-protector

指定要用作数据库加密保护程序密钥的 Azure 密钥保管库密钥。

--encryption-protector-auto-rotation --epauto

指定数据库加密保护程序密钥自动轮换标志。可以是 true、false 或 null。

接受的值: false, true

--family -f

SKU 的计算生成组件（仅适用于 vcore SKU）。允许的值包括：Gen4、Gen5。

--federated-client-id

SQL 数据库的联合客户端 ID。它用于跨租户 CMK 方案。

--ha-replicas --read-replicas

要为数据库预配的高可用性副本 (replica)数。仅适用于超大规模版本。

--keys

SQL 数据库的 AKV 键列表。

--license-type

要申请此数据库的许可证类型。LicenseIncluded 如果需要许可证，或者 BasePrice拥有许可证并且有资格使用 Azure HybridBenefit。

接受的值: BasePrice, LicenseIncluded

--min-capacity

数据库始终分配的最小容量（如果未暂停）。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--preferred-enclave-type

指定此资源的 enclave 类型。

接受的值: Default, VBS

--read-scale

如果启用，将应用程序意向设置为只读的连接连接字符串可能会路由到只读辅助副本 (replica)。此属性仅适用于高级版和业务关键数据库。

接受的值: Disabled, Enabled

--service-level-objective --service-objective

新数据库的服务目标。例如：基本、S0、P1、GP_Gen4_1、GP_S_Gen5_8、BC_Gen5_2、HS_Gen5_32。

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--umi --user-assigned-identity-id

SQL 数据库的用户分配标识列表。

--zone-redundant -z

指定是否启用区域冗余。如果未指定任何值，则默认值为 true。

接受的值: false, true

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

az sql db ltr-backup show

编辑

预览

命令组“sql db ltr-backup”处于预览状态，正在开发中。参考和支持级别： https://aka.ms/CLI_refstatus

获取数据库的长期保留备份。

az sql db ltr-backup show --database
                          --location
                          --name
                          --server

示例

显示数据库的长期保留备份。

az sql db ltr-backup show -l southeastasia -s myserver -d mydb -n "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000;Hot"

必需参数

--database -d

Azure SQL 数据库的名称。如果指定（以及服务器名称），则检索此数据库下的所有请求备份。

--location -l

所需备份的位置。

--name -n

LTR 备份的名称。将“az sql db ltr-backup show”或“az sql db ltr-backup list”用于备份名称。

--server -s

Azure SQL Server 的名称。如果指定，则检索此服务器下的所有请求备份。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

az sql db ltr-backup wait

编辑

预览

命令组“sql db ltr-backup”处于预览状态，正在开发中。参考和支持级别： https://aka.ms/CLI_refstatus

将 CLI 置于等待状态，直到满足数据库条件。

az sql db ltr-backup wait [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--expand]
                          [--filter]
                          [--ids]
                          [--interval]
                          [--name]
                          [--resource-group]
                          [--server]
                          [--subscription]
                          [--timeout]
                          [--updated]

可选参数

--created

等待在“Succeeded”中使用“provisioningState”创建。

默认值: False

--custom

等待条件满足自定义 JMESPath 查询。例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到删除为止。

默认值: False

--exists

等待资源存在。

默认值: False

--expand

要包含在响应中的子资源。默认值为 None。

--filter

一个 OData 筛选器表达式，用于筛选集合中的元素。默认值为 None。

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“资源 ID”参数的所有信息的完整资源 ID。应提供 --id 或其他“资源 ID”参数。

--interval

轮询间隔（以秒为单位）。

默认值: 30

--name -n

Azure SQL 数据库的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name> 配置默认组。

--server -s

Azure SQL Server 的名称。可以使用 < a0/a0> 配置默认值 az configure --defaults sql-server=<name>。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--timeout

最大等待（以秒为单位）。

默认值: 3600

--updated

等到 provisioningState 更新为“Succeeded”。

默认值: False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

通过

az sql db ltr-backup

命令

az sql db ltr-backup delete

示例

必需参数

可选参数

az sql db ltr-backup list

示例

必需参数

可选参数

az sql db ltr-backup restore

示例

必需参数

可选参数

az sql db ltr-backup show

示例

必需参数

az sql db ltr-backup wait

可选参数

其他资源