Databases - Update

Aktualizuje istniejącą bazę danych.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}?api-version=2014-04-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
databaseName
path True

string

Nazwa bazy danych do zaktualizowania.

resourceGroupName
path True

string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.

serverName
path True

string

Nazwa serwera.

subscriptionId
path True

string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.

api-version
query True

string

Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa Typ Opis
parameters

DatabaseUpdate

Wymagane parametry do aktualizowania bazy danych.

Odpowiedzi

Nazwa Typ Opis
200 OK

Database

OK

202 Accepted

Zaakceptowano

Przykłady

Update a database max
Update a database min

Update a database max

Przykładowe żądanie

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-5961/databases/testdb?api-version=2014-04-01

{
  "properties": {
    "edition": "Standard",
    "status": "Online",
    "createMode": "Default",
    "serviceLevelObjective": "S0",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": "268435456000",
    "currentServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "Japan West",
    "earliestRestoreDate": "2017-02-10T01:52:52.923Z",
    "containmentState": 2,
    "readScale": "Disabled"
  }
}

Przykładowa odpowiedź

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-5961/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases",
  "location": "Japan East",
  "kind": "v12.0,user",
  "properties": {
    "edition": "Standard",
    "status": "Online",
    "serviceLevelObjective": "S0",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-02-24T22:39:46.547Z",
    "maxSizeBytes": "268435456000",
    "currentServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveName": "S0",
    "sampleName": null,
    "defaultSecondaryLocation": "Japan West",
    "earliestRestoreDate": "2017-02-10T01:52:52.923Z",
    "elasticPoolName": null,
    "containmentState": 2,
    "readScale": "Disabled",
    "failoverGroupId": null
  }
}

Update a database min

Przykładowe żądanie

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-5961/databases/testdb?api-version=2014-04-01

{}

Przykładowa odpowiedź

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-5961/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases",
  "location": "Japan East",
  "kind": "v12.0,user",
  "properties": {
    "edition": "Standard",
    "status": "Online",
    "serviceLevelObjective": "S0",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-02-24T22:39:46.547Z",
    "maxSizeBytes": "268435456000",
    "currentServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveName": "S0",
    "sampleName": null,
    "defaultSecondaryLocation": "Japan West",
    "earliestRestoreDate": "2017-02-10T01:52:52.923Z",
    "elasticPoolName": null,
    "containmentState": 2,
    "readScale": "Disabled",
    "failoverGroupId": null
  }
}

Definicje

Nazwa Opis
CreateMode

Określa tryb tworzenia bazy danych.

Ustawienie domyślne: regularne tworzenie bazy danych.

Kopiowanie: tworzy bazę danych jako kopię istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu źródłowej bazy danych.

OnlineSecondary/NonReadableSecondary: tworzy bazę danych jako replikę pomocniczą (czytelną lub nieczytelną) istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych.

PointInTimeRestore: tworzy bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a element restorePointInTime musi być określony.

Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId musi być określony jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić.

Przywracanie: tworzy bazę danych, przywracając kopię zapasową usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem usuniętej bazy danych, a parametr sourceDatabaseDeletionDate jest ignorowany. Można również określić element restorePointInTime w celu przywrócenia z wcześniejszego punktu w czasie.

RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu przechowywania długoterminowego. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania.

Kopiowanie, NonReadableSecondary, OnlineSecondary i RestoreLongTermRetentionBackup nie są obsługiwane w przypadku wersji DataWarehouse.

Database

Reprezentuje bazę danych.

DatabaseEdition

Wydanie bazy danych. Wyliczenie DatabaseEditions zawiera wszystkie prawidłowe wersje. Jeśli parametr createMode to NonReadableSecondary lub OnlineSecondary, ta wartość jest ignorowana.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST Capabilities_ListByLocation lub jednego z następujących poleceń:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
DatabaseUpdate

Wymagane parametry do aktualizowania bazy danych.

OperationImpact

Szacowany wpływ wykonania zalecanej akcji indeksu.

ReadScale

Warunkowy. Jeśli baza danych jest pomocniczym obszarem geograficznym, funkcja readScale wskazuje, czy połączenia tylko do odczytu mogą być dozwolone dla tej bazy danych, czy nie. Nieobsługiwane w przypadku wersji DataWarehouse.

