Share via

az sql mi-arc

  • リファレンス

Note

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

Azure Arc に対応した SQL マネージド インスタンスを管理します。

コマンド

名前 説明 型 Status
az sql mi-arc config

構成コマンド。

 拡張 GA
az sql mi-arc config add

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

 拡張 GA
az sql mi-arc config init

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

 拡張 GA
az sql mi-arc config patch

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

 拡張 GA
az sql mi-arc config remove

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

 拡張 GA
az sql mi-arc config replace

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

 拡張 GA
az sql mi-arc create

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

 拡張 GA
az sql mi-arc delete

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

 拡張 GA
az sql mi-arc edit

非推奨です。更新プログラムは編集時に使用してください。

 拡張 非推奨
az sql mi-arc endpoint

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

 拡張 GA
az sql mi-arc endpoint list

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

 拡張 GA
az sql mi-arc get-mirroring-cert

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

 拡張 GA
az sql mi-arc list

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

 拡張 GA
az sql mi-arc reprovision-replica

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

 拡張 GA
az sql mi-arc show

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

 拡張 GA
az sql mi-arc update

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

 拡張 GA
az sql mi-arc upgrade

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

 拡張 GA

az sql mi-arc create

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

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

az sql mi-arc create --name
                     [--ad-account-name]
                     [--ad-connector-name]
                     [--ad-encryption-types]
                     [--admin-login-secret]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--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]
                     [--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 マネージド インスタンスの名前。

省略可能のパラメーター

--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 シークレットの名前。

--agent-enabled

インスタンスで SQL Server エージェントを有効にします。 既定では、無効になっています。 使用可能な値は 'true' または 'false' です。

--annotations

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

--cert-private-key-file

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

--cert-public-key-file

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

--collation

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

--cores-limit -c

マネージド インスタンスのコア数の制限 (整数)。

--cores-request

マネージド インスタンスのコア数の要求 (整数)。

--custom-location

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

--dev

これを指定した場合、それは dev インスタンスと見なされ、課金されません。

--k8s-namespace -k

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

--keytab-secret

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

--labels

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

--language

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

--license-type -l

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

--memory-limit -m

マネージド インスタンスの容量の制限を、整数の後に Gi (ギガバイト) を付けて表したもの。 例: 4Gi。

--memory-request

マネージド インスタンスの容量の要求を、整数の後に Gi (ギガバイト) を付けて表したもの。 例: 4Gi。

--no-external-endpoint

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

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

--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 リソース グループ。

--retention-days

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

--secondary-dns-name

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

--secondary-port-number

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

--service-annotations

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

--service-cert-secret

生成され、SQL サービス証明書をホストする (予定の) Kubernetes シークレットの名前。

--service-labels

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

--service-type

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

承認された値: LoadBalancer, NodePort
--storage-annotations

すべての PVC に適用する注釈のコンマ区切りリスト。

--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 に適用するラベルのコンマ区切りリスト。

--sync-secondary-to-commit

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

承認された値: -1, 0, 1, 2
既定値: -1
--tde-mode

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

--tde-protector-private-key-file

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

--tde-protector-public-key-file

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

--tde-protector-secret

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

--tier -t

インスタンスの価格レベル。 使用可能な値: BusinessCritical (短縮形は bc) または GeneralPurpose (短縮形は gp)。 既定値は GeneralPurpose です。

--time-zone

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

--trace-flags

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

--use-k8s

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

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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql mi-arc delete

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

az sql mi-arc delete --name
                     [--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 マネージド インスタンスの名前。

省略可能のパラメーター

--k8s-namespace -k

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

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
--resource-group -g

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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql mi-arc edit

非推奨

このコマンドは非推奨となり、今後のリリースで削除される予定です。 代わりに 'update' を使用してください。

非推奨です。更新プログラムは編集時に使用してください。

az sql mi-arc edit --name
                   [--agent-enabled]
                   [--annotations]
                   [--cores-limit]
                   [--cores-request]
                   [--custom-location]
                   [--dev]
                   [--k8s-namespace]
                   [--labels]
                   [--license-type]
                   [--location]
                   [--memory-limit]
                   [--memory-request]
                   [--no-wait]
                   [--path]
                   [--resource-group]
                   [--retention-days]
                   [--service-annotations]
                   [--service-labels]
                   [--tag-name]
                   [--tag-value]
                   [--tier]
                   [--time-zone]
                   [--trace-flags]
                   [--use-k8s]

必須のパラメーター

--name -n

編集されている SQL マネージド インスタンスの名前。 インスタンスを配置するときに使用した名前を変更することはできません。

省略可能のパラメーター

--agent-enabled

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

--annotations

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

--cores-limit -c

マネージド インスタンスのコア数の制限 (整数)。

--cores-request

マネージド インスタンスのコア数の要求 (整数)。

--custom-location

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

--dev

これを指定した場合、それは dev インスタンスと見なされ、課金されません。

--k8s-namespace -k

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

--labels

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

--license-type

このマネージド インスタンスに対して更新するライセンスの種類の許可される値は、BasePrice、LicenseIncluded、DisasterRecovery です。 既定値は LicenseIncluded です。

--location

sqlmi メタデータが格納される Azure の場所 (例: eastus)。

--memory-limit -m

マネージド インスタンスの容量の制限を、整数の後に Gi (ギガバイト) を付けて表したもの。 例: 4Gi。

--memory-request

マネージド インスタンスの容量の要求を、整数の後に Gi (ギガバイト) を付けて表したもの。 例: 4Gi。

--no-wait

指定した場合、コマンドは戻る前に、インスタンスが準備完了状態になるのを待機しません。

既定値: False
--path

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

--resource-group -g

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

--retention-days

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

--service-annotations

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

--service-labels

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

--tag-name

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

--tag-value

SQL マネージド インスタンスのタグ値。

--tier -t

インスタンスの価格レベル。 使用可能な値: BusinessCritical (短縮形は bc) または GeneralPurpose (短縮形は gp)。 既定値は GeneralPurpose です。

--time-zone

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

--trace-flags

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

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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql mi-arc get-mirroring-cert

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

az sql mi-arc get-mirroring-cert --cert-file
                                 --name
                                 [--k8s-namespace]
                                 [--use-k8s]

例

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

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

必須のパラメーター

--cert-file

取得した証明書を PEM 形式で保存するためのローカル ファイル名。

--name -n

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

省略可能のパラメーター

--k8s-namespace -k

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

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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

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

省略可能のパラメーター

--custom-location

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

--k8s-namespace -k

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

--resource-group -g

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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql mi-arc reprovision-replica

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

az sql mi-arc reprovision-replica --name
                                  [--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 マネージド インスタンス レプリカの名前。

省略可能のパラメーター

--k8s-namespace -k

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

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
--use-k8s

ローカル Kubernetes API を使用して SQL マネージド インスタンス レプリカを再プロビジョニングします。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

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 マネージド インスタンスの名前。

省略可能のパラメーター

--k8s-namespace -k

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

--path -p

SQL マネージド インスタンスの完全な仕様が書き込まれるパス。 省略した場合、仕様は標準出力に書き込まれます。

--resource-group -g

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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql mi-arc update

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

az sql mi-arc update --name
                     [--ad-encryption-types]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--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 マネージド インスタンスの名前。 インスタンスを配置するときに使用した名前を変更することはできません。

省略可能のパラメーター

--ad-encryption-types

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

--agent-enabled

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

--annotations

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

--cert-private-key-file

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

--cert-public-key-file

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

--cores-limit -c

マネージド インスタンスのコア数の制限 (整数)。

--cores-request

マネージド インスタンスのコア数の要求 (整数)。

--k8s-namespace -k

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

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

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

--readable-secondaries

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

--replicas

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

承認された値: 1, 2, 3
--resource-group -g

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

--retention-days

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

--service-annotations

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

--service-cert-secret

生成され、SQL サービス証明書をホストする (予定の) Kubernetes シークレットの名前。

--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 形式の証明書秘密キーを含むファイルへのパス。

--tde-protector-public-key-file

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

--tde-protector-secret

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

--tier -t

インスタンスの価格レベル。 使用可能な値: BusinessCritical (短縮形は bc) または GeneralPurpose (短縮形は gp)。 既定値は GeneralPurpose です。

--time-zone

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

--trace-flags

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

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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql mi-arc upgrade

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

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

az sql mi-arc upgrade [--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

省略可能のパラメーター

--desired-version -v

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

--dry-run -d

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

--field-filter -f

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

--force

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

既定値: False
--k8s-namespace -k

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

--label-filter -l

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

--name -n

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

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
--resource-group -g

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

--target
非推奨

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

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

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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。