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

az sql db replica

管理数据库之间的副本 (replica)。

命令

名称 说明 类型 Status
az sql db replica create

将数据库创建为现有数据库的可读辅助副本 (replica)。

核心 GA
az sql db replica delete-link

永久停止两个数据库副本 (replica)之间的数据副本 (replica)。

核心 GA
az sql db replica list-links

列出数据库的副本 (replica)及其副本 (replica)状态。

核心 GA
az sql db replica set-primary

通过从当前主副本 (replica)数据库进行故障转移来设置主副本 (replica)数据库。

核心 GA

az sql db replica create

将数据库创建为现有数据库的可读辅助副本 (replica)。

可以通过执行 az sql db list-editions -a -o table -l LOCATION来查看性能级别选项的完整列表。 辅助数据库必须具有与主数据库相同的版本。

az sql db replica create --name
                         --partner-server
                         --resource-group
                         --server
                         [--assign-identity {false, true}]
                         [--auto-pause-delay]
                         [--availability-zone]
                         [--backup-storage-redundancy]
                         [--capacity]
                         [--compute-model {Provisioned, Serverless}]
                         [--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]
                         [--partner-database]
                         [--partner-resource-group]
                         [--preferred-enclave-type {Default, VBS}]
                         [--read-scale {Disabled, Enabled}]
                         [--secondary-type]
                         [--service-level-objective]
                         [--tags]
                         [--umi]
                         [--zone-redundant {false, true}]

示例

创建性能级别为 S0 的数据库作为现有标准数据库的辅助副本 (replica)。

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --service-objective S0

使用 GeneralPurpose 版本、Gen4 硬件和 1 个 vcore 创建数据库作为现有 GeneralPurpose 数据库的辅助副本 (replica)

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb -f Gen4 -c 1

使用区域冗余备份存储作为现有数据库的辅助副本 (replica)创建数据库。

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --backup-storage-redundancy Zone

必需参数

--name -n

Azure SQL 数据库的名称。

--partner-server

要在其中创建新副本 (replica)的服务器的名称。

--resource-group -g

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

--server -s

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

可选参数

--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
--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
--partner-database

新副本 (replica)的名称。 如果未指定,则默认为源数据库名称。

--partner-resource-group

要在其中创建新副本 (replica)的资源组的名称。 如果未指定,则默认为源资源组。

--preferred-enclave-type

指定此资源的 enclave 类型。

接受的值: Default, VBS
--read-scale

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

接受的值: Disabled, Enabled
--secondary-type

要创建的辅助副本的类型。 允许的值包括:Geo、Named。

--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 获取完整的调试日志。

永久停止两个数据库副本 (replica)之间的数据副本 (replica)。

az sql db replica delete-link --partner-server
                              [--ids]
                              [--name]
                              [--partner-resource-group]
                              [--resource-group]
                              [--server]
                              [--subscription]
                              [--yes]
--partner-server

另一个副本 (replica)服务器的名称。

--ids

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

--name -n

Azure SQL 数据库的名称。

--partner-resource-group

另一个副本 (replica)位于的资源组的名称。 如果未指定,则默认为第一个数据库的资源组。

--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 配置默认订阅。

--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 获取完整的调试日志。

列出数据库的副本 (replica)及其副本 (replica)状态。

az sql db replica list-links [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

列出数据库的副本 (replica)及其副本 (replica)状态。 (自动生成)

az sql db replica list-links --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver
--ids

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

--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 配置默认订阅。

全局参数
--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 replica set-primary

通过从当前主副本 (replica)数据库进行故障转移来设置主副本 (replica)数据库。

az sql db replica set-primary [--allow-data-loss]
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--server]
                              [--subscription]

示例

通过从当前主副本 (replica)数据库进行故障转移来设置主副本 (replica)数据库。 (自动生成)

az sql db replica set-primary --allow-data-loss --name MyDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription

可选参数

--allow-data-loss

如果指定,故障转移操作将允许数据丢失。

默认值: False
--ids

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

--name -n

要故障转移的数据库的名称。

--resource-group -g

包含将成为新主节点的辅助副本 (replica)的资源组的名称。

--server -s

包含将成为新主节点的辅助副本 (replica)的服务器的名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults sql-server=<name>

--subscription

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

全局参数
--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 获取完整的调试日志。