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

az sql instance-failover-group-arc

Note

此参考是 Azure CLI（版本 2.3.1 或更高版本）的 arcdata 扩展的一部分。该扩展会在首次运行 az sql instance-failover-group-arc 命令时自动安装。了解更多关于扩展的信息。

管理已启用 Arc 的 SQL 托管实例故障转移组。

命令

名称	说明	类型	Status
az sql instance-failover-group-arc create	创建故障转移组资源。	Extension	GA
az sql instance-failover-group-arc delete	删除已启用 Arc 的 SQL 托管实例故障转移组。	Extension	GA
az sql instance-failover-group-arc list	列出所有故障转移组。	Extension	GA
az sql instance-failover-group-arc show	显示故障转移组资源的详细信息。	Extension	GA
az sql instance-failover-group-arc update	更新故障转移组资源。	Extension	GA

az sql instance-failover-group-arc create

创建故障转移组资源。

创建已启用 Arc 的 SQL 托管实例故障转移组资源以设置分布式可用性组。

az sql instance-failover-group-arc create --mi
                                          --name
                                          --partner-mi
                                          [--k8s-namespace]
                                          [--no-wait]
                                          [--partner-mirroring-cert-file]
                                          [--partner-mirroring-url]
                                          [--partner-resource-group]
                                          [--partner-sync-mode {async, sync}]
                                          [--primary-mirroring-url]
                                          [--resource-group]
                                          [--role {primary, secondary}]
                                          [--shared-name]
                                          [--use-k8s]

示例

使用 Kubernetes API 在主 SQL 托管实例 sqlmi1 和合作伙伴 SQL 托管实例 sqlmi2 之间创建故障转移组资源。需要合作伙伴镜像终结点和证书文件。

az sql instance-failover-group-arc create --name fogcr --shared-name sharedname1 --mi sqlmi1 --role primary --partner-mi sqlmi2 --partner-mirroring-url 10.20.5.20:970 --partner-mirroring-cert-file ./sqlmi2.cer --use-k8s

使用 Azure 资源管理器（ARM）创建故障转移组资源。

az sql instance-failover-group-arc create --name fogcr  --mi sqlmi1 --resource-group primary-rg-name  --partner-mi sqlmi2 --partner-resource-group partner-rg-name --partner-sync-mode async

使用 ARM 创建具有自定义镜像 URL 的故障转移组。

az sql instance-failover-group-arc create --name fogcr  --mi sqlmi1 --resource-group primary-rg-name  --partner-mi sqlmi2 --partner-resource-group partner-rg-name --partner-sync-mode async --primary-mirroring-url 21.10.6.30:6603 --partner-mirroring-url 10.20.5.20:970

必需参数

--mi

主 SQL 托管实例的名称。

--name -n

故障转移组资源的名称。

--partner-mi

合作伙伴 SQL 托管实例或远程 SQL 实例的名称。使用 ARM 目标参数时，这指的是灾难恢复（DR）实例名称。

可选参数

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

--k8s-namespace -k

要在其中部署故障转移组的命名空间。若未指定命名空间，则将使用 kubeconfig 中定义的命名空间。

属性	值
参数组:	Kubernetes API – targeted Arguments

--no-wait

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

属性	值
默认值:	False

--partner-mirroring-cert-file -f

远程 SQL 实例上合作伙伴 SQL 托管实例或可用性组的镜像终结点公共证书的文件名。仅支持 PEM 格式。

属性	值
参数组:	Kubernetes API – targeted Arguments

--partner-mirroring-url -u

合作伙伴 SQL 托管实例的镜像终结点 URL。

--partner-resource-group

已启用 DR 合作伙伴 Arc 的 SQL 托管实例的 Azure 资源组。

属性	值
参数组:	Azure Resource Manager – targeted Arguments

--partner-sync-mode -m

已启用 Arc 的 SQL 托管实例的合作伙伴同步模式。

属性	值
接受的值:	async, sync

--primary-mirroring-url

主 SQL 托管实例的镜像终结点 URL。

属性	值
参数组:	Azure Resource Manager – targeted Arguments

--resource-group -g

已启用 Arc 的主 SQL 托管实例的 Azure 资源组。

属性	值
参数组:	Azure Resource Manager – targeted Arguments

--role

故障转移组的请求角色。可以更改角色。

属性	值
接受的值:	primary, secondary

--shared-name

此 SQL 托管实例的故障转移组的共享名称。主 SQL 托管实例及其合作伙伴都必须使用相同的共享名称。

属性	值
参数组:	Kubernetes API – targeted Arguments

--use-k8s

使用本地 Kubernetes API 创建已启用 Arc 的 SQL 托管实例故障转移组。

属性	值
参数组:	Kubernetes API – targeted Arguments

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

输出格式。

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

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

az sql instance-failover-group-arc delete

删除已启用 Arc 的 SQL 托管实例故障转移组。

az sql instance-failover-group-arc delete --name
                                          [--k8s-namespace]
                                          [--mi]
                                          [--resource-group]
                                          [--use-k8s]

示例

使用 Kubernetes API 删除故障转移组资源。

az sql instance-failover-group-arc delete --name fogcr --use-k8s

使用 Azure 资源管理器删除故障转移组资源。

