az sql elastic-pool

管理彈性集區。

命令

名稱	Description	類型	狀態
az sql elastic-pool create	建立彈性集區。	Core	GA
az sql elastic-pool delete	刪除彈性集區。	Core	GA
az sql elastic-pool list	取得伺服器中的所有彈性集區。	Core	GA
az sql elastic-pool list-dbs	取得彈性集區中的資料庫清單。	Core	GA
az sql elastic-pool list-editions	列出作用中訂用帳戶可用的彈性集區版本。	Core	GA
az sql elastic-pool op	管理彈性集區上的作業。	Core	GA
az sql elastic-pool op cancel	取消彈性集區上的異步作。	Core	GA
az sql elastic-pool op list	取得在彈性集區上執行的作業清單。	Core	GA
az sql elastic-pool show	取得彈性集區。	Core	GA
az sql elastic-pool update	更新彈性集區。	Core	GA

az sql elastic-pool create

編輯

建立彈性集區。

az sql elastic-pool create --name
                           --resource-group
                           --server
                           [--capacity --dtu]
                           [--db-dtu-max --db-max-capacity --db-max-dtu]
                           [--db-dtu-min --db-min-capacity --db-min-dtu]
                           [--edition --tier]
                           [--family]
                           [--ha-replicas --read-replicas]
                           [--license-type {BasePrice, LicenseIncluded}]
                           [--maint-config-id]
                           [--max-size --storage]
                           [--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 或虛擬核心為單位。

屬性	值
參數群組:	Performance Level (components) Arguments

--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、Premium、GeneralPurpose、BusinessCritical。

屬性	值
參數群組:	Performance Level (components) Arguments

--family -f

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

屬性	值
參數群組:	Performance Level (components) Arguments

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

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	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 elastic-pool delete

編輯

刪除彈性集區。

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

選擇性參數

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

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--name -n

彈性集區的名稱。

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

屬性	值
預設值:	False

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--server -s

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

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

屬性	值
預設值:	False

az sql elastic-pool list

編輯

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

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

選擇性參數

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

--ids

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--server -s

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

屬性	值
參數群組:	Resource Id Arguments

--skip

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

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

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

屬性	值
預設值:	False

az sql elastic-pool list-dbs

編輯

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

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

選擇性參數

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

--ids

屬性	值
參數群組:	Resource Id Arguments

--name -n

彈性集區的名稱。

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--server -s

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

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

屬性	值
預設值:	False

az sql elastic-pool list-editions

編輯

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

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

az sql elastic-pool list-editions --location
                                  [--available]
                                  [--dtu]
                                  [--edition --tier]
                                  [--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

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

選擇性參數

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

--available -a

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

屬性	值
預設值:	False

--dtu

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

屬性	值
參數群組:	Search Arguments

--edition --tier -e

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

屬性	值
參數群組:	Search Arguments

--show-details -d

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

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

--vcores

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

屬性	值
參數群組:	Search 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 elastic-pool show

編輯

取得彈性集區。

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

選擇性參數

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

--ids

屬性	值
參數群組:	Resource Id Arguments

--name -n

彈性集區的名稱。

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--server -s

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

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

屬性	值
預設值:	False

az sql elastic-pool update

編輯

更新彈性集區。

az sql elastic-pool update [--add]
                           [--capacity --dtu]
                           [--db-dtu-max --db-max-capacity --db-max-dtu]
                           [--db-dtu-min --db-min-capacity --db-min-dtu]
                           [--edition --tier]
                           [--family]
                           [--force-string]
                           [--ha-replicas --read-replicas]
                           [--ids]
                           [--maint-config-id]
                           [--max-size --storage]
                           [--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>.

屬性	值
參數群組:	Generic Update Arguments
預設值:	[]

--capacity --dtu -c

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

屬性	值
參數群組:	Performance Level (components) Arguments

--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、Premium、GeneralPurpose、BusinessCritical。

屬性	值
參數群組:	Performance Level (components) Arguments

--family -f

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

屬性	值
參數群組:	Performance Level (components) Arguments

--force-string

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

屬性	值
參數群組:	Generic Update Arguments
預設值:	False

--ha-replicas --read-replicas

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

--ids

屬性	值
參數群組:	Resource Id Arguments

--maint-config-id -m

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

--max-size --storage

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

--name -n

彈性集區的名稱。

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

屬性	值
預設值:	False

--preferred-enclave-type

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

屬性	值
接受的值:	Default, VBS

--remove

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

屬性	值
參數群組:	Generic Update Arguments
預設值:	[]

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--server -s

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

屬性	值
參數群組:	Resource Id Arguments

--set

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

屬性	值
參數群組:	Generic Update Arguments
預設值:	[]

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--zone-redundant -z

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

屬性	值
接受的值:	false, true

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--verbose

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

屬性	值
預設值:	False

意見反應

此頁面對您有幫助嗎？

共用方式為

az sql elastic-pool

命令

az sql elastic-pool create

範例

必要參數

選擇性參數

az sql elastic-pool delete

選擇性參數

az sql elastic-pool list

選擇性參數

az sql elastic-pool list-dbs

選擇性參數

az sql elastic-pool list-editions

範例

必要參數

選擇性參數

az sql elastic-pool show

選擇性參數

az sql elastic-pool update

範例

選擇性參數

意見反應