az sql mi-arc

Note

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

Azure Arc有効な SQL マネージド インスタンスを管理します。

コマンド

名前 説明 状態
az sql mi-arc config

構成コマンド。

Extension GA
az sql mi-arc config add

構成ファイルに json パスの値を追加します。

Extension GA
az sql mi-arc config init

SQL マネージド インスタンスの CRD ファイルと仕様ファイルを初期化します。

Extension GA
az sql mi-arc config patch

json パッチ ファイルに基づいて構成ファイルにパッチを適用します。

Extension GA
az sql mi-arc config remove

構成ファイル内の json パスの値を削除します。

Extension GA
az sql mi-arc config replace

構成ファイル内の json パスの値を置き換えます。

Extension GA
az sql mi-arc create

SQL マネージド インスタンスを作成します。

Extension GA
az sql mi-arc delete

SQL マネージド インスタンスを削除します。

Extension GA
az sql mi-arc endpoint

SQL エンドポイントを表示および管理します。

Extension GA
az sql mi-arc endpoint list

SQL エンドポイントを一覧表示します。

Extension GA
az sql mi-arc get-mirroring-cert

sql mi から可用性グループ ミラーリング エンドポイントの証明書を取得し、ファイルに格納します。

Extension GA
az sql mi-arc list

SQL マネージド インスタンスの一覧を表示します。

Extension GA
az sql mi-arc reprovision-replica

SQL マネージド インスタンス内のレプリカを再プロビジョニングします。

Extension GA
az sql mi-arc show

SQL マネージド インスタンスの詳細を表示します。

Extension GA
az sql mi-arc update

SQL マネージド インスタンスの構成を更新します。

Extension GA
az sql mi-arc upgrade

SQL マネージド インスタンスをアップグレードします。

Extension GA

az sql mi-arc create

SQL マネージド インスタンスを作成します。

SQL マネージド インスタンスのパスワードを設定するには、環境変数をAZDATA_PASSWORD設定します。

az sql mi-arc create --name
                     [--acquire-policy-token]
                     [--ad-account-name]
                     [--ad-connector-name]
                     [--ad-encryption-types]
                     [--admin-login-secret]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--change-reference]
                     [--collation]
                     [--cores-limit]
                     [--cores-request]
                     [--custom-location]
                     [--dev]
                     [--k8s-namespace]
                     [--keytab-secret]
                     [--labels]
                     [--language]
                     [--license-type]
                     [--memory-limit]
                     [--memory-request]
                     [--no-external-endpoint]
                     [--no-wait]
                     [--orchestrator-replicas]
                     [--path]
                     [--primary-dns-name]
                     [--primary-port-number]
                     [--private-key-file]
                     [--readable-secondaries]
                     [--replicas {1, 2, 3}]
                     [--resource-group]
                     [--retention-days]
                     [--secondary-dns-name]
                     [--secondary-port-number]
                     [--service-annotations]
                     [--service-cert-secret]
                     [--service-labels]
                     [--service-type {LoadBalancer, NodePort}]
                     [--storage-annotations]
                     [--storage-class-backups]
                     [--storage-class-data]
                     [--storage-class-datalogs]
                     [--storage-class-logs]
                     [--storage-class-orchestrator-logs]
                     [--storage-labels]
                     [--sync-secondary-to-commit {-1, 0, 1, 2}]
                     [--tde-mode]
                     [--tde-protector-private-key-file]
                     [--tde-protector-public-key-file]
                     [--tde-protector-secret]
                     [--tier]
                     [--time-zone]
                     [--trace-flags]
                     [--use-k8s]
                     [--volume-size-backups]
                     [--volume-size-data]
                     [--volume-size-datalogs]
                     [--volume-size-logs]
                     [--volume-size-orchestrator-logs]

Kubernetes API を使用して SQL マネージド インスタンスを作成します。

az sql mi-arc create -n sqlmi1 --k8s-namespace arc --use-k8s

Kubernetes API を使用して、HA シナリオで 3 つのレプリカを持つ SQL マネージド インスタンスを作成します。

az sql mi-arc create -n sqlmi2 --replicas 3 --k8s-namespace arc --use-k8s

Azure Resource Manager (ARM) を使用して SQL マネージド インスタンスを作成します。

