次の方法で共有

az sql instance-failover-group-arc

Note

このリファレンスは、Azure CLI (バージョン 2.3.1 以降) の arcdata 拡張機能の一部です。 拡張機能は、az sql instance-failover-group-arc コマンドを初めて実行すると自動的にインストールされます。 拡張機能の詳細については、 を参照してください。

Arc 対応 SQL マネージド インスタンスフェールオーバー グループを管理します。

コマンド

名前 説明 型 状態
az sql instance-failover-group-arc create

フェールオーバー グループ リソースを作成します。

 Extension GA
az sql instance-failover-group-arc delete

Arc 対応 SQL Managed Instance フェールオーバー グループを削除します。

 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 Managed Instance フェールオーバー グループ リソースを作成して、分散型可用性グループを設定します。

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) インスタンス名を指します。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--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 Managed Instance フェールオーバー グループを削除します。

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

削除するフェールオーバー グループ リソースの名前。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--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 Resource Manager (ARM) にクエリを実行して、すべてのフェールオーバー グループを一覧表示します。

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--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 Resource Manager (ARM) にクエリを実行して、フェールオーバー グループの詳細を表示します。

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

必須のパラメーター

--name -n

フェールオーバー グループ リソースの名前。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--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 Managed Instance フェールオーバー グループ リソースを更新して、分散型可用性グループのロールを変更します。

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

フェールオーバー グループ リソースの名前。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

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