az sql instance-failover-group-arc

Note

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

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

命令

名稱	Description	類型	狀態
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 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 中定義的命名空間。

屬性	值
參數群組:	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

訂用帳戶的名稱或標識碼。您可以使用 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 Resource Manager 刪除故障轉移群組資源。

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

訂用帳戶的名稱或標識碼。您可以使用 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 Resource Manager 來列出所有故障轉移群組（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

訂用帳戶的名稱或標識碼。您可以使用 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 Resource Manager （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

訂用帳戶的名稱或標識碼。您可以使用 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 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 中定義的命名空間。

屬性	值
參數群組:	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

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

意見反應

此頁面對您有幫助嗎？

共用方式為

az sql instance-failover-group-arc

命令

az sql instance-failover-group-arc create

範例

必要參數

選擇性參數

az sql instance-failover-group-arc delete

範例

必要參數

選擇性參數

az sql instance-failover-group-arc list

範例

選擇性參數

az sql instance-failover-group-arc show

範例

必要參數

選擇性參數

az sql instance-failover-group-arc update

範例

必要參數

選擇性參數

意見反應