az sql mi-arc create --name sqlmi3 --resource-group rg-name --custom-location arc-cl

Kubernetes API を使用して、Active Directory認証を使用して SQL マネージド インスタンスを作成します。

az sql mi-arc create --name contososqlmi --k8s-namespace arc --ad-connector-name arcadc --ad-account-name arcuser --keytab-secret arcuser-keytab-secret --primary-dns-name contososqlmi-primary.contoso.local --primary-port-number 8143 --use-k8s

必須のパラメーター

--name -n

SQL マネージド インスタンスの名前。

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

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

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--ad-account-name

この Arc 対応SQL Managed InstanceのActive Directory アカウント名。 このアカウントは、このインスタンスをデプロイする前に作成する必要があります。

--ad-connector-name

Active Directory コネクタの名前。 このパラメーターは、AD サポートを使用してデプロイする意図を示します。

--ad-encryption-types

サポートされているActive Directory暗号化の種類のコンマ区切りの一覧。 RC4、AES128、AES256 の値のサブセットである必要があります。

--admin-login-secret

ユーザー管理者ログイン アカウントの資格情報をホストまたはホストする、生成する Kubernetes シークレットの名前。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--agent-enabled

インスタンスSQL Serverエージェントを有効にします。 既定値は無効です。 使用できる値は 'true' または 'false' です。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--annotations

SQL マネージド インスタンスの注釈のコンマ区切りの一覧。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--cert-private-key-file

SQL Serverに使用する PEM 形式の証明書秘密キーを含むファイルへのパス。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--cert-public-key-file

SQL Serverに使用する PEM 形式の証明書公開キーを含むファイルへのパス。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
--collation

インスタンスのSQL Server照合順序。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--cores-limit -c

マネージド インスタンスのコア制限を整数として指定します。

--cores-request

マネージド インスタンスのコアに対する整数としての要求。

--custom-location

このインスタンスのカスタムの場所。

プロパティ
パラメーター グループ: Azure Resource Manager – targeted Arguments
--dev

これが指定されている場合は、開発インスタンスと見なされ、課金されません。

--k8s-namespace -k

SQL マネージド インスタンスをデプロイする名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--keytab-secret

この Arc 対応SQL Managed Instanceの keytab ファイルを含む Kubernetes シークレットの名前。

--labels

SQL マネージド インスタンスのラベルのコンマ区切りの一覧。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--language

インスタンスでサポートされている言語識別子 (LCID) に対するSQL Serverロケール。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--license-type -l

このマネージド インスタンスに適用するライセンスの種類の許容値は、BasePrice、LicenseIncluded、DisasterRecovery.Default は LicenseIncluded です。 ライセンスの種類を変更できます。.

--memory-limit -m

整数の後に Gi (ギガバイト) が続くマネージド インスタンスの容量の制限。 例: 4Gi。

--memory-request

整数の後に Gi (ギガバイト) が続くマネージド インスタンスの容量に対する要求。 例: 4Gi。

--no-external-endpoint

指定した場合、外部サービスは作成されません。 それ以外の場合は、データ コントローラーと同じサービスの種類を使用して外部サービスが作成されます。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ
規定値: False
--orchestrator-replicas

高可用性オーケストレーター レプリカの数。 値は 1 から 3 の間である必要があります。

--path

SQL マネージド インスタンスの json ファイルのazext_arcdata ファイルへのパス。

--primary-dns-name

この Arc 対応SQL Managed Instanceに接続するためにエンド ユーザーに公開されるプライマリ サービス DNS 名 (例: sqlinstancename.contoso.com)。

--primary-port-number

プライマリ サービスがエンド ユーザーに公開されるポート番号 (例: 31433)。

--private-key-file

インスタンス ID として使用するために openSSL によって生成された秘密キー ファイル。

--readable-secondaries

読み取り可能にするレプリカの数。 Business Critical レベルにのみ適用されます。 値は 0 からレプリカの数から 1 を引いた値にする必要があります。

--replicas

このオプションでは、高可用性のために Kubernetes クラスターにデプロイされるSQL Managed Instanceレプリカの数を指定します。 既定値は、General Purpose の場合は 1 つのレプリカ、Business Critical の場合は 3 つのレプリカです。

プロパティ
指定可能な値: 1, 2, 3
--resource-group -g

