az sql db replica

管理資料庫之間的複寫。

命令

名稱	Description	類型	狀態
az sql db replica create	將資料庫建立為現有資料庫的可讀取次要複本。	核心	GA
az sql db replica delete-link	永久停止兩個資料庫複本之間的數據複寫。	核心	GA
az sql db replica list-links	列出資料庫的複本及其復寫狀態。	核心	GA
az sql db replica set-primary	從目前的主要復本資料庫故障轉移，以設定主要複本資料庫。	核心	GA

az sql db replica create

將資料庫建立為現有資料庫的可讀取次要複本。

執行 az sql db list-editions -a -o table -l LOCATION即可看到效能等級選項的完整清單。 輔助資料庫必須具有與主資料庫相同的版本。

az sql db replica create --name
                         --partner-server
                         --resource-group
                         --server
                         [--assign-identity {false, true}]
                         [--auto-pause-delay]
                         [--availability-zone]
                         [--backup-storage-redundancy]
                         [--capacity]
                         [--compute-model {Provisioned, Serverless}]
                         [--elastic-pool]
                         [--encryption-protector]
                         [--encryption-protector-auto-rotation {false, true}]
                         [--family]
                         [--federated-client-id]
                         [--ha-replicas]
                         [--keys]
                         [--license-type {BasePrice, LicenseIncluded}]
                         [--min-capacity]
                         [--no-wait]
                         [--partner-database]
                         [--partner-resource-group]
                         [--preferred-enclave-type {Default, VBS}]
                         [--read-scale {Disabled, Enabled}]
                         [--secondary-type]
                         [--service-level-objective]
                         [--tags]
                         [--umi]
                         [--zone-redundant {false, true}]

範例

建立效能等級為 S0 作為現有標準資料庫的次要複本的資料庫。

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --service-objective S0

使用 GeneralPurpose 版本、Gen4 硬體和 1 個虛擬核心建立資料庫，作為現有 GeneralPurpose 資料庫的次要複本

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb -f Gen4 -c 1

建立具有區域備援備份記憶體作為現有資料庫次要複本的資料庫。

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --backup-storage-redundancy Zone

必要參數

--name -n

Azure SQL 資料庫 的名稱。

--partner-server

要建立新復本的伺服器名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>。

選擇性參數

--assign-identity -i

指派資料庫的身分識別。

接受的值: false, true

--auto-pause-delay

在幾分鐘后自動暫停資料庫的時間。 值為 -1 表示已停用自動暫停。

--availability-zone

可用性區域。

--backup-storage-redundancy --bsr

用來儲存備份的備份記憶體備援。 允許的值包括：Local、Zone、Geo、GeoZone。

--capacity -c

SKU 的容量元件，以整數位 DTU 或虛擬核心為單位。

--compute-model

資料庫的計算模型。

接受的值: Provisioned, Serverless

--elastic-pool

要用來建立資料庫之彈性集區的名稱或資源標識符。

--encryption-protector

指定要作為資料庫加密保護裝置密鑰的 Azure 金鑰保存庫金鑰。

--encryption-protector-auto-rotation --epauto

指定資料庫加密保護裝置金鑰自動輪替旗標。 可以是 true、false 或 null。

接受的值: false, true

--family -f

SKU 的計算產生元件（僅適用於虛擬核心 SKU）。 允許的值包括：Gen4、Gen5。

--federated-client-id

SQL 資料庫的同盟用戶端標識碼。 它用於跨租使用者 CMK 案例。

--ha-replicas --read-replicas

要為資料庫布建的高可用性復本數目。 只有超大規模資料庫版本的可設定。

--keys

SQL 資料庫 的 AKV 金鑰清單。

--license-type

要套用此資料庫的授權類型。LicenseIncluded 如果您需要授權，或 BasePrice如果您有授權且符合 Azure HybridBenefit 資格。

接受的值: BasePrice, LicenseIncluded

--min-capacity

如果尚未暫停，資料庫一律會配置的最小容量。

--no-wait

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

預設值: False

--partner-database

新復本的名稱。 如果未指定，則預設為源資料庫名稱。

--partner-resource-group

要建立新復本的資源群組名稱。 如果未指定，則預設為原始資源群組。

--preferred-enclave-type

指定此資源的記憶體保護區類型。

接受的值: Default, VBS

--read-scale

如果啟用，將應用程式意圖設定為唯讀的連線 連接字串 可能會路由傳送至唯讀次要複本。 此屬性僅適用於 進階版和 業務關鍵 資料庫。

接受的值: Disabled, Enabled

--secondary-type

要建立的次要類型。 允許的值包括：Geo、Named。

--service-level-objective --service-objective

新資料庫的服務目標。 例如：Basic、S0、P1、GP_Gen4_1、GP_S_Gen5_8、BC_Gen5_2、HS_Gen5_32。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--umi --user-assigned-identity-id

SQL 資料庫的使用者指派身分識別清單。

--zone-redundant -z

指定是否要啟用區域備援。 如果未指定任何值，預設值為 true。

接受的值: false, true

全域參數

--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 db replica delete-link

永久停止兩個資料庫複本之間的數據複寫。

az sql db replica delete-link --partner-server
                              [--ids]
                              [--name]
                              [--partner-resource-group]
                              [--resource-group]
                              [--server]
                              [--subscription]
                              [--yes]

必要參數

--partner-server

另一個復本位於的伺服器名稱。

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

Azure SQL 資料庫 的名稱。

--partner-resource-group

另一個復本所屬的資源群組名稱。 如果未指定，則預設為第一個資料庫的資源群組。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>。

--subscription

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

--yes -y

不提示確認。

預設值: False

全域參數

--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 db replica list-links

列出資料庫的複本及其復寫狀態。

az sql db replica list-links [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

範例

列出資料庫的複本及其復寫狀態。 （ 自動產生 ）

az sql db replica list-links --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

Azure SQL 資料庫 的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>。

--subscription

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

全域參數

--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 db replica set-primary

從目前的主要複本資料庫容錯移轉，以設定主要複本資料庫。

az sql db replica set-primary [--allow-data-loss]
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--server]
                              [--subscription]

範例

從目前的主要復本資料庫故障轉移，以設定主要複本資料庫。 （ 自動產生 ）

az sql db replica set-primary --allow-data-loss --name MyDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription

選擇性參數

--allow-data-loss

如果指定，故障轉移作業將允許數據遺失。

預設值: False

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

要故障轉移的資料庫名稱。

--resource-group -g

包含將成為新主要複本之次要複本的資源群組名稱。

--server -s

包含將成為新主要複本之次要複本的伺服器名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>。

--subscription

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

全域參數

--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 來取得完整偵錯記錄。