az sql instance-failover-group-arc delete --name fogcr --mi sqlmi1 -g rg-name

必需参数

--name -n

要删除的故障转移组资源的名称。

可选参数

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

--k8s-namespace -k

部署故障转移组的命名空间。若未指定命名空间，则将使用 kubeconfig 中定义的命名空间。

属性	值
参数组:	Kubernetes API – targeted Arguments

--mi

已启用 Arc 的主 SQL 托管实例的名称。

属性	值
参数组:	Azure Resource Manager – targeted Arguments

--resource-group -g

已启用 Arc 的主 SQL 托管实例的 Azure 资源组。

属性	值
参数组:	Azure Resource Manager – targeted Arguments

--use-k8s

使用本地 Kubernetes API 来执行此操作。

属性	值
参数组:	Kubernetes API – targeted Arguments

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

输出格式。

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

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

az sql instance-failover-group-arc list

列出所有故障转移组。

az sql instance-failover-group-arc list [--k8s-namespace]
                                        [--mi]
                                        [--resource-group]
                                        [--use-k8s]

示例

使用 Kubernetes API 列出命名空间中的所有故障转移组。

az sql instance-failover-group-arc list --k8s-namespace arcdata --use-k8s

通过查询 Azure 资源管理器（ARM）列出所有故障转移组。

az sql instance-failover-group-arc list --mi sqlmi1 -g rg-name

可选参数

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

--k8s-namespace -k

部署故障转移组的命名空间。若未指定命名空间，则将使用 kubeconfig 中定义的命名空间。

属性	值
参数组:	Kubernetes API – targeted Arguments

--mi

已启用 Arc 的 SQL 托管实例的名称。

属性	值
参数组:	Azure Resource Manager – targeted Arguments

--resource-group -g

已启用 Arc 的 SQL 托管实例的 Azure 资源组。

属性	值
参数组:	Azure Resource Manager – targeted Arguments

--use-k8s

使用本地 Kubernetes API 来执行此操作。

属性	值
参数组:	Kubernetes API – targeted Arguments

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

输出格式。

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

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

az sql instance-failover-group-arc show

显示故障转移组资源的详细信息。

az sql instance-failover-group-arc show --name
                                        [--k8s-namespace]
                                        [--mi]
                                        [--resource-group]
                                        [--use-k8s]

示例

使用 Kubernetes API 显示故障转移组的详细信息。

az sql instance-failover-group-arc show --name fogcr --use-k8s

通过查询 Azure 资源管理器（ARM）显示故障转移组的详细信息。

az sql instance-failover-group-arc show --name fogcr1 --mi sqlmi1 -g rg-name

必需参数

--name -n

故障转移组资源的名称。

可选参数

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

--k8s-namespace -k

部署故障转移组的命名空间。若未指定命名空间，则将使用 kubeconfig 中定义的命名空间。

属性	值
参数组:	Kubernetes API – targeted Arguments

--mi

已启用 Arc 的主 SQL 托管实例的名称。

属性	值
参数组:	Azure Resource Manager – targeted Arguments

--resource-group -g

已启用 Arc 的主 SQL 托管实例的 Azure 资源组。

属性	值
参数组:	Azure Resource Manager – targeted Arguments

--use-k8s

使用本地 Kubernetes API 来执行此操作。

属性	值
参数组:	Kubernetes API – targeted Arguments

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

输出格式。

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

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

az sql instance-failover-group-arc update

更新故障转移组资源。

更新已启用 Arc 的 SQL 托管实例故障转移组资源以更改分布式可用性组的角色。

az sql instance-failover-group-arc update --name
                                          [--k8s-namespace]
                                          [--mi]
                                          [--no-wait]
                                          [--partner-sync-mode {async, sync}]
                                          [--resource-group]
                                          [--role {force-primary-allow-data-loss, force-secondary, secondary}]
                                          [--use-k8s]

示例

使用 Kubernetes API 将故障转移组资源从主角色更新到辅助角色。

az sql instance-failover-group-arc update --name fogcr --role secondary --use-k8s

使用 Azure 资源管理器更新故障转移组资源。

az sql instance-failover-group-arc update --name fogcr  --role secondary --mi sqlmi1 --resource-group rg-name

必需参数

--name -n

故障转移组资源的名称。

可选参数

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

--k8s-namespace -k

存在故障转移组的命名空间。若未指定命名空间，则将使用 kubeconfig 中定义的命名空间。

属性	值
参数组:	Kubernetes API – targeted Arguments

--mi

要更新的已启用 Arc 的 SQL 托管实例的名称。

属性	值
参数组:	Azure Resource Manager – targeted Arguments

--no-wait

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

属性	值
默认值:	False

--partner-sync-mode -m

SQL 托管实例的合作伙伴同步模式。

属性	值
接受的值:	async, sync

--resource-group -g

已启用 Arc 的主 SQL 托管实例的 Azure 资源组。

属性	值
参数组:	Azure Resource Manager – targeted Arguments

--role

故障转移组的请求角色。

属性	值
接受的值:	force-primary-allow-data-loss, force-secondary, secondary

--use-k8s

使用本地 Kubernetes API 来执行此操作。

属性	值
参数组:	Kubernetes API – targeted Arguments

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

输出格式。

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

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

反馈

此页面是否有帮助？