Arc 対応SQL Managed Instanceを追加する必要があるAzure リソース グループ。

プロパティ
パラメーター グループ: Azure Resource Manager – targeted Arguments
--retention-days

バックアップの保有期間 (日数で指定)。 使用できる値は 0 ~ 35 です。 既定値は 7 です。 保有期間を 0 に設定すると、SQL マネージド インスタンス上のすべてのデータベースの自動バックアップが無効になり、以前のバックアップはすべて削除されます。

--secondary-dns-name

この Arc 対応SQL Managed Instanceに接続するためにエンド ユーザーに公開されるセカンダリ サービス DNS 名 (例: sqlinstancename2.contoso.com)。

--secondary-port-number

セカンダリ サービスがエンド ユーザーに公開されるポート番号 (例: 31434)。

--service-annotations

すべての外部サービスに適用する注釈のコンマ区切りリスト。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--service-cert-secret

SQL サービス証明書をホストまたはホストする生成する Kubernetes シークレットの名前。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--service-labels

すべての外部サービスに適用するラベルのコンマ区切りリスト。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--service-type

プライマリ サービスの種類。

プロパティ
指定可能な値: LoadBalancer, NodePort
--storage-annotations

すべての PVC に適用する注釈のコンマ区切りの一覧。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--storage-class-backups

バックアップ (/var/opt/mssql/backups) に使用される ReadWriteMany (RWX) 対応のストレージ クラス。 値が指定されていない場合は、既定のストレージ クラスが使用されます。

--storage-class-data -d

データ ファイル (.mdf、.ndf) に使用するストレージ クラス。 値が指定されていない場合、ストレージ クラスは指定されません。これにより、Kubernetes で既定のストレージ クラスが使用されます。

--storage-class-datalogs

データベース ログ (.ldf) に使用するストレージ クラス。 値が指定されていない場合、ストレージ クラスは指定されません。これにより、Kubernetes で既定のストレージ クラスが使用されます。

--storage-class-logs

ログ (/var/log) に使用するストレージ クラス。 値が指定されていない場合、ストレージ クラスは指定されません。これにより、Kubernetes で既定のストレージ クラスが使用されます。

--storage-class-orchestrator-logs

オーケストレーター ログ (/var/log) に使用するストレージ クラス。 値が指定されていない場合、ストレージ クラスは指定されません。これにより、Kubernetes で既定のストレージ クラスが使用されます。

--storage-labels

すべての PVC に適用するラベルのコンマ区切りリスト。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--sync-secondary-to-commit

コミットするために同期する必要があるセカンダリ レプリカの数。 この値を -1 に設定すると、必要な同期されたセカンダリの数が切り捨てられた '(# of replicas - 1) / 2' に設定されます。

プロパティ
規定値: -1
指定可能な値: -1, 0, 1, 2
--tde-mode

この Arc 対応SQL Managed InstanceのTransparent Data Encryption (TDE) モード。 使用できる値: ServiceManaged、CustomerManaged、または Disabled。 既定値は [無効] です。

--tde-protector-private-key-file

TDE に使用する PEM 形式の証明書秘密キーを含むファイルへのパス。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--tde-protector-public-key-file

TDE に使用する PEM 形式の証明書公開キーを含むファイルへのパス。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--tde-protector-secret

この Arc 対応SQL Managed Instanceの TDE 保護機能証明書と秘密キーを含む Kubernetes シークレットの名前。 CustomerManaged TDE モードでのみ指定できます。

--tier -t

インスタンスの価格レベル。 使用できる値: BusinessCritical (bc for short) または GeneralPurpose (gp for short)。 既定値は GeneralPurpose です。

--time-zone

インスタンスのSQL Serverタイム ゾーン。

--trace-flags

トレースフラグのコンマ区切りリスト。 既定ではフラグはありません。

--use-k8s

ローカル Kubernetes API を使用して SQL マネージド インスタンスを作成します。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--volume-size-backups

バックアップに使用するストレージ ボリュームのサイズを正の数として指定し、その後に Ki (キロバイト)、Mi (メガバイト)、Gi (ギガバイト) を続けます。

--volume-size-data

データに使用するストレージ ボリュームのサイズを正の数にし、その後に Ki (キロバイト)、Mi (メガバイト)、Gi (ギガバイト) を続けます。