RecommendedIndex

Zalecane indeksy dla tej bazy danych.

RecommendedIndexAction

Proponowana akcja indeksu. Możesz utworzyć brakujący indeks, usunąć nieużywany indeks lub ponownie skompilować istniejący indeks, aby poprawić jego wydajność.

RecommendedIndexState

Bieżący stan zalecenia.

RecommendedIndexType

Typ indeksu (CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)

SampleName

Wskazuje nazwę przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych. Jeśli tryb createMode nie jest domyślny, ta wartość jest ignorowana. Nieobsługiwane w przypadku wersji DataWarehouse.

ServiceObjectiveName

Nazwa skonfigurowanego celu poziomu usługi bazy danych. Jest to cel poziomu usługi, który jest w trakcie stosowania do bazy danych. Po pomyślnym zaktualizowaniu będzie ona zgodna z wartością właściwości serviceLevelObjective.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST Capabilities_ListByLocation lub jednego z następujących poleceń:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
ServiceTierAdvisor

Lista doradców warstwy usług dla tej bazy danych. Rozwinięta właściwość

SloUsageMetric

Pobiera lub ustawia parametr serviceLevelObjectiveUsageMetrics dla klasyfikatora warstwy usług.

TransparentDataEncryption

Informacje o przezroczystym szyfrowaniu danych dla tej bazy danych.

TransparentDataEncryptionStatus

Stan przezroczystego szyfrowania danych bazy danych.

CreateMode

Określa tryb tworzenia bazy danych.

Ustawienie domyślne: regularne tworzenie bazy danych.

Kopiowanie: tworzy bazę danych jako kopię istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu źródłowej bazy danych.

OnlineSecondary/NonReadableSecondary: tworzy bazę danych jako replikę pomocniczą (czytelną lub nieczytelną) istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych.

PointInTimeRestore: tworzy bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a element restorePointInTime musi być określony.

Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId musi być określony jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić.

Przywracanie: tworzy bazę danych, przywracając kopię zapasową usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem usuniętej bazy danych, a parametr sourceDatabaseDeletionDate jest ignorowany. Można również określić element restorePointInTime w celu przywrócenia z wcześniejszego punktu w czasie.

RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu przechowywania długoterminowego. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania.

Kopiowanie, NonReadableSecondary, OnlineSecondary i RestoreLongTermRetentionBackup nie są obsługiwane w przypadku wersji DataWarehouse.

Wartość Opis
Copy
Default
NonReadableSecondary
OnlineSecondary
PointInTimeRestore
Recovery
Restore
RestoreLongTermRetentionBackup

Database

Reprezentuje bazę danych.

Nazwa Typ Opis
id

string

Identyfikator zasobu.

kind

string

Rodzaj bazy danych. Są to metadane używane w środowisku witryny Azure Portal.

location

string

Lokalizacja zasobu.

name

string

Nazwa zasobu.

properties.collation

string

Sortowanie bazy danych. Jeśli tryb createMode nie jest domyślny, ta wartość jest ignorowana.

properties.containmentState

integer (int64)

Stan zawierania bazy danych.

properties.createMode

CreateMode

Określa tryb tworzenia bazy danych.

Ustawienie domyślne: regularne tworzenie bazy danych.

Kopiowanie: tworzy bazę danych jako kopię istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu źródłowej bazy danych.

OnlineSecondary/NonReadableSecondary: tworzy bazę danych jako replikę pomocniczą (czytelną lub nieczytelną) istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych.

PointInTimeRestore: tworzy bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a element restorePointInTime musi być określony.

Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId musi być określony jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić.

Przywracanie: tworzy bazę danych, przywracając kopię zapasową usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem usuniętej bazy danych, a parametr sourceDatabaseDeletionDate jest ignorowany. Można również określić element restorePointInTime w celu przywrócenia z wcześniejszego punktu w czasie.

RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu przechowywania długoterminowego. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania.

Kopiowanie, NonReadableSecondary, OnlineSecondary i RestoreLongTermRetentionBackup nie są obsługiwane w przypadku wersji DataWarehouse.

properties.creationDate

string (date-time)

Data utworzenia bazy danych (format ISO8601).

properties.currentServiceObjectiveId

string (uuid)

Bieżący identyfikator celu poziomu usługi bazy danych. Jest to identyfikator celu poziomu usług, który jest obecnie aktywny.

