共用方式為

az sql mi-arc config

  • 參考

注意

此參考是 Azure CLI 的 arcdata 延伸模組的一部分 （2.3.1 版或更高版本）。 擴充功能會在您第一次執行 az sql mi-arc config 命令時自動安裝。 深入了解擴充功能。

組態命令。

命令

名稱 Description 類型 狀態
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 。 您可以提供內嵌 json 值，例如： key='{"kind":"cluster","name":"test-cluster"}' 或提供檔案路徑，例如 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az sql mi-arc config patch

根據 json 修補程式檔案修補組態檔。

根據指定的修補檔修補組態檔。 請參閱 http://jsonpatch.com/ 以進一步瞭解應該如何撰寫路徑。 基於 jsonpath 程式庫 https://jsonpath.com/ \(英文\) 的原因，取代作業可以在其路徑中使用條件。 所有修補程式 JSON 檔案的開頭都必須是索引鍵 patch ，其具有具有其對應作業的修補程式陣列（新增、取代、移除）、路徑和值。 作業 remove 不需要值，只需要路徑。 請參閱以下範例。

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

範例

例如 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 程式庫 http://jsonpatch.com/ \(英文\) 為基礎之修補 json 檔案的路徑。 您必須使用名為 patch 的金鑰來啟動修補 json 檔案，其值為您想要進行之修補作業的陣列。 針對修補作業的路徑，您可以使用點標記法，例如 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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 - 取代單一端點的埠。

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 。 您可以提供內嵌 json 值，例如： key={"kind":"cluster","name":"test-cluster"} 或提供檔案路徑，例如 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。