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
必須のパラメーター
SQL マネージド インスタンスの名前。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
この Arc 対応SQL Managed InstanceのActive Directory アカウント名。 このアカウントは、このインスタンスをデプロイする前に作成する必要があります。
Active Directory コネクタの名前。 このパラメーターは、AD サポートを使用してデプロイする意図を示します。
サポートされているActive Directory暗号化の種類のコンマ区切りの一覧。 RC4、AES128、AES256 の値のサブセットである必要があります。
ユーザー管理者ログイン アカウントの資格情報をホストまたはホストする、生成する Kubernetes シークレットの名前。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
インスタンスSQL Serverエージェントを有効にします。 既定値は無効です。 使用できる値は 'true' または 'false' です。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
SQL マネージド インスタンスの注釈のコンマ区切りの一覧。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
SQL Serverに使用する PEM 形式の証明書秘密キーを含むファイルへのパス。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
SQL Serverに使用する PEM 形式の証明書公開キーを含むファイルへのパス。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
インスタンスのSQL Server照合順序。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
マネージド インスタンスのコア制限を整数として指定します。
マネージド インスタンスのコアに対する整数としての要求。
このインスタンスのカスタムの場所。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Azure Resource Manager – targeted Arguments |
これが指定されている場合は、開発インスタンスと見なされ、課金されません。
SQL マネージド インスタンスをデプロイする名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
この Arc 対応SQL Managed Instanceの keytab ファイルを含む Kubernetes シークレットの名前。
SQL マネージド インスタンスのラベルのコンマ区切りの一覧。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
インスタンスでサポートされている言語識別子 (LCID) に対するSQL Serverロケール。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
このマネージド インスタンスに適用するライセンスの種類の許容値は、BasePrice、LicenseIncluded、DisasterRecovery.Default は LicenseIncluded です。 ライセンスの種類を変更できます。.
整数の後に Gi (ギガバイト) が続くマネージド インスタンスの容量の制限。 例: 4Gi。
整数の後に Gi (ギガバイト) が続くマネージド インスタンスの容量に対する要求。 例: 4Gi。
指定した場合、外部サービスは作成されません。 それ以外の場合は、データ コントローラーと同じサービスの種類を使用して外部サービスが作成されます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
実行時間の長い操作が完了するまで待つ必要はありません。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
高可用性オーケストレーター レプリカの数。 値は 1 から 3 の間である必要があります。
SQL マネージド インスタンスの json ファイルのazext_arcdata ファイルへのパス。
この Arc 対応SQL Managed Instanceに接続するためにエンド ユーザーに公開されるプライマリ サービス DNS 名 (例: sqlinstancename.contoso.com)。
プライマリ サービスがエンド ユーザーに公開されるポート番号 (例: 31433)。
インスタンス ID として使用するために openSSL によって生成された秘密キー ファイル。
読み取り可能にするレプリカの数。 Business Critical レベルにのみ適用されます。 値は 0 からレプリカの数から 1 を引いた値にする必要があります。
このオプションでは、高可用性のために Kubernetes クラスターにデプロイされるSQL Managed Instanceレプリカの数を指定します。 既定値は、General Purpose の場合は 1 つのレプリカ、Business Critical の場合は 3 つのレプリカです。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | 1, 2, 3 |
Arc 対応SQL Managed Instanceを追加する必要があるAzure リソース グループ。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Azure Resource Manager – targeted Arguments |
バックアップの保有期間 (日数で指定)。 使用できる値は 0 ~ 35 です。 既定値は 7 です。 保有期間を 0 に設定すると、SQL マネージド インスタンス上のすべてのデータベースの自動バックアップが無効になり、以前のバックアップはすべて削除されます。
この Arc 対応SQL Managed Instanceに接続するためにエンド ユーザーに公開されるセカンダリ サービス DNS 名 (例: sqlinstancename2.contoso.com)。
セカンダリ サービスがエンド ユーザーに公開されるポート番号 (例: 31434)。
すべての外部サービスに適用する注釈のコンマ区切りリスト。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
SQL サービス証明書をホストまたはホストする生成する Kubernetes シークレットの名前。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
すべての外部サービスに適用するラベルのコンマ区切りリスト。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
プライマリ サービスの種類。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | LoadBalancer, NodePort |
すべての PVC に適用する注釈のコンマ区切りの一覧。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
バックアップ (/var/opt/mssql/backups) に使用される ReadWriteMany (RWX) 対応のストレージ クラス。 値が指定されていない場合は、既定のストレージ クラスが使用されます。
データ ファイル (.mdf、.ndf) に使用するストレージ クラス。 値が指定されていない場合、ストレージ クラスは指定されません。これにより、Kubernetes で既定のストレージ クラスが使用されます。
データベース ログ (.ldf) に使用するストレージ クラス。 値が指定されていない場合、ストレージ クラスは指定されません。これにより、Kubernetes で既定のストレージ クラスが使用されます。
ログ (/var/log) に使用するストレージ クラス。 値が指定されていない場合、ストレージ クラスは指定されません。これにより、Kubernetes で既定のストレージ クラスが使用されます。
オーケストレーター ログ (/var/log) に使用するストレージ クラス。 値が指定されていない場合、ストレージ クラスは指定されません。これにより、Kubernetes で既定のストレージ クラスが使用されます。
すべての PVC に適用するラベルのコンマ区切りリスト。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
コミットするために同期する必要があるセカンダリ レプリカの数。 この値を -1 に設定すると、必要な同期されたセカンダリの数が切り捨てられた '(# of replicas - 1) / 2' に設定されます。
| プロパティ | 値 |
|---|---|
| 規定値: | -1 |
| 指定可能な値: | -1, 0, 1, 2 |
この Arc 対応SQL Managed InstanceのTransparent Data Encryption (TDE) モード。 使用できる値: ServiceManaged、CustomerManaged、または Disabled。 既定値は [無効] です。
TDE に使用する PEM 形式の証明書秘密キーを含むファイルへのパス。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
TDE に使用する PEM 形式の証明書公開キーを含むファイルへのパス。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
この Arc 対応SQL Managed Instanceの TDE 保護機能証明書と秘密キーを含む Kubernetes シークレットの名前。 CustomerManaged TDE モードでのみ指定できます。
インスタンスの価格レベル。 使用できる値: BusinessCritical (bc for short) または GeneralPurpose (gp for short)。 既定値は GeneralPurpose です。
インスタンスのSQL Serverタイム ゾーン。
トレースフラグのコンマ区切りリスト。 既定ではフラグはありません。
ローカル Kubernetes API を使用して SQL マネージド インスタンスを作成します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
バックアップに使用するストレージ ボリュームのサイズを正の数として指定し、その後に Ki (キロバイト)、Mi (メガバイト)、Gi (ギガバイト) を続けます。
データに使用するストレージ ボリュームのサイズを正の数にし、その後に Ki (キロバイト)、Mi (メガバイト)、Gi (ギガバイト) を続けます。
データ ログに使用するストレージ ボリュームのサイズを正の数値として指定し、その後に Ki (キロバイト)、Mi (メガバイト)、Gi (ギガバイト) を続けます。
ログに使用するストレージ ボリュームのサイズを正の数値として指定し、その後に Ki (キロバイト)、Mi (メガバイト)、Gi (ギガバイト) を続けます。
オーケストレーター ログに使用するストレージ ボリュームのサイズを正の数として指定し、その後に Ki (キロバイト)、Mi (メガバイト)、Gi (ギガバイト) を続けます。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --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
必須のパラメーター
削除する SQL マネージド インスタンスの名前。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
SQL マネージド インスタンスをデプロイする名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
実行時間の長い操作が完了するまで待つ必要はありません。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
Arc 対応SQL Managed Instanceが存在するAzure リソース グループ。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Azure Resource Manager – targeted Arguments |
このアクションを実行するには、ローカル Kubernetes API を使用します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --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
必須のパラメーター
取得した証明書を PEM 形式で格納するローカル ファイル名。
SQL マネージド インスタンスの名前。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
SQL マネージド インスタンスをデプロイする名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
このアクションを実行するには、ローカル Kubernetes API を使用します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --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 つ以上が必要になる場合があります。
Arc 対応 SQL Managed Instance がデプロイされるカスタムの場所。 指定しない場合は、リソース グループ内のすべてのインスタンスが一覧表示されます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Azure Resource Manager – targeted Arguments |
Arc 対応 SQL Managed Instance を含む Kubernetes 名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
Arc 対応 SQL Managed Instance を含む Azure リソース グループ。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Azure Resource Manager – targeted Arguments |
このアクションを実行するには、ローカル Kubernetes API を使用します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --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
必須のパラメーター
再プロビジョニングする SQL マネージド インスタンス レプリカの名前。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
SQL マネージド インスタンス レプリカがデプロイされている名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
実行時間の長い操作が完了するまで待つ必要はありません。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
ローカル Kubernetes API を使用して SQL マネージド インスタンス レプリカを再プロビジョニングします。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --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
必須のパラメーター
表示する SQL マネージド インスタンスの名前。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
SQL マネージド インスタンスをデプロイする名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
SQL マネージド インスタンスの完全な仕様を記述する必要があるパス。 省略すると、標準出力に仕様が書き込まれます。
Arc 対応SQL Managed Instanceが存在するAzure リソース グループ。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Azure Resource Manager – targeted Arguments |
このアクションを実行するには、ローカル Kubernetes API を使用します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --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
必須のパラメーター
編集中の SQL マネージド インスタンスの名前。 インスタンスがデプロイされている名前は変更できません。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
サポートされているActive Directory暗号化の種類のコンマ区切りの一覧。 RC4、AES128、AES256 の値のサブセットである必要があります。
インスタンスSQL Serverエージェントを有効にします。 既定値は無効です。
SQL マネージド インスタンスの注釈のコンマ区切りの一覧。
SQL Serverに使用する PEM 形式の証明書秘密キーを含むファイルへのパス。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
SQL Serverに使用する PEM 形式の証明書公開キーを含むファイルへのパス。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
マネージド インスタンスのコア制限を整数として指定します。
マネージド インスタンスのコアに対する整数としての要求。
SQL マネージド インスタンスをデプロイする名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
この Arc 対応SQL Managed Instanceの keytab ファイルを含む Kubernetes シークレットの名前。
SQL マネージド インスタンスのラベルのコンマ区切りの一覧。
このマネージド インスタンスに適用するライセンスの種類の許容値は、BasePrice、LicenseIncluded、DisasterRecovery.Default は LicenseIncluded です。 ライセンスの種類を変更できます。.
整数の後に Gi (ギガバイト) が続くマネージド インスタンスの容量の制限。 例: 4Gi。
整数の後に Gi (ギガバイト) が続くマネージド インスタンスの容量に対する要求。 例: 4Gi。
実行時間の長い操作が完了するまで待つ必要はありません。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
高可用性オーケストレーター レプリカの数。 値は 1 から 3 の間である必要があります。
SQL マネージド インスタンスの json ファイルのazext_arcdata ファイルへのパス。
更新する優先プライマリ レプリカ。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
読み取り可能にするレプリカの数。 Business Critical レベルにのみ適用されます。 値は 0 からレプリカの数から 1 を引いた値にする必要があります。
このオプションでは、高可用性のために Kubernetes クラスターにデプロイされるSQL Managed Instanceレプリカの数を指定します。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | 1, 2, 3 |
Arc 対応SQL Managed Instanceが存在するAzure リソース グループ。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Azure Resource Manager – targeted Arguments |
バックアップの保有期間 (日数で指定)。 使用できる値は 0 ~ 35 です。 既定値は 7 です。 保有期間を 0 に設定すると、SQL マネージド インスタンス上のすべてのデータベースの自動バックアップが無効になり、以前のバックアップはすべて削除されます。
すべての外部サービスに適用する注釈のコンマ区切りリスト。
SQL サービス証明書をホストまたはホストする生成する Kubernetes シークレットの名前。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
すべての外部サービスに適用するラベルのコンマ区切りリスト。
コミットするために同期する必要があるセカンダリ レプリカの数。 この値を -1 に設定すると、必要な同期されたセカンダリの数が切り捨てられた '(# of replicas - 1) / 2' に設定されます。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | -1, 0, 1, 2 |
この Arc 対応SQL Managed InstanceのTransparent Data Encryption (TDE) モード。 使用できる値: ServiceManaged、CustomerManaged、または Disabled。 既定値は [無効] です。
TDE に使用する PEM 形式の証明書秘密キーを含むファイルへのパス。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
TDE に使用する PEM 形式の証明書公開キーを含むファイルへのパス。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
この Arc 対応SQL Managed Instanceの TDE 保護機能証明書と秘密キーを含む Kubernetes シークレットの名前。 CustomerManaged TDE モードでのみ指定できます。
インスタンスの価格レベル。 使用できる値: BusinessCritical (bc for short) または GeneralPurpose (gp for short)。 既定値は GeneralPurpose です。
インスタンスのSQL Serverタイム ゾーン。
トレースフラグのコンマ区切りリスト。 既定ではフラグはありません。
このアクションを実行するには、ローカル Kubernetes API を使用します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --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 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
アップグレードする最新の有効なバージョン。 オプション。バージョンが指定されていない場合は、データ コントローラーのバージョンが使用されます。 'auto' を指定して、最新の有効なバージョンに自動的にアップグレードします。 自動アップグレードの詳細については、「 https://aka.ms/arc-sqlmi-auto-upgrade」を参照してください。
アップグレードするインスタンスを示しますが、実際にはインスタンスをアップグレードしません。
リソースのプロパティに基づいてアップグレードするインスタンスを選択するフィルター。
インスタンスに適用できるすべてのポリシーをオーバーライドし、アップグレードを試みます。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
SQL マネージド インスタンスをデプロイする名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
ラベルに基づいてアップグレードするインスタンスを選択するフィルター。
SQL マネージド インスタンスの名前。
実行時間の長い操作が完了するまで待つ必要はありません。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
ターゲットの Arc 対応SQL Managed Instanceが存在するAzure リソース グループ。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Azure Resource Manager – targeted Arguments |
オプション '--target' は非推奨となり、今後のリリースで削除される予定です。 代わりに '--desired-version' を使用してください。
アップグレードする最新の有効なバージョン。 オプション。バージョンが指定されていない場合は、データ コントローラーのバージョンが使用されます。 'auto' を指定して、最新の有効なバージョンに自動的にアップグレードします。 自動アップグレードの詳細については、「 https://aka.ms/arc-sqlmi-auto-upgrade」を参照してください。
このアクションを実行するには、ローカル Kubernetes API を使用します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Kubernetes API – targeted Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |