İngilizce dilinde oku

Aracılığıyla paylaş

Set-AzSqlDatabase

  • Başvuru
Modül:
Az.Sql

Bir veritabanının özelliklerini ayarlar veya var olan bir veritabanını elastik havuza taşır.

Sözdizimi

PowerShell 
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>]
   [-AssignIdentity]
   [-EncryptionProtector <String>]
   [-UserAssignedIdentityId <String[]>]
   [-KeyList <String[]>]
   [-KeysToRemove <String[]>]
   [-FederatedClientId <Guid>]
   [-PreferredEnclaveType <String>]
   [-EncryptionProtectorAutoRotation]
   [-UseFreeLimit]
   [-FreeLimitExhaustionBehavior <String>]
   [-ManualCutover]
   [-PerformCutover]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
PowerShell 
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>]
   [-AssignIdentity]
   [-EncryptionProtector <String>]
   [-UserAssignedIdentityId <String[]>]
   [-KeyList <String[]>]
   [-KeysToRemove <String[]>]
   [-FederatedClientId <Guid>]
   [-PreferredEnclaveType <String>]
   [-EncryptionProtectorAutoRotation]
   [-UseFreeLimit]
   [-FreeLimitExhaustionBehavior <String>]
   [-ManualCutover]
   [-PerformCutover]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
PowerShell 
Set-AzSqlDatabase
   [-DatabaseName] <String>
   -NewName <String>
   [-AsJob]
   [-BackupStorageRedundancy <String>]
   [-SecondaryType <String>]
   [-MaintenanceConfigurationId <String>]
   [-AssignIdentity]
   [-EncryptionProtector <String>]
   [-UserAssignedIdentityId <String[]>]
   [-KeyList <String[]>]
   [-KeysToRemove <String[]>]
   [-FederatedClientId <Guid>]
   [-PreferredEnclaveType <String>]
   [-EncryptionProtectorAutoRotation]
   [-UseFreeLimit]
   [-FreeLimitExhaustionBehavior <String>]
   [-ManualCutover]
   [-PerformCutover]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzSqlDatabase cmdlet'i, Azure SQL Veritabanı'ndaki bir veritabanının özelliklerini ayarlar. Bu cmdlet, veritabanı için hizmet katmanını (Edition), performans düzeyini (RequestedServiceObjectiveName) ve depolama üst boyutunu (MaxSizeBytes) değiştirebilir. Ayrıca, veritabanını elastik havuza taşımak için ElasticPoolName parametresini belirtebilirsiniz. Veritabanı zaten bir elastik havuzdaysa, veritabanını elastik havuzun dışına ve tek veritabanlarının performans düzeyine taşımak için RequestedServiceObjectiveName parametresini kullanabilirsiniz.

Örnekler

Örnek 1: Veritabanını Standart S0 veritabanına güncelleştirme

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

Bu komut, Database01 adlı veritabanını Server01 adlı bir sunucudaki Standart S0 veritabanına güncelleştirir.

Örnek 2: Elastik havuza veritabanı ekleme

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

Bu komut, Server01 adlı sunucuda barındırılan ElasticPool01 adlı elastik havuza Database01 adlı bir veritabanı ekler.

Örnek 3: Veritabanının en büyük depolama boyutunu değiştirme

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

Bu komut, Veritabanı01 adlı veritabanını en büyük boyutunu 1 TB olarak ayarlamak için güncelleştirir.

Örnek 4: Mevcut Genel Amaçlı veritabanını Hiper Ölçek hizmet katmanına güncelleştirme

PowerShell 
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

Bu komut, Genel Amaçlı olan Database01 adlı veritabanını Hiper Ölçek hizmet katmanına güncelleştirir.

Örnek 5: Veritabanının tercih edilen kapanım türünü VBS olarak güncelleştirme

PowerShell 
Set-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -PreferredEnclaveType "VBS"

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
PreferredEnclaveType          : VBS
RequestedServiceObjectiveName :
ElasticPoolName               :
EarliestRestoreDate           :
Tags                          :

Bu komut, veritabanını vbs kapanımını yapılandıracak şekilde güncelleştirir

Parametreler

-AsJob

Cmdlet'i arka planda çalıştırma

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-AssignIdentity

Azure KeyVault gibi anahtar yönetimi hizmetleriyle kullanmak üzere bu veritabanı için bir Microsoft Entra kimliği oluşturun ve atayın.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-AutoPauseDelayInMinutes

Veritabanının (yalnızca sunucusuz) -1 devre dışı bırakması için dakika cinsinden otomatik duraklatma gecikmesi

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-BackupStorageRedundancy

SQL Veritabanı için yedeklemeleri depolamak için kullanılan Yedekleme depolama yedekliliği. Seçenekler şunlardır: Yerel, Bölge, Coğrafi ve Coğrafi Bölge. Veritabanının her sürümü tarafından desteklenen seçenekleri öğrenmek için bkz. get-AzSqlCapability .

