你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az sql elastic-pool

参考

管理弹性池。

命令

名称	说明	类型	Status
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 个 vcore 创建弹性池。

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

使用超大规模版本、Gen5 硬件、4 个 vcore 和 2 个高可用性副本 (replica)创建弹性池。

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

使用 VBS enclave 创建弹性池。

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 的名称。可以使用 < a0/a0> 配置默认值 az configure --defaults sql-server=<name>。

可选参数

--capacity --dtu -c

SKU 的容量组件（整数数为 DTU 或 vcore）。

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

任何一个数据库都可以使用的最大容量（以 DTU 或 vcore 为单位）。

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

保证每个数据库的最小容量（以 DTU 或 vcore 为单位）。

--edition --tier -e

SKU 的版本组件。允许的值包括：Basic、Standard、高级版、GeneralPurpose、BusinessCritical。

--family -f

SKU 的计算生成组件（仅适用于 vcore SKU）。允许的值包括：Gen4、Gen5。

--ha-replicas --read-replicas

要为数据库预配的高可用性副本 (replica)数。仅适用于超大规模版本。

--license-type

要申请此弹性池的许可证类型。

接受的值: BasePrice, LicenseIncluded

--maint-config-id -m

为此资源指定维护配置 ID 或名称。

--max-size --storage

最大存储大小。如果未指定单位，则默认为字节（B）。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--preferred-enclave-type

Azure SQL 弹性池的首选 enclave 类型。允许的值包括：默认值、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

订阅的名称或 ID。可以使用 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

一个或多个资源 ID（以空格分隔）。它应该是包含“资源 ID”参数的所有信息的完整资源 ID。应提供 --id 或其他“资源 ID”参数。

--name -n

弹性池的名称。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name> 配置默认组。

--server -s

Azure SQL Server 的名称。可以使用 < a0/a0> 配置默认值 az configure --defaults sql-server=<name>。

--subscription

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 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

一个或多个资源 ID（以空格分隔）。它应该是包含“资源 ID”参数的所有信息的完整资源 ID。应提供 --id 或其他“资源 ID”参数。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name> 配置默认组。

--server -s

Azure SQL Server 的名称。可以使用 < a0/a0> 配置默认值 az configure --defaults sql-server=<name>。

--skip

要跳过的集合中的元素数。默认值为 None。

--subscription

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 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

一个或多个资源 ID（以空格分隔）。它应该是包含“资源 ID”参数的所有信息的完整资源 ID。应提供 --id 或其他“资源 ID”参数。

--name -n

弹性池的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name> 配置默认组。

--server -s

Azure SQL Server 的名称。可以使用 < a0/a0> 配置默认值 az configure --defaults sql-server=<name>。

--subscription

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 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

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

要搜索的 vcore 数。如果未指定，将显示所有 vcore 大小。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 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

一个或多个资源 ID（以空格分隔）。它应该是包含“资源 ID”参数的所有信息的完整资源 ID。应提供 --id 或其他“资源 ID”参数。

--name -n

弹性池的名称。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name> 配置默认组。

--server -s

Azure SQL Server 的名称。可以使用 < a0/a0> 配置默认值 az configure --defaults sql-server=<name>。

--subscription

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 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 个高可用性副本 (replica)更新弹性池

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

使用 VBS enclave 更新弹性池

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 或 vcore）。

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

任何一个数据库都可以使用的最大容量（以 DTU 或 vcore 为单位）。

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

保证每个数据库的最小容量（以 DTU 或 vcore 为单位）。

--edition --tier -e

SKU 的版本组件。允许的值包括：Basic、Standard、高级版、GeneralPurpose、BusinessCritical。

--family -f

SKU 的计算生成组件（仅适用于 vcore SKU）。允许的值包括：Gen4、Gen5。

--force-string

使用“set”或“add”时，保留字符串文本，而不是尝试转换为 JSON。

默认值: False

--ha-replicas --read-replicas

要为数据库预配的高可用性副本 (replica)数。仅适用于超大规模版本。

--ids

一个或多个资源 ID（以空格分隔）。它应该是包含“资源 ID”参数的所有信息的完整资源 ID。应提供 --id 或其他“资源 ID”参数。

--maint-config-id -m

为此资源指定维护配置 ID 或名称。

--max-size --storage

最大存储大小。如果未指定单位，则默认为字节（B）。

--name -n

弹性池的名称。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--preferred-enclave-type

要为弹性池配置的 enclave 类型。

接受的值: Default, VBS

--remove

从列表中删除属性或元素。示例： --remove property.list <indexToRemove> OR --remove propertyToRemove.

默认值: []

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name> 配置默认组。

--server -s

Azure SQL Server 的名称。可以使用 < a0/a0> 配置默认值 az configure --defaults sql-server=<name>。

--set

通过指定要设置的属性路径和值来更新对象。示例：--set property1.property2=<value>。

默认值: []

--subscription

订阅的名称或 ID。可以使用 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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

通过

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

示例

可选参数

其他资源