Share via

az sql instance-failover-group-arc

  • 參考

注意

此參考是 Azure CLI 的 arcdata 延伸模組的一部分 （2.3.1 版或更高版本）。 擴充功能會在您第一次執行 az sql instance-failover-group-arc 命令時自動安裝。 深入了解擴充功能。

管理已啟用 Arc 的 SQL 受控實例容錯移轉群組。

命令

名稱 Description 類型 狀態
az sql instance-failover-group-arc create

建立容錯移轉群組資源。

 擴充 GA
az sql instance-failover-group-arc delete

刪除已啟用 Arc SQL 受管理執行個體容錯移轉群組。

 擴充 GA
az sql instance-failover-group-arc list

列出所有容錯移轉群組。

 擴充 GA
az sql instance-failover-group-arc show

顯示容錯移轉群組資源的詳細資料。

 擴充 GA
az sql instance-failover-group-arc update

更新容錯移轉群組資源。

 擴充 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 Resource Manager （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 中定義的命名空間。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--partner-mirroring-cert-file -f

遠端 SQL 實例上夥伴 SQL 受控實例或可用性群組的鏡像端點公用憑證檔案名。 僅支援 PEM 格式。

--partner-mirroring-url -u

夥伴 SQL 受控實例的鏡像端點 URL。

--partner-resource-group

已啟用 DR 合作夥伴 Arc 的 SQL 受控實例的 Azure 資源群組。

--partner-sync-mode -m

已啟用 Arc 之 SQL 受控實例的夥伴同步處理模式。

接受的值: async, sync
--primary-mirroring-url

主要 SQL 受控實例的鏡像端點 URL。

--resource-group -g

已啟用 Arc 之主要 SQL 受控實例的 Azure 資源群組。

--role

容錯移轉群組的要求角色。 角色可以變更。

接受的值: primary, secondary
--shared-name

這個 SQL 受控實例之容錯移轉群組的共用名稱稱。 主要 SQL 受控實例及其夥伴都必須使用相同的共用名稱稱。

--use-k8s

使用本機 Kubernetes API 建立已啟用 Arc 的 SQL 受控實例容錯移轉群組。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

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 Resource Manager 刪除容錯移轉群組資源。

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

必要參數

--name -n

要刪除的容錯移轉群組資源名稱。

選擇性參數

--k8s-namespace -k

部署容錯移轉群組的命名空間。 如果未指定任何命名空間，則會使用 kubeconfig 中定義的命名空間。

--mi

已啟用 Arc 的主要 SQL 受控實例名稱。

--resource-group -g

已啟用 Arc 之主要 SQL 受控實例的 Azure 資源群組。

--use-k8s

使用本機 Kubernetes API 來執行此動作。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

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 Resource Manager 來列出所有容錯移轉群組（ARM）。

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

選擇性參數

--k8s-namespace -k

部署容錯移轉群組的命名空間。 如果未指定任何命名空間，則會使用 kubeconfig 中定義的命名空間。

--mi

已啟用 Arc 的 SQL 受控實例名稱。

--resource-group -g

已啟用 Arc 之 SQL 受控實例的 Azure 資源群組。

--use-k8s

使用本機 Kubernetes API 來執行此動作。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

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 Resource Manager （ARM） 來顯示容錯移轉群組的詳細資料。

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

必要參數

--name -n

容錯移轉群組資源的名稱。

選擇性參數

--k8s-namespace -k

部署容錯移轉群組的命名空間。 如果未指定任何命名空間，則會使用 kubeconfig 中定義的命名空間。

--mi

已啟用 Arc 的主要 SQL 受控實例名稱。

--resource-group -g

已啟用 Arc 之主要 SQL 受控實例的 Azure 資源群組。

--use-k8s

使用本機 Kubernetes API 來執行此動作。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

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 Resource Manager 更新容錯移轉群組資源。

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

必要參數

--name -n

容錯移轉群組資源的名稱。

選擇性參數

--k8s-namespace -k

容錯移轉群組所在的命名空間。 如果未指定任何命名空間，則會使用 kubeconfig 中定義的命名空間。

--mi

要更新的已啟用 Arc 的 SQL 受控實例名稱。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--partner-sync-mode -m

SQL 受控實例的夥伴同步處理模式。

接受的值: async, sync
--resource-group -g

已啟用 Arc 之主要 SQL 受控實例的 Azure 資源群組。

--role

容錯移轉群組的要求角色。

接受的值: force-primary-allow-data-loss, force-secondary, secondary
--use-k8s

使用本機 Kubernetes API 來執行此動作。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。