properties.databaseId

string (uuid)

Identyfikator bazy danych.

properties.defaultSecondaryLocation

string

Domyślny region pomocniczy dla tej bazy danych.

properties.earliestRestoreDate

string (date-time)

Rejestruje najwcześniejszą datę i godzinę rozpoczęcia przywracania dla tej bazy danych (format ISO8601).

properties.edition

DatabaseEdition

Wydanie bazy danych. Wyliczenie DatabaseEditions zawiera wszystkie prawidłowe wersje. Jeśli parametr createMode to NonReadableSecondary lub OnlineSecondary, ta wartość jest ignorowana.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST Capabilities_ListByLocation lub jednego z następujących poleceń:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
properties.elasticPoolName

string

Nazwa elastycznej puli, w których znajduje się baza danych. Jeśli parametr elasticPoolName i requestedServiceObjectiveName są aktualizowane, wartość requestedServiceObjectiveName jest ignorowana. Nieobsługiwane w przypadku wersji DataWarehouse.

properties.failoverGroupId

string

Identyfikator zasobu grupy trybu failover zawierającej tę bazę danych.

properties.maxSizeBytes

string

Maksymalny rozmiar bazy danych wyrażony w bajtach. Jeśli tryb createMode nie jest domyślny, ta wartość jest ignorowana. Aby wyświetlić możliwe wartości, wykonaj zapytanie dotyczące interfejsu API możliwości (/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities), do których odwołuje się identyfikator operationId: "Capabilities_ListByLocation".

properties.readScale

ReadScale

Warunkowy. Jeśli baza danych jest pomocniczym obszarem geograficznym, funkcja readScale wskazuje, czy połączenia tylko do odczytu mogą być dozwolone dla tej bazy danych, czy nie. Nieobsługiwane w przypadku wersji DataWarehouse.

properties.recommendedIndex

RecommendedIndex[]

Zalecane indeksy dla tej bazy danych.

properties.recoveryServicesRecoveryPointResourceId

string

Warunkowy. Jeśli parametr createMode to RestoreLongTermRetentionBackup, ta wartość jest wymagana. Określa identyfikator zasobu punktu odzyskiwania do przywrócenia z.

properties.requestedServiceObjectiveId

string (uuid)

Skonfigurowany identyfikator celu poziomu usługi bazy danych. Jest to cel poziomu usługi, który jest w trakcie stosowania do bazy danych. Po pomyślnym zaktualizowaniu będzie ona zgodna z wartością właściwości currentServiceObjectiveId. Jeśli element requestedServiceObjectiveId i requestedServiceObjectiveName są aktualizowane, wartość requestedServiceObjectiveId zastępuje wartość requestedServiceObjectiveName.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić identyfikatory celu usługi, które są dostępne dla twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST Capabilities_ListByLocation.

properties.requestedServiceObjectiveName

ServiceObjectiveName

Nazwa skonfigurowanego celu poziomu usługi bazy danych. Jest to cel poziomu usługi, który jest w trakcie stosowania do bazy danych. Po pomyślnym zaktualizowaniu będzie ona zgodna z wartością właściwości serviceLevelObjective.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST Capabilities_ListByLocation lub jednego z następujących poleceń:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
properties.restorePointInTime

string (date-time)

Warunkowy. Jeśli parametr createMode to PointInTimeRestore, ta wartość jest wymagana. Jeśli parametr createMode to Restore, ta wartość jest opcjonalna. Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. Musi być większa lub równa najwcześniejszej wartości źródłowej bazy danychRestoreDate.

properties.sampleName

SampleName

Wskazuje nazwę przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych. Jeśli tryb createMode nie jest domyślny, ta wartość jest ignorowana. Nieobsługiwane w przypadku wersji DataWarehouse.

properties.serviceLevelObjective

ServiceObjectiveName

Bieżący cel poziomu usługi bazy danych.

properties.serviceTierAdvisors

ServiceTierAdvisor[]

Lista doradców warstwy usług dla tej bazy danych. Rozwinięta właściwość

properties.sourceDatabaseDeletionDate

string (date-time)

