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

az sql elastic-pool

管理弹性池。

命令

名称 说明 类型 状态
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 获取完整的调试日志。