--volume-size-datalogs

データ ログに使用するストレージ ボリュームのサイズを正の数値として指定し、その後に Ki (キロバイト)、Mi (メガバイト)、Gi (ギガバイト) を続けます。

--volume-size-logs

ログに使用するストレージ ボリュームのサイズを正の数値として指定し、その後に Ki (キロバイト)、Mi (メガバイト)、Gi (ギガバイト) を続けます。

--volume-size-orchestrator-logs

オーケストレーター ログに使用するストレージ ボリュームのサイズを正の数として指定し、その後に Ki (キロバイト)、Mi (メガバイト)、Gi (ギガバイト) を続けます。

グローバル パラメーター
--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 mi-arc delete

SQL マネージド インスタンスを削除します。

az sql mi-arc delete --name
                     [--acquire-policy-token]
                     [--change-reference]
                     [--k8s-namespace]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]

Kubernetes API を使用して SQL マネージド インスタンスを削除します。

az sql mi-arc delete --name sqlmi1 --k8s-namespace arc --use-k8s

Azure Resource Manager (ARM) を使用して SQL マネージド インスタンスを削除します。

az sql mi-arc delete --name sqlmi1 --resource-group rg-name

必須のパラメーター

--name -n

削除する SQL マネージド インスタンスの名前。

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

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

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
--k8s-namespace -k

SQL マネージド インスタンスをデプロイする名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ
規定値: False
--resource-group -g

Arc 対応SQL Managed Instanceが存在する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 mi-arc get-mirroring-cert

sql mi から可用性グループ ミラーリング エンドポイントの証明書を取得し、ファイルに格納します。

az sql mi-arc get-mirroring-cert --cert-file
                                 --name
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--k8s-namespace]
                                 [--use-k8s]

sqlmi1 から可用性グループ ミラーリング エンドポイントの証明書を取得し、fileName1 に格納する

az sql mi-arc get-mirroring-cert -n sqlmi1 --cert-file fileName1

必須のパラメーター

--cert-file

取得した証明書を PEM 形式で格納するローカル ファイル名。

--name -n

SQL マネージド インスタンスの名前。

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

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

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
--k8s-namespace -k

SQL マネージド インスタンスをデプロイする名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。

プロパティ
パラメーター グループ: Kubernetes API – 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 mi-arc list

SQL マネージド インスタンスの一覧を表示します。

az sql mi-arc list [--custom-location]
                   [--k8s-namespace]
                   [--resource-group]
                   [--use-k8s]

SQL マネージド インスタンスの一覧を表示します。

az sql mi-arc list --use-k8s

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

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

--custom-location

Arc 対応 SQL Managed Instance がデプロイされるカスタムの場所。 指定しない場合は、リソース グループ内のすべてのインスタンスが一覧表示されます。

プロパティ
パラメーター グループ: Azure Resource Manager – targeted Arguments
--k8s-namespace -k

Arc 対応 SQL Managed Instance を含む Kubernetes 名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--resource-group -g

Arc 対応 SQL Managed Instance を含む 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 mi-arc reprovision-replica

SQL マネージド インスタンス内のレプリカを再プロビジョニングします。

az sql mi-arc reprovision-replica --name
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--k8s-namespace]
                                  [--no-wait]
                                  [--use-k8s]

例 1 - SQL マネージド インスタンス sqlmi1 のレプリカ 1 を再プロビジョニングします。

az sql mi-arc reprovision-replica -n sqlmi1-1 --use-k8s --k8s-namespace namespace

必須のパラメーター

--name -n

再プロビジョニングする SQL マネージド インスタンス レプリカの名前。

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

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

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
--k8s-namespace -k

SQL マネージド インスタンス レプリカがデプロイされている名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ
規定値: False
--use-k8s

ローカル Kubernetes API を使用して 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 mi-arc show

SQL マネージド インスタンスの詳細を表示します。

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

Kubernetes API を使用してSQL Managed Instanceの詳細を表示します。

az sql mi-arc show --name sqlmi1 --k8s-namespace arc --use-k8s

Azure Resource Manager (ARM) にクエリを実行して、SQL Managed Instanceの詳細を表示します。

az sql mi-arc show --name sqlmi1 --resource-group rg-name