Warunkowy. Jeśli parametr createMode to Restore i sourceDatabaseId jest oryginalnym identyfikatorem zasobu usuniętej bazy danych, gdy istniał (w przeciwieństwie do bieżącego identyfikatora porzuconej bazy danych możliwej do przywrócenia), ta wartość jest wymagana. Określa czas usunięcia bazy danych.

properties.sourceDatabaseId

string

Warunkowy. Jeśli parametr createMode to Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery lub Restore, ta wartość jest wymagana. Określa identyfikator zasobu źródłowej bazy danych. Jeśli parametr createMode to NonReadableSecondary lub OnlineSecondary, nazwa źródłowej bazy danych musi być taka sama jak tworzona nowa baza danych.

properties.status

string

Stan bazy danych.

properties.transparentDataEncryption

TransparentDataEncryption[]

Informacje o przezroczystym szyfrowaniu danych dla tej bazy danych.

properties.zoneRedundant

boolean

Niezależnie od tego, czy ta baza danych jest strefowo nadmiarowa, co oznacza, że repliki tej bazy danych będą rozłożone na wiele stref dostępności.

tags

object

Tagi zasobów.

type

string

Typ zasobu.

DatabaseEdition

Wydanie bazy danych. Wyliczenie DatabaseEditions zawiera wszystkie prawidłowe wersje. Jeśli parametr createMode to NonReadableSecondary lub OnlineSecondary, ta wartość jest ignorowana.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST Capabilities_ListByLocation lub jednego z następujących poleceń:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
Wartość Opis
Web
Business
Basic
Standard
Premium
PremiumRS
Free
Stretch
DataWarehouse
System
System2
GeneralPurpose
BusinessCritical
Hyperscale

DatabaseUpdate

Wymagane parametry do aktualizowania bazy danych.

Nazwa Typ Opis
id

string

Identyfikator zasobu.

name

string

Nazwa zasobu.

properties.collation

string

Sortowanie bazy danych. Jeśli tryb createMode nie jest domyślny, ta wartość jest ignorowana.

properties.containmentState

integer (int64)

Stan zawierania bazy danych.

properties.createMode

CreateMode

Określa tryb tworzenia bazy danych.

Ustawienie domyślne: regularne tworzenie bazy danych.

Kopiowanie: tworzy bazę danych jako kopię istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu źródłowej bazy danych.

OnlineSecondary/NonReadableSecondary: tworzy bazę danych jako replikę pomocniczą (czytelną lub nieczytelną) istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych.

PointInTimeRestore: tworzy bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a element restorePointInTime musi być określony.

Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId musi być określony jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić.

Przywracanie: tworzy bazę danych, przywracając kopię zapasową usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem usuniętej bazy danych, a parametr sourceDatabaseDeletionDate jest ignorowany. Można również określić element restorePointInTime w celu przywrócenia z wcześniejszego punktu w czasie.

RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu przechowywania długoterminowego. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania.

Kopiowanie, NonReadableSecondary, OnlineSecondary i RestoreLongTermRetentionBackup nie są obsługiwane w przypadku wersji DataWarehouse.

properties.creationDate

string (date-time)

Data utworzenia bazy danych (format ISO8601).

properties.currentServiceObjectiveId

string (uuid)

Bieżący identyfikator celu poziomu usługi bazy danych. Jest to identyfikator celu poziomu usług, który jest obecnie aktywny.

properties.databaseId

string (uuid)

Identyfikator bazy danych.

properties.defaultSecondaryLocation

string

Domyślny region pomocniczy dla tej bazy danych.

properties.earliestRestoreDate

string (date-time)

Rejestruje najwcześniejszą datę i godzinę rozpoczęcia przywracania dla tej bazy danych (format ISO8601).

properties.edition

DatabaseEdition

Wydanie bazy danych. Wyliczenie DatabaseEditions zawiera wszystkie prawidłowe wersje. Jeśli parametr createMode to NonReadableSecondary lub OnlineSecondary, ta wartość jest ignorowana.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST Capabilities_ListByLocation lub jednego z następujących poleceń:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
properties.elasticPoolName

string

Nazwa elastycznej puli, w których znajduje się baza danych. Jeśli parametr elasticPoolName i requestedServiceObjectiveName są aktualizowane, wartość requestedServiceObjectiveName jest ignorowana. Nieobsługiwane w przypadku wersji DataWarehouse.

properties.failoverGroupId

string

