Set-AzSqlDatabase
Bir veritabanının özelliklerini ayarlar veya var olan bir veritabanını elastik havuza taşır.
Syntax
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>]
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>]
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ı bir veritabanının özelliklerini ayarlar. Bu cmdlet, veritabanı için hizmet katmanını (Sürüm), performans düzeyini (RequestedServiceObjectiveName) ve depolama maksimum boyutunu (MaxSizeBytes) değiştirebilir. Ayrıca, bir 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ı için performans düzeyine taşımak için RequestedServiceObjectiveName parametresini kullanabilirsiniz.
Örnekler
Örnek 1: Veritabanını Standart S0 veritabanına güncelleştirme
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
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
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
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
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 |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoPauseDelayInMinutes
Veritabanının (yalnızca sunucusuz), -1'in geri çevirmesi için dakika cinsinden otomatik duraklatma gecikmesi
Tür: | Int32 |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackupStorageRedundancy
SQL Veritabanı yedeklemelerini 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 |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputeGeneration
Atanacak işlem oluşturma.
Tür: | String |
Aliases: | Family |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputeModel
Azure Sql veritabanının hesaplanan modeli. Sunucusuz veya Sağlanmış
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Tür: | SwitchParameter |
Aliases: | cf |
Position: | Named |
varsayılan değer: | False |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatabaseName
Veritabanının adını belirtir.
Tür: | String |
Aliases: | Name |
Position: | 2 |
varsayılan değer: | None |
Gerekli: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik
Tür: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Edition
Veritabanının sürümünü belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
- Hiçbiri
- Temel
- Standart
- Premium
- DataWarehouse
- Ücretsiz
- Uzat
- GeneralPurpose
- Hiper Ölçek
- businesscritical
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ElasticPoolName
Veritabanının taşındığı elastik havuzun adını belirtir.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptionProtector
SQL Veritabanı için şifreleme koruyucu anahtarı.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptionProtectorAutoRotation
AKV Anahtarı Otomatik Döndürme durumu
Tür: | SwitchParameter |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FreeLimitExhaustionBehavior
Serbest sınır veritabanının tükenme davranışı.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | ReadReplicaCount |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KeyList
SQL Veritabanı için AKV anahtarlarının listesi.
Tür: | String[] |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KeysToRemove
SQL Veritabanı kaldırılacak AKV anahtarlarının listesi.
Tür: | String[] |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaintenanceConfigurationId
SQL Veritabanı için Bakım yapılandırma kimliği.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ManualCutover
Hiper Ölçek'e geçiş için El ile Tam Geçiş'i kullanın.
Tür: | SwitchParameter |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxSizeBytes
bayt cinsinden en büyük Azure SQL Veritabanı boyutu.
Tür: | Int64 |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | MinVCore, MinCapacity |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
Veritabanını yeniden adlandıracak yeni ad.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PerformCutover
Hiper Ölçek'e geçiş için Tam Geçişi tetikleme.
Tür: | SwitchParameter |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReadScale
Etkinleştirilirse, uygulama amacı kendi bağlantı dizesi 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 |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequestedServiceObjectiveName
Veritabanına atanacak hizmet hedefinin adını belirtir. Hizmet hedefleri hakkında bilgi için bkz. Microsoft Geliştirici Ağ Kitaplığı'nda hizmet katmanları ve performans düzeyleri Azure SQL Veritabanı.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Sunucunun atandığı kaynak grubunun adını belirtir.
Tür: | String |
Position: | 0 |
varsayılan değer: | None |
Gerekli: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerName
Veritabanını barındıran sunucunun adını belirtir.
Tür: | String |
Position: | 1 |
varsayılan değer: | None |
Gerekli: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tags
Karma tablo biçiminde anahtar-değer çiftleri. Örneğin: @{key0="value0"; key1=$null; key2="value2"}
Tür: | Hashtable |
Aliases: | Tag |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseFreeLimit
Bu veritabanında ücretsiz sınır kullan.
Tür: | SwitchParameter |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserAssignedIdentityId
SQL Veritabanı için kullanıcı tarafından atanan kimliğin listesi.
Tür: | String[] |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VCore
Azure Sql veritabanı için sanal çekirdek numarası
Tür: | Int32 |
Aliases: | Capacity, MaxVCore, MaxCapacity |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Tür: | SwitchParameter |
Aliases: | wi |
Position: | Named |
varsayılan değer: | False |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ZoneRedundant
Azure Sql Veritabanı ile ilişkilendirilecek bölge yedekliliği
Tür: | SwitchParameter |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Girişler
Çıkışlar
İlişkili Bağlantılar
Azure PowerShell
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin