az sql mi-arc

Note

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

管理Azure Arc啟用的SQL管理實例。

命令

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

建立一個 SQL 管理的實例，並透過 Kubernetes API 進行 Active Directory 認證。

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 受控實例的名稱。

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--ad-account-name

這個啟用 SQL 受管理執行個體的 Active Directory 帳號名稱。此帳號必須在部署此實例之前建立。

--ad-connector-name

Active Directory 連接器的名稱。此參數表示意圖以 AD 支援部署。

--ad-encryption-types

一份以逗號分隔的 Active Directory 加密類型清單。必須是以下數值的子集：RC4、AES128、AES256。

--admin-login-secret

產生該主機或將要主機的使用者管理員登入帳號憑證的 Kubernetes 秘密名稱。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--agent-enabled

啟用 SQL Server agent 來執行實例。預設值為停用。允許的值為「真」或「假」。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--annotations

以逗號分隔的 SQL 管理實例註解清單。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--cert-private-key-file

通往包含 PEM 格式憑證私鑰的檔案路徑，供 SQL Server 使用。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--cert-public-key-file

包含 PEM 格式憑證公鑰的檔案路徑，供 SQL Server 使用。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--collation

該實例的 SQL Server 整合。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--cores-limit -c

受控實例的核心限制為整數。

--cores-request

以整數表示受控實例核心的要求。

--custom-location

這個實例的自訂地點。

屬性	值
參數群組:	Azure Resource Manager – targeted Arguments

--dev

如果有指定，則視為開發實例，不會被收費。

--k8s-namespace -k

要部署 SQL 受控實例的命名空間。如果未指定任何命名空間，則會使用 kubeconfig 中定義的命名空間。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--keytab-secret

包含這個啟用 SQL 受管理執行個體鍵表檔案的 Kubernetes 秘密名稱。

--labels

以逗號分隔的 SQL 管理實例標籤清單。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--language

將 SQL Server 的所在地映射到該實例的任何支援語言識別碼（LCID）。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--license-type -l

此受管理實例允許值的授權類型為：BasePrice、LicenseIncluded、DisasterRecovery。預設為 LicenseIncluded。駕照類型可以更換......

--memory-limit -m

受管理實例容量的上限為整數後接 Gi（吉字節）。舉例：4Gi。

--memory-request

請求管理實例的容量為整數，後接 Gi（GB）。舉例：4Gi。

--no-external-endpoint

如果指定，將不會建立任何外部服務。否則，將會使用與數據控制器相同的服務類型來建立外部服務。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--no-wait

請勿等候長時間執行的作業完成。

屬性	值
預設值:	False

--orchestrator-replicas

高可用性編排器副本的數量。數值必須介於1到3之間。

--path

SQL 受控實例 json 檔案azext_arcdata檔案的路徑。

--primary-dns-name

主要的服務 DNS 名稱是開放給終端用戶以連接此 Arc 啟用SQL 受管理執行個體（例如 sqlinstancename.contoso.com）。

--primary-port-number

主要服務暴露給終端用戶的埠號（例如 31433）。

--private-key-file

由 openSSL 產生的私鑰檔案，作為實例 ID。

--readable-secondaries

要讓複本數量變得可讀。僅適用於業務關鍵層級。值必須介於 0 與複本數減 1 之間。

--replicas

此選項指定將部署於 Kubernetes 叢集中的 SQL 受管理執行個體副本數量，以維持高可用性需求。預設是通用用 1 個複本，商業關鍵用 3 個複本。

屬性	值
接受的值:	1, 2, 3

--resource-group -g

應該加入啟用 SQL 受管理執行個體的 Azure 資源群組。

屬性	值
參數群組:	Azure Resource Manager – targeted Arguments

--retention-days

備用保留期，以天數為單位。允許的數值為 0 到 35。預設值為 7。將保留期間設為 0 會關閉 SQL 管理實例中所有資料庫的自動備份，且先前的備份也會被刪除。

--secondary-dns-name