Identyfikator zasobu grupy trybu failover zawierającej tę bazę danych.

properties.maxSizeBytes

string

Maksymalny rozmiar bazy danych wyrażony w bajtach. Jeśli tryb createMode nie jest domyślny, ta wartość jest ignorowana. Aby wyświetlić możliwe wartości, wykonaj zapytanie dotyczące interfejsu API możliwości (/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities), do których odwołuje się identyfikator operationId: "Capabilities_ListByLocation".

properties.readScale

ReadScale

Warunkowy. Jeśli baza danych jest pomocniczym obszarem geograficznym, funkcja readScale wskazuje, czy połączenia tylko do odczytu mogą być dozwolone dla tej bazy danych, czy nie. Nieobsługiwane w przypadku wersji DataWarehouse.

properties.recommendedIndex

RecommendedIndex[]

Zalecane indeksy dla tej bazy danych.

properties.recoveryServicesRecoveryPointResourceId

string

Warunkowy. Jeśli parametr createMode to RestoreLongTermRetentionBackup, ta wartość jest wymagana. Określa identyfikator zasobu punktu odzyskiwania do przywrócenia z.

properties.requestedServiceObjectiveId

string (uuid)

Skonfigurowany identyfikator celu poziomu usługi bazy danych. Jest to cel poziomu usługi, który jest w trakcie stosowania do bazy danych. Po pomyślnym zaktualizowaniu będzie ona zgodna z wartością właściwości currentServiceObjectiveId. Jeśli element requestedServiceObjectiveId i requestedServiceObjectiveName są aktualizowane, wartość requestedServiceObjectiveId zastępuje wartość requestedServiceObjectiveName.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić identyfikatory celu usługi, które są dostępne dla twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST Capabilities_ListByLocation.

properties.requestedServiceObjectiveName

ServiceObjectiveName

Nazwa skonfigurowanego celu poziomu usługi bazy danych. Jest to cel poziomu usługi, który jest w trakcie stosowania do bazy danych. Po pomyślnym zaktualizowaniu będzie ona zgodna z wartością właściwości serviceLevelObjective.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST Capabilities_ListByLocation lub jednego z następujących poleceń:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
properties.restorePointInTime

string (date-time)

Warunkowy. Jeśli parametr createMode to PointInTimeRestore, ta wartość jest wymagana. Jeśli parametr createMode to Restore, ta wartość jest opcjonalna. Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. Musi być większa lub równa najwcześniejszej wartości źródłowej bazy danychRestoreDate.

properties.sampleName

SampleName

Wskazuje nazwę przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych. Jeśli tryb createMode nie jest domyślny, ta wartość jest ignorowana. Nieobsługiwane w przypadku wersji DataWarehouse.

properties.serviceLevelObjective

ServiceObjectiveName

Bieżący cel poziomu usługi bazy danych.

properties.serviceTierAdvisors

ServiceTierAdvisor[]

Lista doradców warstwy usług dla tej bazy danych. Rozwinięta właściwość

properties.sourceDatabaseDeletionDate

string (date-time)

Warunkowy. Jeśli parametr createMode to Restore i sourceDatabaseId jest oryginalnym identyfikatorem zasobu usuniętej bazy danych, gdy istniał (w przeciwieństwie do bieżącego identyfikatora porzuconej bazy danych możliwej do przywrócenia), ta wartość jest wymagana. Określa czas usunięcia bazy danych.

properties.sourceDatabaseId

string

Warunkowy. Jeśli parametr createMode to Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery lub Restore, ta wartość jest wymagana. Określa identyfikator zasobu źródłowej bazy danych. Jeśli parametr createMode to NonReadableSecondary lub OnlineSecondary, nazwa źródłowej bazy danych musi być taka sama jak tworzona nowa baza danych.

properties.status

string

Stan bazy danych.

properties.transparentDataEncryption

TransparentDataEncryption[]

Informacje o przezroczystym szyfrowaniu danych dla tej bazy danych.

properties.zoneRedundant

boolean

Niezależnie od tego, czy ta baza danych jest strefowo nadmiarowa, co oznacza, że repliki tej bazy danych będą rozłożone na wiele stref dostępności.

tags

object

Tagi zasobów.

type

string

Typ zasobu.

OperationImpact

Szacowany wpływ wykonania zalecanej akcji indeksu.

