az sql mi-arc config

Note

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

構成コマンド。

コマンド

名前 説明 Status
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 config add

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

構成ファイル内の json パスの位置に値を追加します。 以下の例はすべて Bash で指定されています。 別のコマンド ラインを使用している場合は、引用符の適切なエスケープが必要になることがあります。 あるいは、修正プログラム ファイルの機能を使用することもできます。

az sql mi-arc config add --json-values
                         --path

例 1 - ストレージを追加します。

az sql mi-arc config add --path custom/spec.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

必須のパラメーター

--json-values -j

値への json パスのキー値ペアリスト: key1.subkey1=value1,key2.subkey2=value2 次のような key='{"kind":"cluster","name":"test-cluster"}' インライン json 値を指定することも、次のような key=./values.jsonファイル パスを指定することもできます。 add コマンドでは、条件文はサポートされていません。 指定するインライン値がキー値のペア自体 = である場合は、 , それらの文字をエスケープしてください。 (例: key1=\"key2\=val2\,key3\=val3\")。 パスの例については、 http://jsonpatch.com/ を参照してください。 配列にアクセスする場合は、次のように key.0=valueインデックスを指定する必要があります。

--path -p

カスタム リソース仕様 (custom/spec.json) へのパス。

グローバル パラメーター
--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 config init

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

az sql mi-arc config init --path

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

az sql mi-arc config init --path ./template

必須のパラメーター

--path -p

SQL マネージド インスタンスの CRD および仕様が書き込まれるパス。

グローバル パラメーター
--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 config patch

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

指定されたパッチ ファイルに従って、構成ファイルにパッチを適用します。 パスを構成する方法の詳細については、http://jsonpatch.com/ を参照してください。 置き換え操作では、jsonpath ライブラリ https://jsonpath.com/ に従って、そのパス内で条件文を使用できます。 すべての修正プログラム json ファイルは、対応する操作 (add、replace、remove)、パス、および値で構成される修正プログラムの配列を含む patch のキーで始まる必要があります。 remove 操作には値は必要なく、パスだけが必要です。 次の例を参照してください。

az sql mi-arc config patch --patch-file
                           --path

例 1 - 修正プログラム ファイルを使用して、1 つのエンドポイントのポートを置き換えます。

az sql mi-arc config patch --path custom/spec.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":"$.spec.endpoints[?(@.name=='Controller')].port","value":30080}]}

例 2 - 修正プログラム ファイルを使用して、ストレージを置き換えます。

az sql mi-arc config patch --path custom/spec.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":".spec.storage","value":{"accessMode":"ReadWriteMany","className":"managed-premium","size":"10Gi"}}]}

必須のパラメーター

--patch-file

jsonpatch ライブラリに基づいた修正プログラム json ファイルへのパス (http://jsonpatch.com/ )。 パッチ json ファイルは、パッチ操作の配列である値を持つ、という patch名前のキーで開始する必要があります。 パッチ操作のパスには、ほとんどの操作など key1.key2 、ドット表記を使用できます。 置き換え操作を実行するときに、条件文を必要とする配列内の値を置き換えている場合は、パスを $ で始めて jsonpath 表記を使用してください。 これにより、次のような $.key1.key2[?(@.key3=="someValue"].key4条件付き操作を実行できます。以下の例を参照してください。 条件に関するその他のヘルプについては、次 https://jsonpath.com/を参照してください。

--path -p

カスタム リソース仕様へのパス。つまり custom/spec.json

グローバル パラメーター
--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 config remove

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

構成ファイル内の json パスの位置にある値を削除します。 以下の例はすべて Bash で指定されています。 別のコマンド ラインを使用している場合は、引用符の適切なエスケープが必要になることがあります。 あるいは、修正プログラム ファイルの機能を使用することもできます。

az sql mi-arc config remove --json-path
                            --path

例 1 - ストレージを削除します。

az sql mi-arc config remove --path custom/spec.json --json-path '.spec.storage'

必須のパラメーター

--json-path -j

どの値を削除するかを示す jsonpatch ライブラリに基づいた json パスのリスト (key1.subkey1,key2.subkey2 など)。 remove コマンドでは、条件文はサポートされていません。 パスの例については、 http://jsonpatch.com/ を参照してください。 配列にアクセスする場合は、次のように key.0=valueインデックスを指定する必要があります。

--path -p

カスタム リソース仕様へのパス。つまり custom/spec.json

グローバル パラメーター
--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 config replace

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

構成ファイル内の json パスの位置にある値を置き換えます。 以下の例はすべて Bash で指定されています。 別のコマンド ラインを使用している場合は、引用符の適切なエスケープが必要になることがあります。 あるいは、修正プログラム ファイルの機能を使用することもできます。

az sql mi-arc config replace --json-values
                             --path

例 1 - 1 つのエンドポイントのポートを置き換えます。

az sql mi-arc config replace --path custom/spec.json --json-values '$.spec.endpoints[?(@.name=="Controller")].port=30080'

例 2 - ストレージを置き換えます。

az sql mi-arc config replace --path custom/spec.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

必須のパラメーター

--json-values -j

値への json パスのキー値ペアリスト: key1.subkey1=value1,key2.subkey2=value2 次のような key={"kind":"cluster","name":"test-cluster"} インライン json 値を指定することも、次のような key=./values.jsonファイル パスを指定することもできます。 replace コマンドでは、jsonpath ライブラリによる条件文がサポートされています。 これを使用するには、パスを $ で始めます。 これにより、次のような -j $.key1.key2[?(@.key3=="someValue"].key4=value条件付き操作を実行できます。 指定するインライン値がキー値のペア自体 = である場合は、 , それらの文字をエスケープしてください。 たとえば、「 key1=\"key2\=val2\,key3\=val3\" 」のように入力します。 以下の例を参照できます。 その他のヘルプについては、以下 https://jsonpath.com/を参照してください。

--path -p

カスタム リソース仕様へのパス。つまり custom/spec.json

グローバル パラメーター
--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 を使います。