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

az sql instance-failover-group

管理 SQL 实例故障转移组。

命令

名称	说明	类型	状态
az sql instance-failover-group create	在两个连接的托管实例之间创建实例故障转移组。	核心	GA
az sql instance-failover-group delete	删除故障转移组。	核心	GA
az sql instance-failover-group set-primary	通过从当前主托管实例故障转移所有数据库来设置实例故障转移组的主数据库。	核心	GA
az sql instance-failover-group show	获取故障转移组。	核心	GA
az sql instance-failover-group update	汇报实例故障转移组。	核心	GA

az sql instance-failover-group create

在两个连接的托管实例之间创建实例故障转移组。

如果主服务器上发生中断，宽限期表示 Azure SQL 托管数据库在宽限期到期之前不会启动自动故障转移。 请注意，使用 --allow-data-loss 选项的故障转移操作可能会导致数据丢失，因为异步同步的性质。

az sql instance-failover-group create --mi
                                      --name
                                      --partner-mi
                                      --partner-resource-group
                                      --resource-group
                                      [--failover-policy {Automatic, Manual}]
                                      [--grace-period]
                                      [--secondary-type]

必需参数

--mi --source-mi

Azure SQL 托管实例的名称。

--name -n

实例故障转移组的名称。

--partner-mi

实例故障转移组的合作伙伴托管实例的名称。

--partner-resource-group

合作伙伴托管实例的资源组的名称。

--resource-group -g

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

可选参数

--failover-policy

实例故障转移组的故障转移策略。

接受的值: Automatic, Manual

默认值: Automatic

--grace-period

如果在主服务器上发生中断，则启动自动故障转移之前的时间间隔（以小时为单位）。 这表明Azure SQL 数据库在宽限期到期之前不会启动自动故障转移。 请注意，使用 --allow-data-loss 选项的故障转移操作可能会导致数据丢失，因为异步同步的性质。

默认值: 1

--secondary-type

故障转移组中辅助实例的预期用法。 备用状态表示辅助实例将用作仅灾难恢复的被动副本 (replica)。

默认值: Geo

全局参数

--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 instance-failover-group delete

删除故障转移组。

az sql instance-failover-group delete --location
                                      --name
                                      --resource-group

必需参数

--location -l

Location。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--name -n

实例故障转移组的名称。

--resource-group -g

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

全局参数

--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 instance-failover-group set-primary

通过从当前主托管实例故障转移所有数据库来设置实例故障转移组的主数据库。

az sql instance-failover-group set-primary --location
                                           --name
                                           --resource-group
                                           [--allow-data-loss]

必需参数

--location -l

实例故障转移组中辅助实例的位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--name -n

实例故障转移组的名称。

--resource-group -g

实例故障转移组中辅助实例的资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--allow-data-loss

完成故障转移，即使这样做可能会导致数据丢失。 这样，即使主数据库不可用，故障转移也会继续。

默认值: 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 instance-failover-group show

获取故障转移组。

az sql instance-failover-group show --location
                                    --name
                                    --resource-group

必需参数

--location -l

Location。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--name -n

实例故障转移组的名称。

--resource-group -g

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

全局参数

--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 instance-failover-group update

汇报实例故障转移组。

az sql instance-failover-group update --location
                                      --name
                                      --resource-group
                                      [--add]
                                      [--failover-policy {Automatic, Manual}]
                                      [--force-string]
                                      [--grace-period]
                                      [--remove]
                                      [--secondary-type]
                                      [--set]

必需参数

--location -l

Location。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--name -n

实例故障转移组的名称。

--resource-group -g

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

可选参数

--add

通过指定路径和键值对将对象添加到对象列表。 示例：--add property.listProperty <key=value, string or JSON string>。

默认值: []

--failover-policy

实例故障转移组的故障转移策略。

接受的值: Automatic, Manual

--force-string

使用“set”或“add”时，保留字符串文本，而不是尝试转换为 JSON。

默认值: False

--grace-period

如果在主服务器上发生中断，则启动自动故障转移之前的时间间隔（以小时为单位）。 这表明Azure SQL 数据库在宽限期到期之前不会启动自动故障转移。 请注意，使用 --allow-data-loss 选项的故障转移操作可能会导致数据丢失，因为异步同步的性质。

--remove

从列表中删除属性或元素。 示例： --remove property.list <indexToRemove> OR --remove propertyToRemove.

默认值: []

--secondary-type

故障转移组中辅助实例的预期用法。 备用状态表示辅助实例将用作仅灾难恢复的被动副本 (replica)。

--set

通过指定要设置的属性路径和值来更新对象。 示例：--set property1.property2=<value>。

默认值: []

全局参数

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