Nazwa Typ Opis
changeValueAbsolute

number (double)

Bezwzględny wpływ na wymiar.

changeValueRelative

number (double)

Względny wpływ na wymiar (wartość null, jeśli nie ma zastosowania)

name

string

Nazwa wymiaru wpływu.

unit

string

Jednostka, w której mierzony jest szacowany wpływ na wymiar.

ReadScale

Warunkowy. Jeśli baza danych jest pomocniczym obszarem geograficznym, funkcja readScale wskazuje, czy połączenia tylko do odczytu mogą być dozwolone dla tej bazy danych, czy nie. Nieobsługiwane w przypadku wersji DataWarehouse.

Wartość Opis
Enabled
Disabled

RecommendedIndex

Zalecane indeksy dla tej bazy danych.

Nazwa Typ Opis
id

string

Identyfikator zasobu.

name

string

Nazwa zasobu.

properties.action

RecommendedIndexAction

Proponowana akcja indeksu. Możesz utworzyć brakujący indeks, usunąć nieużywany indeks lub ponownie skompilować istniejący indeks, aby poprawić jego wydajność.

properties.columns

string[]

Kolumny, dla których ma być kompilowanie indeksu

properties.created

string (date-time)

Data/godzina UTC wyświetlana podczas tworzenia tego zasobu (format ISO8601).

properties.estimatedImpact

OperationImpact[]

Szacowany wpływ wykonania zalecanej akcji indeksu.

properties.includedColumns

string[]

Lista nazw kolumn, które mają być uwzględnione w indeksie

properties.indexScript

string

Pełny skrypt indeksu kompilacji

properties.indexType

RecommendedIndexType

Typ indeksu (CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)

properties.lastModified

string (date-time)

Data/godzina UTC ostatniego zmiany tego zasobu (format ISO8601).

properties.reportedImpact

OperationImpact[]

Wartości zgłaszane po zakończeniu akcji indeksu.

properties.schema

string

Schemat, w którym znajduje się tabela do skompilowania indeksu

properties.state

RecommendedIndexState

Bieżący stan zalecenia.

properties.table

string

Tabela, na której ma być kompilowanie indeksu.

type

string

Typ zasobu.

RecommendedIndexAction

Proponowana akcja indeksu. Możesz utworzyć brakujący indeks, usunąć nieużywany indeks lub ponownie skompilować istniejący indeks, aby poprawić jego wydajność.

Wartość Opis
Create
Drop
Rebuild

RecommendedIndexState

Bieżący stan zalecenia.

Wartość Opis
Active
Pending
Executing
Verifying
Pending Revert
Reverting
Reverted
Ignored
Expired
Blocked
Success

RecommendedIndexType

Typ indeksu (CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)

Wartość Opis
CLUSTERED
NONCLUSTERED
COLUMNSTORE
CLUSTERED COLUMNSTORE

SampleName

Wskazuje nazwę przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych. Jeśli tryb createMode nie jest domyślny, ta wartość jest ignorowana. Nieobsługiwane w przypadku wersji DataWarehouse.

Wartość Opis
AdventureWorksLT

ServiceObjectiveName

Nazwa skonfigurowanego celu poziomu usługi bazy danych. Jest to cel poziomu usługi, który jest w trakcie stosowania do bazy danych. Po pomyślnym zaktualizowaniu będzie ona zgodna z wartością właściwości serviceLevelObjective.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST Capabilities_ListByLocation lub jednego z następujących poleceń:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
Wartość Opis
System
System0
System1
System2
System3
System4
System2L
System3L
System4L
Free
Basic
S0
S1
S2
S3
S4
S6
S7
S9
S12
P1
P2
P3
P4
P6
P11
P15
PRS1
PRS2
PRS4
PRS6
DW100
DW200
DW300
DW400
DW500
DW600
DW1000
DW1200
DW1000c
DW1500
DW1500c
DW2000
DW2000c
DW3000
DW2500c
DW3000c
DW6000
DW5000c
DW6000c
DW7500c
DW10000c
DW15000c
DW30000c
DS100
DS200
DS300
DS400
DS500
DS600
DS1000
DS1200
DS1500
DS2000
ElasticPool

ServiceTierAdvisor

Lista doradców warstwy usług dla tej bazy danych. Rozwinięta właściwość