必須のパラメーター

--name -n

表示する SQL マネージド インスタンスの名前。

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

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

--k8s-namespace -k

SQL マネージド インスタンスをデプロイする名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--path -p

SQL マネージド インスタンスの完全な仕様を記述する必要があるパス。 省略すると、標準出力に仕様が書き込まれます。

--resource-group -g

Arc 対応SQL Managed Instanceが存在する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 mi-arc update

SQL マネージド インスタンスの構成を更新します。

az sql mi-arc update --name
                     [--acquire-policy-token]
                     [--ad-encryption-types]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--change-reference]
                     [--cores-limit]
                     [--cores-request]
                     [--k8s-namespace]
                     [--keytab-secret]
                     [--labels]
                     [--license-type]
                     [--memory-limit]
                     [--memory-request]
                     [--no-wait]
                     [--orchestrator-replicas]
                     [--path]
                     [--preferred-primary-replica]
                     [--readable-secondaries]
                     [--replicas {1, 2, 3}]
                     [--resource-group]
                     [--retention-days]
                     [--service-annotations]
                     [--service-cert-secret]
                     [--service-labels]
                     [--sync-secondary-to-commit {-1, 0, 1, 2}]
                     [--tde-mode]
                     [--tde-protector-private-key-file]
                     [--tde-protector-public-key-file]
                     [--tde-protector-secret]
                     [--tier]
                     [--time-zone]
                     [--trace-flags]
                     [--use-k8s]

SQL マネージド インスタンスの構成を更新します。

az sql mi-arc update --path ./spec.json -n sqlmi1 --use-k8s

必須のパラメーター

--name -n

編集中の SQL マネージド インスタンスの名前。 インスタンスがデプロイされている名前は変更できません。

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

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

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--ad-encryption-types

サポートされているActive Directory暗号化の種類のコンマ区切りの一覧。 RC4、AES128、AES256 の値のサブセットである必要があります。

--agent-enabled

インスタンスSQL Serverエージェントを有効にします。 既定値は無効です。

--annotations

SQL マネージド インスタンスの注釈のコンマ区切りの一覧。

--cert-private-key-file

SQL Serverに使用する PEM 形式の証明書秘密キーを含むファイルへのパス。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--cert-public-key-file

SQL Serverに使用する PEM 形式の証明書公開キーを含むファイルへのパス。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
--cores-limit -c

マネージド インスタンスのコア制限を整数として指定します。

--cores-request

マネージド インスタンスのコアに対する整数としての要求。

--k8s-namespace -k

SQL マネージド インスタンスをデプロイする名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--keytab-secret

この Arc 対応SQL Managed Instanceの keytab ファイルを含む Kubernetes シークレットの名前。

--labels

SQL マネージド インスタンスのラベルのコンマ区切りの一覧。

--license-type -l

このマネージド インスタンスに適用するライセンスの種類の許容値は、BasePrice、LicenseIncluded、DisasterRecovery.Default は LicenseIncluded です。 ライセンスの種類を変更できます。.

--memory-limit -m

整数の後に Gi (ギガバイト) が続くマネージド インスタンスの容量の制限。 例: 4Gi。

--memory-request

整数の後に Gi (ギガバイト) が続くマネージド インスタンスの容量に対する要求。 例: 4Gi。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ
規定値: False
--orchestrator-replicas

高可用性オーケストレーター レプリカの数。 値は 1 から 3 の間である必要があります。

--path

SQL マネージド インスタンスの json ファイルのazext_arcdata ファイルへのパス。

--preferred-primary-replica

更新する優先プライマリ レプリカ。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--readable-secondaries

読み取り可能にするレプリカの数。 Business Critical レベルにのみ適用されます。 値は 0 からレプリカの数から 1 を引いた値にする必要があります。

--replicas

このオプションでは、高可用性のために Kubernetes クラスターにデプロイされるSQL Managed Instanceレプリカの数を指定します。

プロパティ
指定可能な値: 1, 2, 3
--resource-group -g

Arc 対応SQL Managed Instanceが存在するAzure リソース グループ。

プロパティ
パラメーター グループ: Azure Resource Manager – targeted Arguments
--retention-days

