通过

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

az sql db ltr-policy

管理 SQL 数据库长期保留策略。

命令

名称 说明 类型 Status
az sql db ltr-policy set

更新数据库的长期保留设置。

 Core GA
az sql db ltr-policy show

显示数据库的长期保留策略。

 Core GA

az sql db ltr-policy set

编辑

更新数据库的长期保留设置。

az sql db ltr-policy set [--ids]
                         [--make-backups-immutable --tb-immutability]
                         [--monthly-retention]
                         [--name]
                         [--resource-group]
                         [--server]
                         [--subscription]
                         [--tb-immutability-mode]
                         [--week-of-year]
                         [--weekly-retention]
                         [--yearly-retention]
                         [--yes]

示例

为数据库设置长期保留期。

az sql db ltr-policy set -g mygroup -s myserver -n mydb --weekly-retention "P1W" --monthly-retention "P6M" --yearly-retention "P1Y" --week-of-year 26 --make-backups-immutable Enabled

为启用了基于时间的不可变性和不可变性模式锁定的数据库设置长期保留。

az sql db ltr-policy set -g mygroup -s myserver -n mydb --weekly-retention "P0W" --monthly-retention "P0M" --yearly-retention "P0Y" --tb-immutability Enabled --tb-immutability-mode Locked

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--ids

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

属性 值
参数组: Resource Id Arguments
--make-backups-immutable --tb-immutability

是否在 LTR 备份上启用基于时间的不可变性。 可能的值为：“True”、“False”、“Enabled”、“Disabled”。

--monthly-retention

每月备份的保留期。 如果只传递数字而不是 ISO 8601 字符串，则天数将假定为单位。至少有 7 天，最多 10 年。

--name -n

Azure SQL 数据库的名称。

属性 值
参数组: Resource Id Arguments
--resource-group -g

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

属性 值
参数组: Resource Id Arguments
--server -s

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

属性 值
参数组: Resource Id Arguments
--subscription

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

属性 值
参数组: Resource Id Arguments
--tb-immutability-mode

在 LTR 备份上设置基于时间的不可变性模式。 可能的值为：“Locked”、“Unlocked”。 仅当启用 make-backups-immutable 时，这才有效。

--week-of-year

年份周，1 到 52，用于获取年度 LTR 备份。

--weekly-retention

每周备份的保留期。 如果只传递数字而不是 ISO 8601 字符串，则天数将假定为单位。至少有 7 天，最多 10 年。

--yearly-retention

每年备份的保留期。 如果只传递数字而不是 ISO 8601 字符串，则天数将假定为单位。至少有 7 天，最多 10 年。

--yes -y

不要提示确认。

全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

属性 值
默认值: False

az sql db ltr-policy show

编辑

显示数据库的长期保留策略。

az sql db ltr-policy show [--ids]
                          [--name]
                          [--resource-group]
                          [--server]
                          [--subscription]

示例

显示数据库的长期保留策略。

az sql db ltr-policy show -g mygroup -s myserver -n mydb

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--ids

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

属性 值
参数组: Resource Id Arguments
--name -n

Azure SQL 数据库的名称。

属性 值
参数组: Resource Id Arguments
--resource-group -g

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

属性 值
参数组: Resource Id Arguments
--server -s

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

属性 值
参数组: Resource Id Arguments
--subscription

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

属性 值
参数组: Resource Id Arguments
全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

属性 值
默认值: False