Set-AzSqlDatabase

Ustawia właściwości bazy danych lub przenosi istniejącą bazę danych do elastycznej puli.

Składnia

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>]

Opis

Polecenie cmdlet Set-AzSqlDatabase ustawia właściwości bazy danych w usłudze Azure SQL Database. To polecenie cmdlet może modyfikować warstwę usługi (Edition), poziom wydajności (RequestedServiceObjectiveName) i maksymalny rozmiar magazynu (MaxSizeBytes) dla bazy danych. Ponadto można określić parametr ElasticPoolName , aby przenieść bazę danych do puli elastycznej. Jeśli baza danych znajduje się już w elastycznej puli, możesz użyć parametru RequestedServiceObjectiveName , aby przenieść bazę danych z elastycznej puli i na poziom wydajności dla pojedynczych baz danych.

Przykłady

Przykład 1. Aktualizowanie bazy danych do standardowej bazy danych 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                          :

To polecenie aktualizuje bazę danych o nazwie Database01 do standardowej bazy danych S0 na serwerze o nazwie Server01.

Przykład 2. Dodawanie bazy danych do elastycznej puli

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                          :

To polecenie dodaje bazę danych o nazwie Database01 do elastycznej puli o nazwie ElasticPool01 hostowanej na serwerze o nazwie Server01.

Przykład 3. Modyfikowanie maksymalnego rozmiaru magazynu bazy danych

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                          :

To polecenie aktualizuje bazę danych o nazwie Database01, aby ustawić maksymalny rozmiar na 1 TB.

Przykład 4. Aktualizowanie istniejącej bazy danych Ogólnego przeznaczenia do warstwy usługi Hiperskala

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

To polecenie aktualizuje bazę danych o nazwie Database01 z Ogólnego przeznaczenia do warstwy usługi Hiperskala.

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

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

-AutoPauseDelayInMinutes

Opóźnienie automatycznego wstrzymania w minutach dla bazy danych (tylko bezserwerowe), -1, aby zrezygnować

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

-BackupStorageRedundancy

Nadmiarowość magazynu kopii zapasowej używana do przechowywania kopii zapasowych dla SQL Database. Opcje to: Lokalne, Strefy i Geo.

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

-ComputeGeneration

Generowanie zasobów obliczeniowych do przypisania.

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

-ComputeModel

Obliczony model bazy danych Azure Sql Database. Bezserwerowe lub aprowizowane

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-DatabaseName

Określa nazwę bazy danych.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

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

-Edition

Określa edycję bazy danych. Dopuszczalne wartości dla tego parametru to:

  • Brak
  • Podstawowa
  • Standardowa (Standard)
  • Premium
  • DataWarehouse
  • Bezpłatna
  • Stretch
  • OgólnePurpose
  • Hiperskala
  • Analiza biznesowa
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ElasticPoolName

Określa nazwę elastycznej puli, w której ma być przeniesiona baza danych.

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

-HighAvailabilityReplicaCount

Liczba replik pomocniczych do odczytu skojarzonych z bazą danych. Tylko w przypadku wersji Hiperskala.

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

-LicenseType

Typ licencji dla bazy danych Azure Sql Database. Możliwe wartości:

  • BasePrice — ceny Korzyść użycia hybrydowego platformy Azure (AHB) z rabatem dla istniejących właścicieli licencji SQL Server są stosowane. Cena bazy danych zostanie obniżona dla istniejących właścicieli licencji SQL Server.
  • LicenseIncluded — ceny rabatu Korzyść użycia hybrydowego platformy Azure (AHB) dla istniejących właścicieli licencji SQL Server nie są stosowane. Cena bazy danych będzie obejmować nowe koszty licencji SQL Server.
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaintenanceConfigurationId

Identyfikator konfiguracji konserwacji dla SQL Database.

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

-MaxSizeBytes

Maksymalny rozmiar bazy danych Azure SQL w bajtach.

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

-MinimumCapacity

Minimalna pojemność, którą baza danych będzie zawsze przydzielana, jeśli nie zostanie wstrzymana. Tylko w przypadku bezserwerowych baz danych Azure Sql Database.

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

-NewName

Nowa nazwa, która ma zmienić nazwę bazy danych na.

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

-ReadScale

W przypadku włączenia połączeń, które mają ustawioną intencję aplikacji na odczyt w parametrach połączenia, mogą być kierowane do repliki pomocniczej tylko do odczytu. Ta właściwość jest ustawiana tylko dla baz danych Premium i Krytyczne dla działania firmy.

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

-RequestedServiceObjectiveName

Określa nazwę celu usługi do przypisania do bazy danych. Aby uzyskać informacje na temat celów usługi, zobacz Azure SQL Warstwy usług bazy danych i poziomy wydajności w bibliotece sieci deweloperów firmy Microsoft.

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

-ResourceGroupName

Określa nazwę grupy zasobów, do której jest przypisany serwer.

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

-SecondaryType

Pomocniczy typ bazy danych, jeśli jest pomocniczy. Prawidłowe wartości to Geo i Nazwane.

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

-ServerName

Określa nazwę serwera, który hostuje bazę danych.

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

-Tags

Pary klucz-wartość w postaci tabeli skrótów. Na przykład: @{key0="value0";key1=$null;key2="value2"}

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

-VCore

Numer rdzeni wirtualnych bazy danych Azure Sql Database

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

-ZoneRedundant

Nadmiarowość strefy do skojarzenia z usługą Azure Sql Database

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

Dane wejściowe

String

Dane wyjściowe

AzureSqlDatabaseModel