バックアップの保有期間 (日数で指定)。 使用できる値は 0 ~ 35 です。 既定値は 7 です。 保有期間を 0 に設定すると、SQL マネージド インスタンス上のすべてのデータベースの自動バックアップが無効になり、以前のバックアップはすべて削除されます。

--service-annotations

すべての外部サービスに適用する注釈のコンマ区切りリスト。

--service-cert-secret

SQL サービス証明書をホストまたはホストする生成する Kubernetes シークレットの名前。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--service-labels

すべての外部サービスに適用するラベルのコンマ区切りリスト。

--sync-secondary-to-commit

コミットするために同期する必要があるセカンダリ レプリカの数。 この値を -1 に設定すると、必要な同期されたセカンダリの数が切り捨てられた '(# of replicas - 1) / 2' に設定されます。

プロパティ
指定可能な値: -1, 0, 1, 2
--tde-mode

この Arc 対応SQL Managed InstanceのTransparent Data Encryption (TDE) モード。 使用できる値: ServiceManaged、CustomerManaged、または Disabled。 既定値は [無効] です。

--tde-protector-private-key-file

TDE に使用する PEM 形式の証明書秘密キーを含むファイルへのパス。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--tde-protector-public-key-file

TDE に使用する PEM 形式の証明書公開キーを含むファイルへのパス。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--tde-protector-secret

この Arc 対応SQL Managed Instanceの TDE 保護機能証明書と秘密キーを含む Kubernetes シークレットの名前。 CustomerManaged TDE モードでのみ指定できます。

--tier -t

インスタンスの価格レベル。 使用できる値: BusinessCritical (bc for short) または GeneralPurpose (gp for short)。 既定値は GeneralPurpose です。

--time-zone

インスタンスのSQL Serverタイム ゾーン。

--trace-flags

トレースフラグのコンマ区切りリスト。 既定ではフラグはありません。

--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 mi-arc upgrade

SQL マネージド インスタンスをアップグレードします。

SQL マネージド インスタンスを、指定された目的のバージョンにアップグレードします。 desired-version が指定されていない場合は、データ コントローラーのバージョンが使用されます。

az sql mi-arc upgrade [--acquire-policy-token]
                      [--change-reference]
                      [--desired-version]
                      [--dry-run]
                      [--field-filter]
                      [--force]
                      [--k8s-namespace]
                      [--label-filter]
                      [--name]
                      [--no-wait]
                      [--resource-group]
                      [--target]
                      [--use-k8s]

SQL マネージド インスタンスをアップグレードします。

az sql mi-arc upgrade -n sqlmi1 -k arc --desired-version v1.1.0 --use-k8s

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

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

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
--desired-version -v

アップグレードする最新の有効なバージョン。 オプション。バージョンが指定されていない場合は、データ コントローラーのバージョンが使用されます。 'auto' を指定して、最新の有効なバージョンに自動的にアップグレードします。 自動アップグレードの詳細については、「 https://aka.ms/arc-sqlmi-auto-upgrade」を参照してください。

--dry-run -d

アップグレードするインスタンスを示しますが、実際にはインスタンスをアップグレードしません。

--field-filter -f

リソースのプロパティに基づいてアップグレードするインスタンスを選択するフィルター。

--force

インスタンスに適用できるすべてのポリシーをオーバーライドし、アップグレードを試みます。

プロパティ
規定値: False
--k8s-namespace -k

SQL マネージド インスタンスをデプロイする名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。

プロパティ
パラメーター グループ: Kubernetes API – targeted Arguments
--label-filter -l

ラベルに基づいてアップグレードするインスタンスを選択するフィルター。

--name -n

SQL マネージド インスタンスの名前。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ
規定値: False
--resource-group -g

ターゲットの Arc 対応SQL Managed Instanceが存在するAzure リソース グループ。

プロパティ
パラメーター グループ: Azure Resource Manager – targeted Arguments
--target
非推奨

オプション '--target' は非推奨となり、今後のリリースで削除される予定です。 代わりに '--desired-version' を使用してください。

アップグレードする最新の有効なバージョン。 オプション。バージョンが指定されていない場合は、データ コントローラーのバージョンが使用されます。 'auto' を指定して、最新の有効なバージョンに自動的にアップグレードします。 自動アップグレードの詳細については、「 https://aka.ms/arc-sqlmi-auto-upgrade」を参照してください。

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