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

Set-AzSqlDatabase

设置数据库的属性,或将现有数据库移到弹性池中。

语法

Set-AzSqlDatabase
   [-DatabaseName] <String>
   [-MaxSizeBytes <Int64>]
   [-Edition <String>]
   [-RequestedServiceObjectiveName <String>]
   [-ElasticPoolName <String>]
   [-ReadScale <DatabaseReadScale>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-AsJob]
   [-LicenseType <String>]
   [-ComputeModel <String>]
   [-AutoPauseDelayInMinutes <Int32>]
   [-MinimumCapacity <Double>]
   [-HighAvailabilityReplicaCount <Int32>]
   [-BackupStorageRedundancy <String>]
   [-SecondaryType <String>]
   [-MaintenanceConfigurationId <String>]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSqlDatabase
   [-DatabaseName] <String>
   [-MaxSizeBytes <Int64>]
   [-Edition <String>]
   [-ReadScale <DatabaseReadScale>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-AsJob]
   [-VCore <Int32>]
   [-ComputeGeneration <String>]
   [-LicenseType <String>]
   [-ComputeModel <String>]
   [-AutoPauseDelayInMinutes <Int32>]
   [-MinimumCapacity <Double>]
   [-HighAvailabilityReplicaCount <Int32>]
   [-BackupStorageRedundancy <String>]
   [-SecondaryType <String>]
   [-MaintenanceConfigurationId <String>]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSqlDatabase
   [-DatabaseName] <String>
   -NewName <String>
   [-AsJob]
   [-BackupStorageRedundancy <String>]
   [-SecondaryType <String>]
   [-MaintenanceConfigurationId <String>]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-AzSqlDatabase cmdlet 为 Azure SQL 数据库中的数据库设置属性。 此 cmdlet 可以修改服务层 (Edition) 、性能级别 (RequestedServiceObjectiveName) ,以及数据库 (MaxSizeBytes) 存储最大大小。 此外,还可以指定 ElasticPoolName 参数以将数据库移到弹性池中。 如果数据库已位于弹性池中,则可以使用 RequestedServiceObjectiveName 参数将数据库移出弹性池,并进入单一数据库的性能级别。

示例

示例 1:将数据库更新为标准 S0 数据库

Set-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -Edition "Standard" -RequestedServiceObjectiveName "S0"

ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
DatabaseName                  : Database01
Location                      : Central US
DatabaseId                    : a1e6bd1a-735a-4d48-8b98-afead5ef1218
Edition                       : Standard
CollationName                 : SQL_Latin1_General_CP1_CI_AS
CatalogCollation              :
MaxSizeBytes                  : 268435456000
Status                        : Online
CreationDate                  : 7/3/2015 7:33:37 AM
CurrentServiceObjectiveId     : 455330e1-00cd-488b-b5fa-177c226f28b7
CurrentServiceObjectiveName   : S0
RequestedServiceObjectiveId   : 455330e1-00cd-488b-b5fa-177c226f28b7
RequestedServiceObjectiveName :
ElasticPoolName               :
EarliestRestoreDate           :
Tags                          :

此命令将名为 Database01 的数据库更新为 Server01 服务器上的标准 S0 数据库。

示例 2:将数据库添加到弹性池

Set-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -ElasticPoolName "ElasticPool01"

ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
DatabaseName                  : Database01
Location                      : Central US
DatabaseId                    : a1e6bd1a-735a-4d48-8b98-afead5ef1218
Edition                       : Standard
CollationName                 : SQL_Latin1_General_CP1_CI_AS
CatalogCollation              :
MaxSizeBytes                  : 268435456000
Status                        : Online
CreationDate                  : 7/3/2015 7:33:37 AM
CurrentServiceObjectiveId     : d1737d22-a8ea-4de7-9bd0-33395d2a7419
CurrentServiceObjectiveName   : ElasticPool
RequestedServiceObjectiveId   : d1737d22-a8ea-4de7-9bd0-33395d2a7419
RequestedServiceObjectiveName :
ElasticPoolName               : elasticpool01
EarliestRestoreDate           :
Tags                          :

此命令将名为 Database01 的数据库添加到名为 Server01 的服务器上托管的 ElasticPool01 弹性池。

示例 3:修改数据库的存储最大大小

Set-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -MaxSizeBytes 1099511627776

ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
DatabaseName                  : Database01
Location                      : Central US
DatabaseId                    : a1e6bd1a-735a-4d48-8b98-afead5ef1218
Edition                       : Standard
CollationName                 : SQL_Latin1_General_CP1_CI_AS
CatalogCollation              :
MaxSizeBytes                  : 1099511627776
Status                        : Online
CreationDate                  : 8/24/2017 9:00:37 AM
CurrentServiceObjectiveId     : 789681b8-ca10-4eb0-bdf2-e0b050601b40
CurrentServiceObjectiveName   : S3
RequestedServiceObjectiveId   : 789681b8-ca10-4eb0-bdf2-e0b050601b40
RequestedServiceObjectiveName :
ElasticPoolName               :
EarliestRestoreDate           :
Tags                          :