次要服務 DNS 名稱會暴露給終端使用者，以便連接到這個啟用 Arc 的SQL 受管理執行個體（例如 sqlinstancename2.contoso.com）。

--secondary-port-number

次級服務暴露給終端使用者的埠號（例如 31434）。

--service-annotations

所有外部服務的逗號分隔註解清單。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--service-cert-secret

產生該主機或將要主機的 SQL 服務憑證的 Kubernetes 秘密名稱。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--service-labels

標註清單，為所有外部服務套用。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--service-type

主要服務的類型。

屬性	值
接受的值:	LoadBalancer, NodePort

--storage-annotations

所有 PVC 的逗號分隔註解清單。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--storage-class-backups

一個支援 ReadWriteMany （RWX）的儲存類別，用於備份（/var/opt/mssql/backups）。若未指定值，則會使用預設儲存類別。

--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可套用逗號分隔的標籤清單。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--sync-secondary-to-commit

必須同步才能提交的次要副本數量。將此值設為 -1 會將所需的同步次級節點數設為「（# of replicas - 1） / 2」，向下取整。

屬性	值
預設值:	-1
接受的值:	-1, 0, 1, 2

--tde-mode

此透明資料加密（TDE）模式用於此 Arc 啟用的 SQL 受管理執行個體。允許的值：ServiceManaged、CustomerManaged 或 Disabled。預設值為 Disabled。

--tde-protector-private-key-file

傳送至包含 PEM 格式憑證私鑰的檔案路徑，供 TDE 使用。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--tde-protector-public-key-file

包含 PEM 格式憑證公鑰的檔案路徑，供 TDE 使用。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--tde-protector-secret

包含此 Arc 啟用 SQL 受管理執行個體的 TDE 保護憑證與私鑰的 Kubernetes 秘密名稱。只能指定為 CustomerManaged TDE 模式。

--tier -t

實例的定價層。允許的值：BusinessCritical（簡稱 bc）或 GeneralPurpose（簡稱 gp）。預設是通用型。

--time-zone

實例的 SQL Server 時區。

--trace-flags

traceflag 的逗號分隔列表。預設沒有標記。

--use-k8s

使用本地 Kubernetes API 建立 SQL 管理的實例。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--volume-size-backups

要用於備份的記憶體磁碟區大小為正數，後面接著Ki（KB）、Mi（MB）或 Gi （GB）。

--volume-size-data

要作為正數的數據使用的儲存磁碟區大小，後面接著Ki（KB）、Mi （MB）或 Gi （GB）。

--volume-size-datalogs

要用於數據記錄的記憶體磁碟區大小為正數，後面接著Ki（KB）、Mi（MB）或 Gi （GB）。

--volume-size-logs

要用於記錄的記憶體磁碟區大小為正數，後面接著Ki（KB）、Mi（MB）或 GI （GB）。

--volume-size-orchestrator-logs

用於編排器日誌的儲存容量以正數接 Ki（千位元組）、Mi（兆位元組）或 Gi（吉位元組）表示。

全域參數

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

必要參數

--name -n

要刪除的 SQL 受控實例名稱。

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--k8s-namespace -k

要部署 SQL 受控實例的命名空間。如果未指定任何命名空間，則會使用 kubeconfig 中定義的命名空間。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--no-wait

請勿等候長時間執行的作業完成。

屬性	值
預設值:	False

--resource-group -g

即是 ArcGIS 啟用的 SQL 受管理執行個體所屬的 Azure 資源群組。

屬性	值
參數群組:	Azure Resource Manager – targeted Arguments

--use-k8s

使用本地 Kubernetes API 來執行此操作。

屬性	值
參數群組:	Kubernetes API – targeted 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 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

必要參數

--cert-file

本地檔案名稱用來儲存擷取的憑證，格式為 PEM 格式。

--name -n

SQL 受控實例的名稱。

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--k8s-namespace -k

要部署 SQL 受控實例的命名空間。如果未指定任何命名空間，則會使用 kubeconfig 中定義的命名空間。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--use-k8s

使用本地 Kubernetes API 來執行此操作。

