az sql elastic-pool

  • 參考

管理彈性集區。

命令

名稱 Description 類型 狀態
az sql elastic-pool create

建立彈性集區。

 核心 GA
az sql elastic-pool delete

刪除彈性集區。

 核心 GA
az sql elastic-pool list

取得伺服器中的所有彈性集區。

 核心 GA
az sql elastic-pool list-dbs

取得彈性集區中的資料庫清單。

 核心 GA
az sql elastic-pool list-editions

列出作用中訂用帳戶可用的彈性集區版本。

 核心 GA
az sql elastic-pool op

管理彈性集區上的作業。

 核心 GA
az sql elastic-pool op cancel

取消彈性集區上的異步操作。

 核心 GA
az sql elastic-pool op list

取得在彈性集區上執行的作業清單。

 核心 GA
az sql elastic-pool show

取得彈性集區。

 核心 GA
az sql elastic-pool update

更新彈性集區。

 核心 GA

az sql elastic-pool create

編輯

建立彈性集區。

az sql elastic-pool create --name
                           --resource-group
                           --server
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--ha-replicas]
                           [--license-type {BasePrice, LicenseIncluded}]
                           [--maint-config-id]
                           [--max-size]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--tags]
                           [--zone-redundant {false, true}]

範例

建立已啟用區域備援的彈性集區

az sql elastic-pool create -g mygroup -s myserver -n mypool -z

建立已明確停用區域備援的彈性集區

az sql elastic-pool create -g mygroup -s myserver -n mypool -z false

建立標準 100 DTU 彈性集區。

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Standard -c 100

使用 GeneralPurpose 版本、Gen4 硬體和 1 個虛擬核心建立彈性集區。

az sql elastic-pool create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen4 -c 1

使用超大規模資料庫版本、Gen5 硬體、4 個虛擬核心和 2 個高可用性復本建立彈性集區。

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Hyperscale -f Gen5 -c 4 --ha-replicas 2

使用 VBS 記憶體保護區建立彈性集區。

az sql elastic-pool create -g mygroup -s myserver -n mydb --preferred-enclave-type VBS

必要參數

--name -n

彈性集區的名稱。

--resource-group -g

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

--server -s

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

選擇性參數

--capacity --dtu -c

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

--db-dtu-max --db-max-capacity --db-max-dtu

任何一個資料庫都可以取用的最大容量（在 DTU 或虛擬核心中）。

--db-dtu-min --db-min-capacity --db-min-dtu

保證每個資料庫的最小容量（在 DTU 或虛擬核心中）。

--edition --tier -e

SKU 版本元件。 允許的值包括：Basic、Standard、進階版、GeneralPurpose、BusinessCritical。

--family -f

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

--ha-replicas --read-replicas

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

--license-type

要套用此彈性集區的授權類型。

接受的值: BasePrice, LicenseIncluded
--maint-config-id -m

為此資源指定維護組態標識碼或名稱。

--max-size --storage

記憶體大小上限。 如果未指定任何單位，則預設為位元組 （B）。

--no-wait

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

預設值: False
--preferred-enclave-type

Azure SQL 彈性集區的慣用記憶體保護區類型。 允許的值包括：預設值、VBS。

接受的值: Default, VBS
--tags

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

--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 elastic-pool delete

編輯

刪除彈性集區。

az sql elastic-pool delete [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--server]
                           [--subscription]

選擇性參數

--ids

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

--name -n

彈性集區的名稱。

--no-wait

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

預設值: False
--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 elastic-pool list

編輯

取得伺服器中的所有彈性集區。

az sql elastic-pool list [--ids]
                         [--resource-group]
                         [--server]
                         [--skip]
                         [--subscription]

選擇性參數

--ids

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

--resource-group -g

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

--server -s

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

--skip

要略過之集合中的項目數目。 預設值為 None。

--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 elastic-pool list-dbs

編輯

取得彈性集區中的資料庫清單。