此命令更新名为 Database01 的数据库,将其最大大小设置为 1 TB。

示例 4:将现有常规用途数据库更新为“超大规模”服务层级

Set-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -Edition "Hyperscale" -RequestedServiceObjectiveName "HS_Gen5_2"

ResourceGroupName             : ResourceGroup01
ServerName                    : Server01
DatabaseName                  : Database01
Location                      : Central US
DatabaseId                    : 56246136-839f-4171-80af-4c28142463b1
Edition                       : Hyperscale
CollationName                 : SQL_Latin1_General_CP1_CI_AS
CatalogCollation              :
MaxSizeBytes                  : -1
Status                        : Online
CreationDate                  : 12/6/2020 5:34:16 PM
CurrentServiceObjectiveId     : 00000000-0000-0000-0000-000000000000
CurrentServiceObjectiveName   : HS_Gen5_2
RequestedServiceObjectiveName : HS_Gen5_2
RequestedServiceObjectiveId   :
ElasticPoolName               :
EarliestRestoreDate           : 12/6/2020 5:34:16 PM
Tags                          : {}
ResourceId                    : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/servers/Server01/databases/Database01
CreateMode                    :
ReadScale                     : Enabled
ZoneRedundant                 :
Capacity                      : 2
Family                        : Gen5
SkuName                       : HS_Gen5
LicenseType                   : LicenseIncluded
AutoPauseDelayInMinutes       :
MinimumCapacity               :
ReadReplicaCount              : 1
BackupStorageRedundancy       : Geo

此命令将名为 Database01 的数据库从常规用途更新为“超大规模”服务层级。

参数

-AsJob

在后台运行 cmdlet

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AutoPauseDelayInMinutes

数据库 (无服务器) 自动暂停延迟(以分钟为单位)-1 以选择退出

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-BackupStorageRedundancy

用于存储SQL 数据库备份的备份存储冗余。 选项包括:本地、区域和地理位置。

Type:String
Accepted values:Local, Zone, Geo, GeoZone
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ComputeGeneration

要分配的计算生成。

Type:String
Aliases:Family
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ComputeModel

Azure Sql 数据库的计算模型。 无服务器或已预配

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseName

指定数据库的名称。

Type:String
Aliases:Name
Position:2
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Edition

指定数据库的版本。 此参数的可接受值为:

  • 基本
  • 标准
  • 高级
  • DataWarehouse
  • 免费
  • 拉伸
  • GeneralPurpose
  • 超大规模
  • BusinessCritical
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ElasticPoolName

指定要在其中移动数据库的弹性池的名称。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-HighAvailabilityReplicaCount

与数据库关联的只读次要副本数。 仅适用于超大规模版本。

Type:Int32
Aliases:ReadReplicaCount
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-LicenseType

Azure Sql 数据库的许可证类型。 可能的值为:

  • BasePrice - Azure 混合权益 (AHB) 现有SQL Server许可证所有者的折扣定价。 现有SQL Server许可证所有者将折扣数据库价格。
  • LicenseIncluded - 未应用现有SQL Server许可证所有者 Azure 混合权益 (的 AHB) 折扣定价。 数据库价格将包括新的SQL Server许可证成本。
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaintenanceConfigurationId

SQL 数据库的维护配置 ID。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaxSizeBytes

Azure SQL数据库的最大大小(以字节为单位)。

Type:Int64
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MinimumCapacity

数据库始终分配的最小容量(如果未暂停)。 仅适用于无服务器 Azure Sql 数据库。

Type:Double
Aliases:MinVCore, MinCapacity
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NewName

要重命名数据库的新名称。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ReadScale

如果启用,将应用程序意向设置为在其连接字符串中以只读方式设置的连接可能会路由到只读次要副本。 此属性仅适用于高级数据库和业务关键数据库。

Type:DatabaseReadScale
Accepted values:Disabled, Enabled
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RequestedServiceObjectiveName

指定要分配给数据库的服务目标的名称。 有关服务目标的信息,请参阅 Microsoft 开发人员网络库中Azure SQL数据库服务层级和性能级别

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

指定为其分配服务器的资源组的名称。

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-SecondaryType

数据库的辅助类型(如果是辅助数据库)。 有效值为 Geo 和 Named。

Type:String
Accepted values:Named, Geo
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ServerName

指定承载数据库的服务器的名称。

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Tags

以哈希表的形式的键值对。 例如:@{key0=“value0”;key1=$null;key2=“value2”}

Type:Hashtable
Aliases:Tag
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-VCore

Azure Sql 数据库的 Vcore 编号

Type:Int32
Aliases:Capacity, MaxVCore, MaxCapacity
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-ZoneRedundant

要与 Azure Sql 数据库关联的区域冗余

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

输入

String

输出

AzureSqlDatabaseModel