Tür:String
Kabul edilen değerler:Local, Zone, Geo, GeoZone
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ComputeGeneration

Atanacak işlem oluşturma.

Tür:String
Diğer adlar:Family
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ComputeModel

Azure Sql veritabanının hesaplanan modeli. Sunucusuz veya Sağlanmış

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DatabaseName

Veritabanının adını belirtir.

Tür:String
Diğer adlar:Name
Position:2
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Edition

Veritabanının sürümünü belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

  • Hiç kimse
  • Temel
  • Standart
  • Premium
  • DataWarehouse
  • Serbest
  • Uzatmak
  • GeneralPurpose
  • Hiper Ölçek
  • businesscritical
Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ElasticPoolName

Veritabanının taşındığı elastik havuzun adını belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-EncryptionProtector

SQL Veritabanı için şifreleme koruyucu anahtarı.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-EncryptionProtectorAutoRotation

AKV Anahtarı Otomatik Döndürme durumu

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-FederatedClientId

SQL Veritabanı için federasyon istemci kimliği. Kiracılar arası CMK senaryosu için kullanılır.

Tür:Nullable<T>[Guid]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-FreeLimitExhaustionBehavior

Serbest sınır veritabanının tükenme davranışı.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HighAvailabilityReplicaCount

Veritabanıyla ilişkilendirilmiş salt okunur ikincil çoğaltmaların sayısı. Yalnızca Hiper Ölçek sürümü için.

Tür:Int32
Diğer adlar:ReadReplicaCount
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-KeyList

SQL Veritabanı için AKV anahtarlarının listesi.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-KeysToRemove

SQL Veritabanından kaldırılacak AKV anahtarlarının listesi.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-LicenseType

Azure Sql veritabanının lisans türü. Olası değerler şunlardır:

  • BasePrice - Mevcut SQL Server lisans sahipleri için Azure Hibrit Avantajı (AHB) indirimli fiyatlandırması uygulanır. Mevcut SQL Server lisans sahipleri için veritabanı fiyatına indirim uygulanır.
  • LicenseIncluded - Mevcut SQL Server lisans sahipleri için Azure Hibrit Avantajı (AHB) indirim fiyatlandırması uygulanmaz. Veritabanı fiyatına yeni bir SQL Server lisans maliyetleri eklenecektir.
Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MaintenanceConfigurationId

SQL Veritabanı için Bakım yapılandırma kimliği.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ManualCutover

Hiper Ölçek'e geçiş için El ile Tam Geçiş'i kullanın.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MaxSizeBytes

Azure SQL Veritabanı'nın bayt cinsinden boyut üst sınırı.

Tür:Int64
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MinimumCapacity

Duraklatılmadıysa veritabanının her zaman ayırdığı En Düşük kapasite. Yalnızca sunucusuz Azure Sql veritabanları için.

Tür:Double
Diğer adlar:MinVCore, MinCapacity
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-NewName

Veritabanını yeniden adlandıracak yeni ad.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PerformCutover

Hiper Ölçek'e geçiş için Tam Geçişi tetikleme.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PreferredEnclaveType

Azure Sql veritabanı için tercih edilen kapanım türü. Olası değerler Varsayılan ve VBS'dir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ReadScale

Etkinleştirilirse, bağlantı dizelerinde uygulama amacı salt okunur olarak ayarlanmış bağlantılar salt okunur ikincil çoğaltmaya yönlendirilebilir. Bu özellik yalnızca Premium ve İş Açısından Kritik veritabanları için ayarlanabilir.

Tür:DatabaseReadScale
Kabul edilen değerler:Disabled, Enabled
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RequestedServiceObjectiveName

Veritabanına atanacak hizmet hedefinin adını belirtir. Hizmet hedefleri hakkında bilgi için bkz. Microsoft Geliştirici Ağ Kitaplığı'nda Azure SQL Veritabanı Hizmet Katmanları ve Performans Düzeyleri .

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ResourceGroupName

Sunucunun atandığı kaynak grubunun adını belirtir.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-SecondaryType

İkincil bir veritabanıysa veritabanının ikincil türü. Geçerli değerler Coğrafi ve Adlandırılmış değerlerdir.

Tür:String
Kabul edilen değerler:Named, Geo
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ServerName

Veritabanını barındıran sunucunun adını belirtir.

Tür:String
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Tags

Karma tablo biçiminde anahtar-değer çiftleri. Örneğin: @{key0="value0"; key1=$null; key2="value2"}

Tür:Hashtable
Diğer adlar:Tag
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UseFreeLimit

Bu veritabanında ücretsiz sınır kullan.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UserAssignedIdentityId

SQL Veritabanı için kullanıcı tarafından atanan kimliğin listesi.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-VCore

Azure Sql veritabanı için sanal çekirdek numarası

Tür:Int32
Diğer adlar:Capacity, MaxVCore, MaxCapacity
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ZoneRedundant

Azure Sql Veritabanı ile ilişkilendirilecek bölge yedekliliği

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

Çıkışlar