az sql mi-arc config

Note

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

組態命令。

命令

名稱 Description 類型 狀態
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 config add

在組態檔中新增 json 路徑的值。

在設定檔的 json 路徑加入這個值。 下列所有範例都會在Bash中提供。 如果使用其他命令列，可能需要適當地避免引號。 或者，您可以使用修補程序檔案功能。

az sql mi-arc config add --json-values
                         --path
                         [--acquire-policy-token]
                         [--change-reference]

範例

例如 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。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy 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

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az sql mi-arc config init

初始化 SQL 管理實例的 CRD 與規範檔案。

az sql mi-arc config init --path
                          [--acquire-policy-token]
                          [--change-reference]

範例

初始化 SQL 管理實例的 CRD 與規範檔案。

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

必要參數

--path -p

應寫入 SQL 受控實例的 CRD 和規格路徑。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy 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

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az sql mi-arc config patch

根據 JSON 補丁檔修補設定檔。

根據給定的修補檔去修補設定檔。 請諮詢 http://jsonpatch.com/ 以更了解路徑的組成方式。 由於 jsonpath 連結庫 https://jsonpath.com/，取代作業可以在其路徑中使用條件式。 所有補丁 json 檔案必須以一個鍵開頭，該鍵 patch 包含一個補丁陣列及其對應的運算符（新增、替換、移除）、路徑和值。 這個 remove op 不需要值，只要有路徑就好。 請參閱以下範例。

az sql mi-arc config patch --patch-file
                           --path
                           [--acquire-policy-token]
                           [--change-reference]

範例

例如 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/。 你必須用一個叫 patch做 的鍵開始你的補丁 json 檔，這個值是你打算做的修補操作陣列。 對於補丁操作的路徑，你可以使用點符號，就像 key1.key2 大多數操作一樣。 如果您想要執行取代作業，而且您要取代需要條件的陣列中的值，請使用 jsonpath 表示法，方法是以 $開頭您的路徑。 這會讓你能用條件式，例如 $.key1.key2[?(@.key3=="someValue"].key4。請參考以下範例。 如需更多條件句的協助，請參見： https://jsonpath.com/。

--path -p

通往自訂資源規範的路徑，即 custom/spec.json。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy 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

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az sql mi-arc config remove

拿掉組態檔中 json 路徑的值。

在設定檔的 json 路徑移除該值。 下列所有範例都會在Bash中提供。 如果使用其他命令列，可能需要適當地避免引號。 或者，您可以使用修補程序檔案功能。

az sql mi-arc config remove --json-path
                            --path
                            [--acquire-policy-token]
                            [--change-reference]

範例

例如 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。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy 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

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az sql mi-arc config replace

取代組態檔中 json 路徑的值。

在設定檔的 json 路徑替換該值。 下列所有範例都會在Bash中提供。 如果使用其他命令列，可能需要適當地避免引號。 或者，您可以使用修補程序檔案功能。

az sql mi-arc config replace --json-values
                             --path
                             [--acquire-policy-token]
                             [--change-reference]

範例

例如 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。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy 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

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False