你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az sql db
管理数据库。
命令
az sql db copy
创建数据库的副本。
可以通过执行 az sql db list-editions -a -o table -l LOCATION
来查看性能级别选项的完整列表。 复制目标数据库必须具有与源数据库相同的版本,但可以在复制完成后更改版本。
az sql db copy --dest-name
[--assign-identity {false, true}]
[--auto-pause-delay]
[--availability-zone]
[--backup-storage-redundancy]
[--capacity]
[--compute-model {Provisioned, Serverless}]
[--dest-resource-group]
[--dest-server]
[--elastic-pool]
[--encryption-protector]
[--encryption-protector-auto-rotation {false, true}]
[--family]
[--federated-client-id]
[--ha-replicas]
[--ids]
[--keys]
[--license-type {BasePrice, LicenseIncluded}]
[--min-capacity]
[--name]
[--no-wait]
[--preferred-enclave-type {Default, VBS}]
[--read-scale {Disabled, Enabled}]
[--resource-group]
[--server]
[--service-level-objective]
[--subscription]
[--tags]
[--umi]
[--zone-redundant {false, true}]
示例
创建性能级别为 S0 的数据库作为现有标准数据库的副本。
az sql db copy -g mygroup -s myserver -n originalDb --dest-name newDb --service-objective S0
使用 GeneralPurpose 版本、Gen4 硬件和 1 个 vcore 创建数据库作为现有 GeneralPurpose 数据库的副本。
az sql db copy -g mygroup -s myserver -n originalDb --dest-name newDb -f Gen4 -c 1
创建具有本地备份存储冗余的数据库作为现有数据库的副本
az sql db copy -g mygroup -s myserver -n originalDb --dest-name newDb --backup-storage-redundancy Local
必需参数
将创建为复制目标的数据库的名称。
可选参数
为数据库分配标识。
数据库自动暂停的时间(以分钟为单位)。 -1 值表示禁用自动暂停。
可用性区域。
用于存储备份的备份存储冗余。 允许的值包括:Local、Zone、Geo、GeoZone。
SKU 的容量组件(整数数为 DTU 或 vcore)。
数据库的计算模型。
要在其中创建副本的资源组的名称。 如果未指定,则默认为源资源组。
要在其中创建副本的服务器的名称。 如果未指定,则默认为源服务器。
要在其中创建数据库的弹性池的名称或资源 ID。
指定要用作数据库加密保护程序密钥的 Azure 密钥保管库密钥。
指定数据库加密保护程序密钥自动轮换标志。 可以是 true、false 或 null。
SKU 的计算生成组件(仅适用于 vcore SKU)。 允许的值包括:Gen4、Gen5。
SQL 数据库的联合客户端 ID。 它用于跨租户 CMK 方案。
要为数据库预配的高可用性副本数。 仅适用于超大规模版本。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
SQL 数据库的 AKV 密钥列表。
要申请此数据库的许可证类型。如果需要许可证,LicenseIncluded
如果拥有许可证并且有资格使用 Azure HybridBenefit,BasePrice
。
数据库始终分配的最小容量(如果未暂停)。
Azure SQL 数据库的名称。
不要等待长时间运行的操作完成。
指定此资源的 enclave 类型。
如果启用,其连接字符串中将应用程序意向设置为只读的连接可能会路由到只读次要副本。 此属性仅适用于高级数据库和业务关键数据库。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
新数据库的服务目标。 例如:基本、S0、P1、GP_Gen4_1、GP_S_Gen5_8、BC_Gen5_2、HS_Gen5_32。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
SQL 数据库的用户分配标识列表。
指定是否启用区域冗余。 如果未指定任何值,则默认值为 true。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db create
创建数据库。
可以通过执行 az sql db list-editions -a -o table -l LOCATION
来查看性能级别选项的完整列表。
az sql db create --name
--resource-group
--server
[--assign-identity {false, true}]
[--auto-pause-delay]
[--availability-zone]
[--backup-storage-redundancy]
[--capacity]
[--catalog-collation {DATABASE_DEFAULT, SQL_Latin1_General_CP1_CI_AS}]
[--collation]
[--compute-model {Provisioned, Serverless}]
[--edition]
[--elastic-pool]
[--encryption-protector]
[--encryption-protector-auto-rotation {false, true}]
[--exhaustion-behavior {AutoPause, BillOverUsage}]
[--family]
[--federated-client-id]
[--free-limit {false, true}]
[--ha-replicas]
[--keys]
[--ledger-on {Disabled, Enabled}]
[--license-type {BasePrice, LicenseIncluded}]
[--maint-config-id]
[--max-size]
[--min-capacity]
[--no-wait]
[--preferred-enclave-type {Default, VBS}]
[--read-scale {Disabled, Enabled}]
[--sample-name {AdventureWorksLT}]
[--service-level-objective]
[--tags]
[--umi]
[--yes]
[--zone-redundant {false, true}]
示例
创建标准 S0 数据库。
az sql db create -g mygroup -s myserver -n mydb --service-objective S0
使用 GeneralPurpose 版本、Gen4 硬件和 1 个 vcore 创建数据库
az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen4 -c 1
创建启用了区域冗余的数据库
az sql db create -g mygroup -s myserver -n mydb -z
创建显式禁用区域冗余的数据库
az sql db create -g mygroup -s myserver -n mydb -z false
创建 GeneralPurpose Gen5 2 vcore 无服务器数据库,自动暂停延迟 120 分钟
az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen5 -c 2 --compute-model Serverless --auto-pause-delay 120
创建具有 2 个只读副本的超大规模 Gen5 2 vcore 数据库
az sql db create -g mygroup -s myserver -n mydb -e Hyperscale -f Gen5 -c 2 --read-replicas 2
创建具有本地冗余备份存储的 GeneralPurpose 数据库
az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose --backup-storage-redundancy Local
创建启用了 VBS enclave 的数据库。
az sql db create -g mygroup -s myserver -n mydb --preferred-enclave-type VBS
创建应用免费限制的数据库
az sql db create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen5 -c 2 --compute-model Serverless --use-free-limit --free-limit-exhaustion-behavior AutoPause
必需参数
Azure SQL 数据库的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
可选参数
为数据库分配标识。
数据库自动暂停的时间(以分钟为单位)。 -1 值表示禁用自动暂停。
可用性区域。
用于存储备份的备份存储冗余。 允许的值包括:Local、Zone、Geo、GeoZone。
SKU 的容量组件(整数数为 DTU 或 vcore)。
元数据目录的排序规则。
数据库的排序规则。
数据库的计算模型。
SKU 的版本组件。 允许的值包括:基本、标准、高级、GeneralPurpose、BusinessCritical、超大规模。
要在其中创建数据库的弹性池的名称或资源 ID。
指定要用作数据库加密保护程序密钥的 Azure 密钥保管库密钥。
指定数据库加密保护程序密钥自动轮换标志。 可以是 true、false 或 null。
指定免费数据库使用每月免费限制时的行为。AutoPause:当剩余月份的可用限制用尽时,数据库将自动暂停。BillForUsage:在耗尽免费限制后,数据库将继续联机,并会收取任何超额费用。
SKU 的计算生成组件(仅适用于 vcore SKU)。 允许的值包括:Gen4、Gen5。
SQL 数据库的联合客户端 ID。 它用于跨租户 CMK 方案。
数据库是否使用免费的每月限制。 在订阅中的一个数据库上允许。
要为数据库预配的高可用性副本数。 仅适用于超大规模版本。
SQL 数据库的 AKV 密钥列表。
创建账本数据库,其中所有数据的完整性受账本功能保护。 账本数据库中的所有表必须是账本表。 注意:创建数据库后,无法更改此属性的值。
要申请此数据库的许可证类型。如果需要许可证,LicenseIncluded
如果拥有许可证并且有资格使用 Azure HybridBenefit,BasePrice
。
为此资源指定维护配置 ID 或名称。
最大存储大小。 如果未指定单位,则默认为字节(B)。
数据库始终分配的最小容量(如果未暂停)。
不要等待长时间运行的操作完成。
指定此资源的 enclave 类型。
如果启用,其连接字符串中将应用程序意向设置为只读的连接可能会路由到只读次要副本。 此属性仅适用于高级数据库和业务关键数据库。
创建 thisdatabase 时要应用的示例架构的名称。
新数据库的服务目标。 例如:基本、S0、P1、GP_Gen4_1、GP_S_Gen5_8、BC_Gen5_2、HS_Gen5_32。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
SQL 数据库的用户分配标识列表。
不要提示确认。
指定是否启用区域冗余。 如果未指定任何值,则默认值为 true。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db delete
删除数据库。
az sql db delete [--ids]
[--name]
[--no-wait]
[--resource-group]
[--server]
[--subscription]
[--yes]
示例
删除数据库。 (自动生成)
az sql db delete --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver
可选参数
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
Azure SQL 数据库的名称。
不要等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
不要提示确认。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db export
将数据库导出到 bacpac。
az sql db export --admin-password
--admin-user
--storage-key
--storage-key-type {SharedAccessKey, StorageAccessKey}
--storage-uri
[--auth-type {ADPassword, SQL}]
[--ids]
[--name]
[--no-wait]
[--resource-group]
[--server]
[--subscription]
示例
获取用于导出操作的 SAS 密钥。
az storage blob generate-sas --account-name myAccountName -c myContainer -n myBacpac.bacpac \
--permissions rw --expiry 2018-01-01T00:00:00Z
使用 SAS 密钥导出 bacpac。
az sql db export -s myserver -n mydatabase -g mygroup -p password -u login \
--storage-key "?sr=b&sp=rw&se=2018-01-01T00%3A00%3A00Z&sig=mysignature&sv=2015-07-08" \
--storage-key-type SharedAccessKey \
--storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac
使用存储帐户密钥导出 bacpac。
az sql db export -s myserver -n mydatabase -g mygroup -p password -u login \
--storage-key MYKEY== --storage-key-type StorageAccessKey \
--storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac
必需参数
必填。 管理员登录密码。
必填。 管理员登录名。
必填。 存储密钥。
必填。 存储密钥类型。
必填。 存储 URI。
可选参数
身份验证类型。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
Azure SQL 数据库的名称。
不要等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db import
将 bacpac 导入新数据库或现有的空数据库。
az sql db import --admin-password
--admin-user
--storage-key
--storage-key-type {SharedAccessKey, StorageAccessKey}
--storage-uri
[--auth-type {ADPassword, SQL}]
[--ids]
[--name]
[--no-wait]
[--resource-group]
[--server]
[--subscription]
示例
获取用于导入操作的 SAS 密钥。
az storage blob generate-sas --account-name myAccountName -c myContainer -n myBacpac.bacpac \
--permissions rw --expiry 2018-01-01T00:00:00Z
使用 SAS 密钥将 bacpac 导入现有数据库。
az sql db import -s myserver -n mydatabase -g mygroup -p password -u login \
--storage-key "?sr=b&sp=rw&se=2018-01-01T00%3A00%3A00Z&sig=mysignature&sv=2015-07-08" \
--storage-key-type SharedAccessKey \
--storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac
使用存储帐户密钥将 bacpac 导入现有数据库。
az sql db import -s myserver -n mydatabase -g mygroup -p password -u login --storage-key MYKEY== \
--storage-key-type StorageAccessKey \
--storage-uri https://myAccountName.blob.core.windows.net/myContainer/myBacpac.bacpac
必需参数
必填。 管理员登录密码。
必填。 管理员登录名。
必填。 存储密钥。
必填。 存储密钥类型。
必填。 存储 URI。
可选参数
身份验证类型。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
Azure SQL 数据库的名称。
不要等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db list
列出服务器或弹性池上的数据库。
az sql db list [--elastic-pool]
[--ids]
[--resource-group]
[--server]
[--subscription]
示例
列出服务器或弹性池上的数据库。 (自动生成)
az sql db list --resource-group MyResourceGroup --server myserver
可选参数
如果指定,则仅列出此弹性池中的数据库。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db list-deleted
获取可还原的已删除数据库的列表。
az sql db list-deleted [--ids]
[--resource-group]
[--server]
[--subscription]
可选参数
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db list-editions
显示当前活动订阅可用的数据库版本。
包括可用的服务目标和存储限制。 为了减少详细程度,默认情况下会隐藏有意减少存储限制的设置。
az sql db list-editions --location
[--available]
[--dtu]
[--edition]
[--service-objective]
[--show-details {max-size}]
[--vcores]
示例
显示位置中的所有数据库版本。
az sql db list-editions -l westus -o table
显示标准版的所有可用数据库服务目标。
az sql db list-editions -l westus --edition Standard -o table
显示 P1 服务目标可用的最大数据库大小
az sql db list-editions -l westus --service-objective P1 --show-details max-size
必需参数
位置。 值来自:az account list-locations
。 可以使用 az configure --defaults location=<location>
配置默认位置。
可选参数
如果指定,则仅显示指定区域中可用的结果。
要搜索的 DTU 数。 如果未指定,将显示所有 DTU 大小。
要搜索的版本。 如果未指定,则显示所有版本。
要搜索的服务目标。 如果未指定,将显示所有服务目标。
要包含在输出中的其他详细信息的列表。
要搜索的 vcore 数。 如果未指定,将显示所有 vcore 大小。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db list-usages
获取数据库使用情况。
az sql db list-usages [--ids]
[--name]
[--resource-group]
[--server]
[--subscription]
可选参数
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
Azure SQL 数据库的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db rename
重命名数据库。
az sql db rename --new-name
[--ids]
[--name]
[--resource-group]
[--server]
[--subscription]
示例
重命名数据库。 (自动生成)
az sql db rename --name MyAzureSQLDatabase --new-name MyNew --resource-group MyResourceGroup --server myserver
必需参数
将数据库重命名为的新名称。
可选参数
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
Azure SQL 数据库的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db restore
通过从备份还原来创建新数据库。
az sql db restore --dest-name
[--assign-identity {false, true}]
[--auto-pause-delay]
[--availability-zone]
[--backup-storage-redundancy]
[--capacity]
[--compute-model {Provisioned, Serverless}]
[--deleted-time]
[--edition]
[--elastic-pool]
[--encryption-protector]
[--encryption-protector-auto-rotation {false, true}]
[--family]
[--federated-client-id]
[--ha-replicas]
[--ids]
[--keys]
[--license-type {BasePrice, LicenseIncluded}]
[--min-capacity]
[--name]
[--no-wait]
[--preferred-enclave-type {Default, VBS}]
[--read-scale {Disabled, Enabled}]
[--resource-group]
[--server]
[--service-level-objective]
[--subscription]
[--tags]
[--time]
[--umi]
[--zone-redundant {false, true}]
示例
通过从备份还原来创建新数据库。 (自动生成)
az sql db restore --dest-name MyDest --edition GeneralPurpose --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription --time "2018-05-20T05:34:22"
通过从备份还原,创建具有异地冗余备份存储的新数据库。 (自动生成)
az sql db restore --dest-name MyDest --edition GeneralPurpose --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription --time "2018-05-20T05:34:22" --backup-storage-redundancy Geo
必需参数
将创建为还原目标的数据库的名称。
可选参数
为数据库分配标识。
数据库自动暂停的时间(以分钟为单位)。 -1 值表示禁用自动暂停。
可用性区域。
用于存储备份的备份存储冗余。 允许的值包括:Local、Zone、Geo、GeoZone。
SKU 的容量组件(整数数为 DTU 或 vcore)。
数据库的计算模型。
如果指定,请从已删除的数据库而不是从现有数据库还原。 必须与同一服务器中删除的数据库的已删除时间匹配。 必须指定 --time 或 --deleted-time(或两者)。 时间应采用以下格式:“YYYY-MM-DDTHH:MM:SS”。
SKU 的版本组件。 允许的值包括:基本、标准、高级、GeneralPurpose、BusinessCritical、超大规模。
要在其中创建数据库的弹性池的名称或资源 ID。
指定要用作数据库加密保护程序密钥的 Azure 密钥保管库密钥。
指定数据库加密保护程序密钥自动轮换标志。 可以是 true、false 或 null。
SKU 的计算生成组件(仅适用于 vcore SKU)。 允许的值包括:Gen4、Gen5。
SQL 数据库的联合客户端 ID。 它用于跨租户 CMK 方案。
要为数据库预配的高可用性副本数。 仅适用于超大规模版本。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
SQL 数据库的 AKV 密钥列表。
要申请此数据库的许可证类型。如果需要许可证,LicenseIncluded
如果拥有许可证并且有资格使用 Azure HybridBenefit,BasePrice
。
数据库始终分配的最小容量(如果未暂停)。
Azure SQL 数据库的名称。
不要等待长时间运行的操作完成。
指定此资源的 enclave 类型。
如果启用,其连接字符串中将应用程序意向设置为只读的连接可能会路由到只读次要副本。 此属性仅适用于高级数据库和业务关键数据库。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
新数据库的服务目标。 例如:基本、S0、P1、GP_Gen4_1、GP_S_Gen5_8、BC_Gen5_2、HS_Gen5_32。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
将还原以创建新数据库的源数据库的时间点。 必须大于或等于源数据库的最早RestoreDate 值。 必须指定 --time 或 --deleted-time(或两者)。 时间应采用以下格式:“YYYY-MM-DDTHH:MM:SS”。
SQL 数据库的用户分配标识列表。
指定是否启用区域冗余。 如果未指定任何值,则默认值为 true。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db show
获取数据库的详细信息。
az sql db show [--expand-keys {false, true}]
[--ids]
[--keys-filter]
[--name]
[--resource-group]
[--server]
[--subscription]
示例
获取数据库的详细信息。 (自动生成)
az sql db show --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver
可选参数
展开数据库的 AKV 密钥。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
展开数据库的 AKV 密钥。
Azure SQL 数据库的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db show-connection-string
生成数据库的连接字符串。
az sql db show-connection-string --client {ado.net, jdbc, odbc, php, php_pdo, sqlcmd}
[--auth-type {ADIntegrated, ADPassword, SqlPassword}]
[--ids]
[--name]
[--server]
[--subscription]
示例
为 ado.net 生成连接字符串
az sql db show-connection-string -s myserver -n mydb -c ado.net
必需参数
客户端连接提供程序的类型。
可选参数
身份验证类型。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
Azure SQL 数据库的名称。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db show-deleted
获取已删除数据库的详细信息。
az sql db show-deleted --restorable-dropped-database-id
[--expand-keys {false, true}]
[--ids]
[--keys-filter]
[--resource-group]
[--server]
[--subscription]
示例
获取已删除数据库的详细信息。 (自动生成)
az sql db show-deleted --resource-group MyResourceGroup --server myserver --restorable-dropped-database-id "MyAzureSQLDatabase,133203966918270000"
必需参数
可还原的已删除数据库 ID。
可选参数
展开数据库的 AKV 密钥。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
展开数据库的 AKV 密钥。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。
az sql db update
更新数据库。
az sql db update [--add]
[--assign-identity {false, true}]
[--auto-pause-delay]
[--backup-storage-redundancy]
[--capacity]
[--compute-model {Provisioned, Serverless}]
[--edition]
[--elastic-pool]
[--encryption-protector]
[--encryption-protector-auto-rotation {false, true}]
[--exhaustion-behavior {AutoPause, BillOverUsage}]
[--family]
[--federated-client-id]
[--filter]
[--force-string]
[--free-limit {false, true}]
[--ha-replicas]
[--ids]
[--keys]
[--keys-to-remove]
[--maint-config-id]
[--manual-cutover {false, true}]
[--max-size]
[--min-capacity]
[--name]
[--no-wait]
[--perform-cutover {false, true}]
[--preferred-enclave-type {Default, VBS}]
[--read-scale {Disabled, Enabled}]
[--remove]
[--resource-group]
[--server]
[--service-objective]
[--set]
[--subscription]
[--umi]
[--zone-redundant {false, true}]
示例
通过指定 DTU 容量将数据库更新到标准版 S0 性能级别(10 DTU)。 请注意,GeneralPurpose 允许比标准版更大的最大大小范围。
az sql db update -g mygroup -s myserver -n mydb --edition Standard --capacity 10 --max-size 250GB
通过指定性能级别名称将数据库更新到标准版 S1 性能级别(20 DTU)。 请注意,GeneralPurpose 允许比标准版更大的最大大小范围。
az sql db update -g mygroup -s myserver -n mydb --edition Standard --service-objective S1 --max-size 250GB
使用 Gen5 硬件将数据库更新到 GeneralPurpose 版本、4 个 vcore
az sql db update -g mygroup -s myserver -n mydb --edition GeneralPurpose --capacity 4 --family Gen5
更新最大大小增加的数据库
az sql db update -g mygroup -s myserver -n mydb --max-size 500GB
更新启用了区域冗余的数据库
az sql db update -g mygroup -s myserver -n mydb -z
使用显式禁用区域冗余更新数据库
az sql db update -g mygroup -s myserver -n mydb -z false
将数据库更新到无服务器计算模型
az sql db update -g mygroup -s myserver -n mydb --edition GeneralPurpose --capacity 2 --family Gen5 --compute-model Serverless
使用本地冗余备份存储更新数据库
az sql db update -g mygroup -s myserver -n mydb --backup-storage-redundancy Local
使用已启用 VBS enclave 更新数据库。
az sql db update -g mygroup -s myserver -n mydb --preferred-enclave-type VBS
将免费限制数据库的耗尽行为更新为 BillOverUsage
az sql db update -g mygroup -s myserver -n mydb --free-limit-exhaustion-behavior BillOverUsage
使用手动直接转换选项将数据库更新到超大规模版本、2 个具有 Gen5 硬件的 vcore
az sql db update -g mygroup -s myserver -n mydb --edition Hyperscale --service-objective HS_Gen5_2 --manual-cutover
将数据库更新到超大规模版本时,使用执行直接转换选项触发直接转换
az sql db update -g mygroup -s myserver -n mydb --perform-cutover
可选参数
通过指定路径和键值对将对象添加到对象列表。 示例:--add property.listProperty <key=value, string or JSON string>
。
为数据库分配标识。
数据库自动暂停的时间(以分钟为单位)。 -1 值表示禁用自动暂停。
用于存储备份的备份存储冗余。 允许的值包括:Local、Zone、Geo、GeoZone。
SKU 的容量组件(整数数为 DTU 或 vcore)。
数据库的计算模型。
SKU 的版本组件。 允许的值包括:基本、标准、高级、GeneralPurpose、BusinessCritical、超大规模。
要将数据库移动到的弹性池的名称或资源 ID。
指定要用作数据库加密保护程序密钥的 Azure 密钥保管库密钥。
指定数据库加密保护程序密钥自动轮换标志。 可以是 true、false 或 null。
指定免费数据库使用每月免费限制时的行为。AutoPause:当剩余月份的可用限制用尽时,数据库将自动暂停。BillForUsage:在耗尽免费限制后,数据库将继续联机,并会收取任何超额费用。
SKU 的计算生成组件(仅适用于 vcore SKU)。 允许的值包括:Gen4、Gen5。
SQL 数据库的联合客户端 ID。 它用于跨租户 CMK 方案。
一个 OData 筛选器表达式,用于筛选集合中的元素。 默认值为 None。
使用“set”或“add”时,保留字符串文本,而不是尝试转换为 JSON。
数据库是否使用免费的每月限制。 在订阅中的一个数据库上允许。
要为数据库预配的高可用性副本数。 仅适用于超大规模版本。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
SQL 数据库的 AKV 密钥列表。
要从 SQL 数据库中删除的 AKV 键列表。
为此资源指定维护配置 ID 或名称。
是否在更新 SLO 期间执行手动直接转换。 在将数据库更新到“超大规模”层时允许。
以字节表示的数据库的新最大大小。
数据库始终分配的最小容量(如果未暂停)。
Azure SQL 数据库的名称。
不要等待长时间运行的操作完成。
在将数据库更新到“超大规模”层时是否执行直接转换。
指定此资源的 enclave 类型。
如果启用,其连接字符串中将应用程序意向设置为只读的连接可能会路由到只读次要副本。 此属性仅适用于高级数据库和业务关键数据库。
从列表中删除属性或元素。 示例:--remove property.list <indexToRemove>
或 --remove propertyToRemove
。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
Azure SQL Server 的名称。 可以使用 az configure --defaults sql-server=<name>
配置默认值。
新服务目标的名称。 如果这是独立的数据库服务目标,并且该数据库当前位于弹性池中,则会从池中删除该数据库。
通过指定要设置的属性路径和值来更新对象。 示例:--set property1.property2=<value>
。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
SQL 数据库的用户分配标识列表。
指定是否启用区域冗余。 如果未指定任何值,则默认值为 true。
全局参数
增加日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
仅显示错误,禁止显示警告。
输出格式。
JMESPath 查询字符串。 有关详细信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
增加日志记录详细程度。 对完整调试日志使用 --debug。