az sql elastic-pool list-dbs [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

選擇性參數

--ids

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

--name -n

彈性集區的名稱。

--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 elastic-pool list-editions

編輯

列出作用中訂用帳戶可用的彈性集區版本。

也包含可用的集區 DTU 設定、儲存體限制，以及個別資料庫設定。 為了減少繁複度，額外的儲存空間限制和個別資料庫設定預設為隱藏。

az sql elastic-pool list-editions --location
                                  [--available]
                                  [--dtu]
                                  [--edition]
                                  [--show-details {db-max-dtu, db-max-size, db-min-dtu, max-size}]
                                  [--vcores]

範例

顯示美國西部區域的所有彈性集區版本和集區 DTU 限制。

az sql elastic-pool list-editions -l westus -o table

在美國西部區域顯示標準版的所有集區 DTU 限制。

az sql elastic-pool list-editions -l westus --edition Standard -o table

顯示在美國西部區域中至少有 100 個 DTU 的彈性集區可用大小上限。

az sql elastic-pool list-editions -l westus --dtu 100 --show-details max-size -o table

顯示美國西部區域中標準 100 DTU 彈性集區的可用每個資料庫設定。

az sql elastic-pool list-editions -l westus --edition Standard --dtu 100 -o table --show-details db-min-dtu db-max-dtu db-max-size

必要參數

--location -l

位置。​​ 來自的值： az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

選擇性參數

--available -a

如果指定，則只會顯示指定區域中可用的結果。

預設值: False
--dtu

要搜尋的 DTU 數目。 如果未指定，則會顯示所有 DTU 大小。

--edition --tier -e

要搜尋的版本。 如果未指定，則會顯示所有版本。

--show-details -d

要包含在輸出中的其他詳細數據清單。

接受的值: db-max-dtu, db-max-size, db-min-dtu, max-size
--vcores

要搜尋的虛擬核心數目。 如果未指定，則會顯示所有虛擬核心大小。

全域參數
--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 elastic-pool show

編輯

取得彈性集區。

az sql elastic-pool show [--ids]
                         [--name]
                         [--resource-group]
                         [--server]
                         [--subscription]

選擇性參數

--ids

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

--name -n

彈性集區的名稱。

--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 elastic-pool update

編輯

更新彈性集區。

az sql elastic-pool update [--add]
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--force-string]
                           [--ha-replicas]
                           [--ids]
                           [--maint-config-id]
                           [--max-size]
                           [--name]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--remove]
                           [--resource-group]
                           [--server]
                           [--set]
                           [--subscription]
                           [--zone-redundant {false, true}]

範例

更新已啟用區域備援的彈性集區

az sql elastic-pool update -g mygroup -s myserver -n mypool -z

使用明確停用區域備援更新彈性集區

az sql elastic-pool update -g mygroup -s myserver -n mypool -z false

使用 2 個高可用性復本更新彈性集區

az sql elastic-pool update -g mygroup -s myserver -n mypool --ha-replicas 2

使用 VBS 記憶體保護區更新彈性集區

az sql elastic-pool update -g mygroup -s myserver -n mypool --preferred-enclave-type VBS

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例：--add property.listProperty <key=value, string or JSON string>。

預設值: []
--capacity --dtu -c

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

--db-dtu-max --db-max-capacity --db-max-dtu

任何一個資料庫都可以取用的最大容量（在 DTU 或虛擬核心中）。

--db-dtu-min --db-min-capacity --db-min-dtu

保證每個資料庫的最小容量（在 DTU 或虛擬核心中）。

--edition --tier -e

SKU 版本元件。 允許的值包括：Basic、Standard、進階版、GeneralPurpose、BusinessCritical。

--family -f

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

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

預設值: False
--ha-replicas --read-replicas

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

--ids

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

--maint-config-id -m

為此資源指定維護組態標識碼或名稱。

--max-size --storage

記憶體大小上限。 如果未指定任何單位，則預設為位元組 （B）。

--name -n

彈性集區的名稱。

--no-wait

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

預設值: False
--preferred-enclave-type

要為彈性集區設定的記憶體保護區類型。

接受的值: Default, VBS
--remove

從清單中移除屬性或專案。 範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

預設值: []
--resource-group -g

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

--server -s

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

--set

指定要設定的屬性路徑和值，以更新物件。 範例：--set property1.property2=<value>。

預設值: []
--subscription

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

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