屬性	值
參數群組:	Kubernetes API – targeted 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 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 管理實例部署的自訂位置。若未指定，資源群組中的所有實例都會被列出。

屬性	值
參數群組:	Azure Resource Manager – targeted Arguments

--k8s-namespace -k

包含 Arc 啟用的 SQL 受管理實例的 Kubernetes 命名空間。如果未指定任何命名空間，則會使用 kubeconfig 中定義的命名空間。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--resource-group -g

包含 Arc 啟用的 SQL 管理實例的 Azure 資源群組。

屬性	值
參數群組:	Azure Resource Manager – targeted Arguments

--use-k8s

使用本地 Kubernetes API 來執行此操作。

屬性	值
參數群組:	Kubernetes API – targeted 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 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

必要參數

--name -n

要重新配置的 SQL 管理實例副本名稱。

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--k8s-namespace -k

命名空間，是部署 SQL 管理實例副本的地方。如果未指定任何命名空間，則會使用 kubeconfig 中定義的命名空間。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--no-wait

請勿等候長時間執行的作業完成。

屬性	值
預設值:	False

--use-k8s

使用本地 Kubernetes API 重新配置 SQL 管理的實例副本。

屬性	值
參數群組:	Kubernetes API – targeted 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 show

顯示 SQL 受控實例的詳細數據。

az sql mi-arc show --name
                   [--k8s-namespace]
                   [--path]
                   [--resource-group]
                   [--use-k8s]

範例

使用 Kubernetes API 顯示 SQL 受管理執行個體的詳細資料。

az sql mi-arc show --name sqlmi1 --k8s-namespace arc --use-k8s

查詢 Azure Resource Manager （ARM），顯示 SQL 受管理執行個體的詳細資訊。

az sql mi-arc show --name sqlmi1 --resource-group rg-name

必要參數

--name -n

要顯示的 SQL 受控實例名稱。

選擇性參數

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

--k8s-namespace -k

要部署 SQL 受控實例的命名空間。如果未指定任何命名空間，則會使用 kubeconfig 中定義的命名空間。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--path -p

應寫入 SQL 受控實例完整規格的路徑。如果省略，則會將規格寫入標準輸出。

--resource-group -g

即是 ArcGIS 啟用的 SQL 受管理執行個體所屬的 Azure 資源群組。

屬性	值
參數群組:	Azure Resource Manager – targeted Arguments

--use-k8s

使用本地 Kubernetes API 來執行此操作。

屬性	值
參數群組:	Kubernetes API – targeted 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 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

必要參數

--name -n

正在編輯的 SQL 受控實例名稱。無法變更部署實例的名稱。

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--ad-encryption-types

一份以逗號分隔的 Active Directory 加密類型清單。必須是以下數值的子集：RC4、AES128、AES256。

--agent-enabled

啟用 SQL Server agent 來執行實例。預設值為停用。

--annotations

以逗號分隔的 SQL 管理實例註解清單。

--cert-private-key-file

通往包含 PEM 格式憑證私鑰的檔案路徑，供 SQL Server 使用。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--cert-public-key-file

包含 PEM 格式憑證公鑰的檔案路徑，供 SQL Server 使用。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--cores-limit -c

受控實例的核心限制為整數。

--cores-request

以整數表示受控實例核心的要求。

--k8s-namespace -k

要部署 SQL 受控實例的命名空間。如果未指定任何命名空間，則會使用 kubeconfig 中定義的命名空間。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--keytab-secret

包含這個啟用 SQL 受管理執行個體鍵表檔案的 Kubernetes 秘密名稱。

--labels

以逗號分隔的 SQL 管理實例標籤清單。

--license-type -l

此受管理實例允許值的授權類型為：BasePrice、LicenseIncluded、DisasterRecovery。預設為 LicenseIncluded。駕照類型可以更換......

--memory-limit -m

受管理實例容量的上限為整數後接 Gi（吉字節）。舉例：4Gi。

--memory-request

請求管理實例的容量為整數，後接 Gi（GB）。舉例：4Gi。

--no-wait