Nazwa Typ Opis
id

string

Identyfikator zasobu.

name

string

Nazwa zasobu.

properties.activeTimeRatio

number (double)

ActiveTimeRatio dla klasyfikatora warstwy usług.

properties.avgDtu

number (double)

Pobiera lub ustawia wersję avgDtu dla doradcy warstwy usług.

properties.confidence

number (double)

Pobiera lub ustawia pewność dla klasyfikatora warstwy usług.

properties.currentServiceLevelObjective

string

Pobiera lub ustawia wartość currentServiceLevelObjective dla klasyfikatora warstwy usług.

properties.currentServiceLevelObjectiveId

string (uuid)

Pobiera lub ustawia currentServiceLevelObjectiveId dla klasyfikatora warstwy usług.

properties.databaseSizeBasedRecommendationServiceLevelObjective

string

Pobiera lub ustawia databaseSizeBasedRecommendationServiceLevelObjective dla klasyfikatora warstwy usług.

properties.databaseSizeBasedRecommendationServiceLevelObjectiveId

string (uuid)

Pobiera lub ustawia parametr databaseSizeBasedRecommendationServiceLevelObjectiveId dla klasyfikatora warstwy usług.

properties.disasterPlanBasedRecommendationServiceLevelObjective

string

Pobiera lub ustawia disasterPlanBasedRecommendationServiceLevelObjective dla klasyfikatora warstwy usług.

properties.disasterPlanBasedRecommendationServiceLevelObjectiveId

string (uuid)

Pobiera lub ustawia disasterPlanBasedRecommendationServiceLevelObjectiveId dla klasyfikatora warstwy usług.

properties.maxDtu

number (double)

Pobiera lub ustawia wartość maxDtu dla klasyfikatora warstwy usług.

properties.maxSizeInGB

number (double)

Pobiera lub ustawia wartość maxSizeInGB dla klasyfikatora warstwy usług.

properties.minDtu

number (double)

Pobiera lub ustawia wartość minDtu dla klasyfikatora warstwy usług.

properties.observationPeriodEnd

string (date-time)

Początek okresu obserwacji (format ISO8601).

properties.observationPeriodStart

string (date-time)

Początek okresu obserwacji (format ISO8601).

properties.overallRecommendationServiceLevelObjective

string

Pobiera lub ustawia parametr overallRecommendationServiceLevelObjective dla klasyfikatora warstwy usług.

properties.overallRecommendationServiceLevelObjectiveId

string (uuid)

Pobiera lub ustawia parametr overallRecommendationServiceLevelObjectiveId dla klasyfikatora warstwy usług.

properties.serviceLevelObjectiveUsageMetrics

SloUsageMetric[]

Pobiera lub ustawia parametr serviceLevelObjectiveUsageMetrics dla klasyfikatora warstwy usług.

properties.usageBasedRecommendationServiceLevelObjective

string

Pobiera lub ustawia wartość usageBasedRecommendationServiceLevelObjective dla klasyfikatora warstwy usług.

properties.usageBasedRecommendationServiceLevelObjectiveId

string (uuid)

Pobiera lub ustawia parametr usageBasedRecommendationServiceLevelObjectiveId dla klasyfikatora warstwy usług.

type

string

Typ zasobu.

SloUsageMetric

Pobiera lub ustawia parametr serviceLevelObjectiveUsageMetrics dla klasyfikatora warstwy usług.

Nazwa Typ Opis
inRangeTimeRatio

number (double)

Pobiera lub ustawia wartość inRangeTimeRatio dla metryki użycia slo.

serviceLevelObjective

ServiceObjectiveName

ServiceLevelObjective dla metryki użycia slo.

serviceLevelObjectiveId

string (uuid)

ServiceLevelObjectiveId dla metryki użycia slo.

TransparentDataEncryption

Informacje o przezroczystym szyfrowaniu danych dla tej bazy danych.

Nazwa Typ Opis
id

string

Identyfikator zasobu.

location

string

Lokalizacja zasobu.

name

string

Nazwa zasobu.

properties.status

TransparentDataEncryptionStatus

Stan przezroczystego szyfrowania danych bazy danych.

type

string

Typ zasobu.

TransparentDataEncryptionStatus

Stan przezroczystego szyfrowania danych bazy danych.

Wartość Opis
Enabled
Disabled