請勿等候長時間執行的作業完成。

屬性	值
預設值:	False

--orchestrator-replicas

高可用性編排器副本的數量。數值必須介於1到3之間。

--path

SQL 受控實例 json 檔案azext_arcdata檔案的路徑。

--preferred-primary-replica

首選的主複本要更新。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--readable-secondaries

要讓複本數量變得可讀。僅適用於業務關鍵層級。值必須介於 0 與複本數減 1 之間。

--replicas

此選項指定將部署於 Kubernetes 叢集中的 SQL 受管理執行個體副本數量，以維持高可用性需求。

屬性	值
接受的值:	1, 2, 3

--resource-group -g

即是 ArcGIS 啟用的 SQL 受管理執行個體所屬的 Azure 資源群組。

屬性	值
參數群組:	Azure Resource Manager – targeted Arguments

--retention-days

--service-annotations

所有外部服務的逗號分隔註解清單。

--service-cert-secret

產生該主機或將要主機的 SQL 服務憑證的 Kubernetes 秘密名稱。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--service-labels

標註清單，為所有外部服務套用。

--sync-secondary-to-commit

必須同步才能提交的次要副本數量。將此值設為 -1 會將所需的同步次級節點數設為「（# of replicas - 1） / 2」，向下取整。

屬性	值
接受的值:	-1, 0, 1, 2

--tde-mode

此透明資料加密（TDE）模式用於此 Arc 啟用的 SQL 受管理執行個體。允許的值：ServiceManaged、CustomerManaged 或 Disabled。預設值為 Disabled。

--tde-protector-private-key-file

傳送至包含 PEM 格式憑證私鑰的檔案路徑，供 TDE 使用。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--tde-protector-public-key-file

包含 PEM 格式憑證公鑰的檔案路徑，供 TDE 使用。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--tde-protector-secret

包含此 Arc 啟用 SQL 受管理執行個體的 TDE 保護憑證與私鑰的 Kubernetes 秘密名稱。只能指定為 CustomerManaged TDE 模式。

--tier -t

實例的定價層。允許的值：BusinessCritical（簡稱 bc）或 GeneralPurpose（簡稱 gp）。預設是通用型。

--time-zone

實例的 SQL Server 時區。

--trace-flags

traceflag 的逗號分隔列表。預設沒有標記。

--use-k8s

使用本地 Kubernetes API 來執行此操作。

屬性	值
參數群組:	Kubernetes API – targeted 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 upgrade

升級 SQL 管理實例。

將 SQL 管理的實例升級到指定所需的版本。若未指定所需版本，則會使用資料控制器版本。

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

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--desired-version -v

升級到最新有效版本。若未指定版本，則可選使用資料控制器版本。設定「auto」即可自動升級到最新的有效版本。想了解更多自動升級資訊，請見： https://aka.ms/arc-sqlmi-auto-upgrade。

--dry-run -d

顯示將升級的實例，但實際上並未升級實例。

--field-filter -f

篩選以根據資源屬性選擇要升級的實例。

--force

會覆寫所有可能套用於該實例的政策，並嘗試升級。

屬性	值
預設值:	False

--k8s-namespace -k

要部署 SQL 受控實例的命名空間。如果未指定任何命名空間，則會使用 kubeconfig 中定義的命名空間。

屬性	值
參數群組:	Kubernetes API – targeted Arguments

--label-filter -l

篩選出根據標籤選擇要升級的實例。

--name -n

SQL 受控實例的名稱。

--no-wait

請勿等候長時間執行的作業完成。

屬性	值
預設值:	False

--resource-group -g

Azure 資源群組中目標 Arc 啟用的 SQL 受管理執行個體存在。

屬性	值
參數群組:	Azure Resource Manager – targeted Arguments

--target

已被取代

選項「--target」已被棄用，未來版本將被移除。改用「--desired-version」吧。

--use-k8s

使用本地 Kubernetes API 來執行此操作。

屬性	值
參數群組:	Kubernetes API – targeted 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

意見反應

此頁面對您有幫助嗎？