Databases - Update

Dienst:: SQL Database

API-Version:: 2014-04-01

Aktualisiert eine vorhandene Datenbank.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank, die aktualisiert werden soll.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
serverName	path	True	string	Der Name des Servers.
subscriptionId	path	True	string	Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version	query	True	string	Die API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
parameters	DatabaseUpdate	Die erforderlichen Parameter zum Aktualisieren einer Datenbank.

Antworten

Name	Typ	Beschreibung
200 OK	Database	OKAY
202 Accepted		Angenommen

Beispiele

Update a database max

Update a database min

Update a database max

Beispielanforderung

HTTP

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"
  }
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "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
  }
}

Statuscode:: 202

Update a database min

Beispielanforderung

HTTP

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

{}

Beispiel für eine Antwort

Statuscode:: 200

{
  "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
  }
}

Statuscode:: 202

Definitionen

Name	Beschreibung
CreateMode	Gibt den Modus der Datenbankerstellung an. Standard: regelmäßige Datenbankerstellung. Kopie: Erstellt eine Datenbank als Kopie einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der Quelldatenbank angegeben werden. OnlineSecondary/NonReadableSecondary: Erstellt eine Datenbank als sekundäres Replikat (lesbar oder nicht lesbar) einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der vorhandenen primären Datenbank angegeben werden. PointInTimeRestore: Erstellt eine Datenbank durch Wiederherstellen einer Zeitsicherung einer vorhandenen Datenbank. "sourceDatabaseId" muss als Ressourcen-ID der vorhandenen Datenbank angegeben werden, und "restorePointInTime" muss angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. sourceDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen. Wiederherstellen: Erstellt eine Datenbank durch Wiederherstellen einer Sicherung einer gelöschten Datenbank. sourceDatabaseId muss angegeben werden. Wenn "sourceDatabaseId" die ursprüngliche Ressourcen-ID der Datenbank ist, muss "sourceDatabaseDeletionDate" angegeben werden. Andernfalls muss "sourceDatabaseId" die wiederherstellbare verworfene Datenbankressourcen-ID sein, und "sourceDatabaseDeletionDate" wird ignoriert. restorePointInTime kann auch angegeben werden, um sie von einem früheren Zeitpunkt wiederherzustellen. RestoreLongTermRetentionBackup: Erstellt eine Datenbank, indem sie aus einem langfristigen Aufbewahrungstresor wiederhergestellt wird. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden. Copy, NonReadableSecondary, OnlineSecondary und RestoreLongTermRetentionBackup werden für DataWarehouse Edition nicht unterstützt.
Database	Stellt eine Datenbank dar.
DatabaseEdition	Die Ausgabe der Datenbank. Die DatabaseEditions-Aufzählung enthält alle gültigen Editionen. Wenn createMode nonReadableSecondary oder OnlineSecondary ist, wird dieser Wert ignoriert. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Um die SKUs (einschließlich SKU-Name, Tier/Edition, Familie und Kapazität) zu ermitteln, die für Ihr Abonnement in einer Azure-Region verfügbar sind, verwenden Sie die `Capabilities_ListByLocation` REST-API oder einen der folgenden Befehle: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
DatabaseUpdate	Die erforderlichen Parameter zum Aktualisieren einer Datenbank.
OperationImpact	Die geschätzten Auswirkungen der empfohlenen Indexaktion.
ReadScale	Konditional. Wenn es sich bei der Datenbank um eine geo-sekundäre Datenbank handelt, gibt readScale an, ob schreibgeschützte Verbindungen mit dieser Datenbank zulässig sind oder nicht. Wird für DataWarehouse-Edition nicht unterstützt.
RecommendedIndex	Die empfohlenen Indizes für diese Datenbank.
RecommendedIndexAction	Die vorgeschlagene Indexaktion. Sie können einen fehlenden Index erstellen, einen nicht verwendeten Index ablegen oder einen vorhandenen Index neu erstellen, um die Leistung zu verbessern.
RecommendedIndexState	Der aktuelle Empfehlungsstatus.
RecommendedIndexType	Der Indextyp (CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)
SampleName	Gibt den Namen des Beispielschemas an, das beim Erstellen dieser Datenbank angewendet werden soll. Wenn createMode nicht "Default" ist, wird dieser Wert ignoriert. Wird für DataWarehouse-Edition nicht unterstützt.
ServiceObjectiveName	Der Name des konfigurierten Dienstebenenziels der Datenbank. Dies ist das Ziel auf Dienstebene, das sich im Prozess der Anwendung auf die Datenbank befindet. Nach der erfolgreichen Aktualisierung entspricht sie dem Wert der eigenschaft serviceLevelObjective. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Um die SKUs (einschließlich SKU-Name, Tier/Edition, Familie und Kapazität) zu ermitteln, die für Ihr Abonnement in einer Azure-Region verfügbar sind, verwenden Sie die `Capabilities_ListByLocation` REST-API oder einen der folgenden Befehle: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
ServiceTierAdvisor	Die Liste der Dienstebenenratgeber für diese Datenbank. Expanded-Eigenschaft
SloUsageMetric	Dient zum Abrufen oder Festlegen von serviceLevelObjectiveUsageMetrics für den Dienstebenenratgeber.
TransparentDataEncryption	Die transparenten Datenverschlüsselungsinformationen für diese Datenbank.
TransparentDataEncryptionStatus	Der Status der transparenten Datenverschlüsselung der Datenbank.

CreateMode

Enumeration

Gibt den Modus der Datenbankerstellung an.

Standard: regelmäßige Datenbankerstellung.

Kopie: Erstellt eine Datenbank als Kopie einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der Quelldatenbank angegeben werden.

OnlineSecondary/NonReadableSecondary: Erstellt eine Datenbank als sekundäres Replikat (lesbar oder nicht lesbar) einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der vorhandenen primären Datenbank angegeben werden.

PointInTimeRestore: Erstellt eine Datenbank durch Wiederherstellen einer Zeitsicherung einer vorhandenen Datenbank. "sourceDatabaseId" muss als Ressourcen-ID der vorhandenen Datenbank angegeben werden, und "restorePointInTime" muss angegeben werden.

Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. sourceDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen.

Wiederherstellen: Erstellt eine Datenbank durch Wiederherstellen einer Sicherung einer gelöschten Datenbank. sourceDatabaseId muss angegeben werden. Wenn "sourceDatabaseId" die ursprüngliche Ressourcen-ID der Datenbank ist, muss "sourceDatabaseDeletionDate" angegeben werden. Andernfalls muss "sourceDatabaseId" die wiederherstellbare verworfene Datenbankressourcen-ID sein, und "sourceDatabaseDeletionDate" wird ignoriert. restorePointInTime kann auch angegeben werden, um sie von einem früheren Zeitpunkt wiederherzustellen.

RestoreLongTermRetentionBackup: Erstellt eine Datenbank, indem sie aus einem langfristigen Aufbewahrungstresor wiederhergestellt wird. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden.

Copy, NonReadableSecondary, OnlineSecondary und RestoreLongTermRetentionBackup werden für DataWarehouse Edition nicht unterstützt.

Wert	Beschreibung
Copy
Default
NonReadableSecondary
OnlineSecondary
PointInTimeRestore
Recovery
Restore
RestoreLongTermRetentionBackup

Database

Objekt

Stellt eine Datenbank dar.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
kind	string	Art der Datenbank. Dies sind Metadaten, die für die Azure-Portaloberfläche verwendet werden.
location	string	Ressourcenspeicherort.
name	string	Ressourcenname.
properties.collation	string	Die Sortierung der Datenbank. Wenn createMode nicht "Default" ist, wird dieser Wert ignoriert.
properties.containmentState	integer (int64)	Der Eindämmungsstatus der Datenbank.
properties.createMode	CreateMode	Gibt den Modus der Datenbankerstellung an. Standard: regelmäßige Datenbankerstellung. Kopie: Erstellt eine Datenbank als Kopie einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der Quelldatenbank angegeben werden. OnlineSecondary/NonReadableSecondary: Erstellt eine Datenbank als sekundäres Replikat (lesbar oder nicht lesbar) einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der vorhandenen primären Datenbank angegeben werden. PointInTimeRestore: Erstellt eine Datenbank durch Wiederherstellen einer Zeitsicherung einer vorhandenen Datenbank. "sourceDatabaseId" muss als Ressourcen-ID der vorhandenen Datenbank angegeben werden, und "restorePointInTime" muss angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. sourceDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen. Wiederherstellen: Erstellt eine Datenbank durch Wiederherstellen einer Sicherung einer gelöschten Datenbank. sourceDatabaseId muss angegeben werden. Wenn "sourceDatabaseId" die ursprüngliche Ressourcen-ID der Datenbank ist, muss "sourceDatabaseDeletionDate" angegeben werden. Andernfalls muss "sourceDatabaseId" die wiederherstellbare verworfene Datenbankressourcen-ID sein, und "sourceDatabaseDeletionDate" wird ignoriert. restorePointInTime kann auch angegeben werden, um sie von einem früheren Zeitpunkt wiederherzustellen. RestoreLongTermRetentionBackup: Erstellt eine Datenbank, indem sie aus einem langfristigen Aufbewahrungstresor wiederhergestellt wird. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden. Copy, NonReadableSecondary, OnlineSecondary und RestoreLongTermRetentionBackup werden für DataWarehouse Edition nicht unterstützt.
properties.creationDate	string (date-time)	Das Erstellungsdatum der Datenbank (ISO8601 Format).
properties.currentServiceObjectiveId	string (uuid)	Die aktuelle Ziel-ID der Dienstebene der Datenbank. Dies ist die ID des Ziels der Dienstebene, das derzeit aktiv ist.
properties.databaseId	string (uuid)	Die ID der Datenbank.
properties.defaultSecondaryLocation	string	Der sekundäre Standardbereich für diese Datenbank.
properties.earliestRestoreDate	string (date-time)	Dadurch wird das früheste Startdatum und die früheste Wiederherstellungszeit für diese Datenbank (ISO8601 Format) aufgezeichnet.
properties.edition	DatabaseEdition	Die Ausgabe der Datenbank. Die DatabaseEditions-Aufzählung enthält alle gültigen Editionen. Wenn createMode nonReadableSecondary oder OnlineSecondary ist, wird dieser Wert ignoriert. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Um die SKUs (einschließlich SKU-Name, Tier/Edition, Familie und Kapazität) zu ermitteln, die für Ihr Abonnement in einer Azure-Region verfügbar sind, verwenden Sie die `Capabilities_ListByLocation` REST-API oder einen der folgenden Befehle: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
properties.elasticPoolName	string	Der Name des elastischen Pools, in dem sich die Datenbank befindet. Wenn elasticPoolName und requestedServiceObjectiveName aktualisiert werden, wird der Wert von requestedServiceObjectiveName ignoriert. Wird für DataWarehouse-Edition nicht unterstützt.
properties.failoverGroupId	string	Der Ressourcenbezeichner der Failovergruppe, die diese Datenbank enthält.
properties.maxSizeBytes	string	Die maximale Größe der Datenbank, die in Byte ausgedrückt wird. Wenn createMode nicht "Default" ist, wird dieser Wert ignoriert. Um mögliche Werte anzuzeigen, fragen Sie die Funktionen-API (/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities) ab, auf die die OperationId verweist: "Capabilities_ListByLocation".
properties.readScale	ReadScale	Konditional. Wenn es sich bei der Datenbank um eine geo-sekundäre Datenbank handelt, gibt readScale an, ob schreibgeschützte Verbindungen mit dieser Datenbank zulässig sind oder nicht. Wird für DataWarehouse-Edition nicht unterstützt.
properties.recommendedIndex	RecommendedIndex[]	Die empfohlenen Indizes für diese Datenbank.
properties.recoveryServicesRecoveryPointResourceId	string	Konditional. Wenn createMode "RestoreLongTermRetentionBackup" ist, ist dieser Wert erforderlich. Gibt die Ressourcen-ID des wiederherzustellenden Wiederherstellungspunkts an.
properties.requestedServiceObjectiveId	string (uuid)	Die konfigurierte Ziel-ID der Dienstebene der Datenbank. Dies ist das Ziel auf Dienstebene, das sich im Prozess der Anwendung auf die Datenbank befindet. Nach der erfolgreichen Aktualisierung entspricht sie dem Wert der currentServiceObjectiveId-Eigenschaft. Wenn requestedServiceObjectiveId und requestedServiceObjectiveName aktualisiert werden, überschreibt der Wert von requestedServiceObjectiveId den Wert von requestedServiceObjectiveName. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Um die Dienstziel-IDs zu ermitteln, die für Ihr Abonnement in einer Azure-Region verfügbar sind, verwenden Sie die `Capabilities_ListByLocation` REST-API.
properties.requestedServiceObjectiveName	ServiceObjectiveName	Der Name des konfigurierten Dienstebenenziels der Datenbank. Dies ist das Ziel auf Dienstebene, das sich im Prozess der Anwendung auf die Datenbank befindet. Nach der erfolgreichen Aktualisierung entspricht sie dem Wert der eigenschaft serviceLevelObjective. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Um die SKUs (einschließlich SKU-Name, Tier/Edition, Familie und Kapazität) zu ermitteln, die für Ihr Abonnement in einer Azure-Region verfügbar sind, verwenden Sie die `Capabilities_ListByLocation` REST-API oder einen der folgenden Befehle: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
properties.restorePointInTime	string (date-time)	Konditional. Wenn createMode PointInTimeRestore ist, ist dieser Wert erforderlich. Wenn createMode wiederhergestellt wird, ist dieser Wert optional. Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen. Muss größer oder gleich dem frühesten Wert der Quelldatenbank sein.
properties.sampleName	SampleName	Gibt den Namen des Beispielschemas an, das beim Erstellen dieser Datenbank angewendet werden soll. Wenn createMode nicht "Default" ist, wird dieser Wert ignoriert. Wird für DataWarehouse-Edition nicht unterstützt.
properties.serviceLevelObjective	ServiceObjectiveName	Das aktuelle Ziel der Dienstebene der Datenbank.
properties.serviceTierAdvisors	ServiceTierAdvisor[]	Die Liste der Dienstebenenratgeber für diese Datenbank. Expanded-Eigenschaft
properties.sourceDatabaseDeletionDate	string (date-time)	Konditional. Wenn createMode "Restore" ist und "sourceDatabaseId" die ursprüngliche Ressourcen-ID der gelöschten Datenbank ist, wenn sie vorhanden ist (im Gegensatz zur aktuellen, wiederherstellbaren verworfenen Datenbank-ID), ist dieser Wert erforderlich. Gibt die Uhrzeit an, zu der die Datenbank gelöscht wurde.
properties.sourceDatabaseId	string	Konditional. Wenn createMode "Copy", "NonReadableSecondary", "OnlineSecondary", "PointInTimeRestore", "Recovery" oder "Restore" lautet, ist dieser Wert erforderlich. Gibt die Ressourcen-ID der Quelldatenbank an. Wenn createMode nonReadableSecondary oder OnlineSecondary ist, muss der Name der Quelldatenbank mit der neuen Datenbank identisch sein, die erstellt wird.
properties.status	string	Der Status der Datenbank.
properties.transparentDataEncryption	TransparentDataEncryption[]	Die transparenten Datenverschlüsselungsinformationen für diese Datenbank.
properties.zoneRedundant	boolean	Gibt an, ob diese Datenbank zonenredundant ist, was bedeutet, dass die Replikate dieser Datenbank über mehrere Verfügbarkeitszonen verteilt werden.
tags	object	Ressourcentags.
type	string	Ressourcentyp.

DatabaseEdition

Enumeration

Die Ausgabe der Datenbank. Die DatabaseEditions-Aufzählung enthält alle gültigen Editionen. Wenn createMode nonReadableSecondary oder OnlineSecondary ist, wird dieser Wert ignoriert.

Die Liste der SKUs kann je nach Region und Supportangebot variieren. Um die SKUs (einschließlich SKU-Name, Tier/Edition, Familie und Kapazität) zu ermitteln, die für Ihr Abonnement in einer Azure-Region verfügbar sind, verwenden Sie die Capabilities_ListByLocation REST-API oder einen der folgenden Befehle:

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>

Wert	Beschreibung
Web
Business
Basic
Standard
Premium
PremiumRS
Free
Stretch
DataWarehouse
System
System2
GeneralPurpose
BusinessCritical
Hyperscale

DatabaseUpdate

Objekt

Die erforderlichen Parameter zum Aktualisieren einer Datenbank.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
name	string	Ressourcenname.
properties.collation	string	Die Sortierung der Datenbank. Wenn createMode nicht "Default" ist, wird dieser Wert ignoriert.
properties.containmentState	integer (int64)	Der Eindämmungsstatus der Datenbank.
properties.createMode	CreateMode	Gibt den Modus der Datenbankerstellung an. Standard: regelmäßige Datenbankerstellung. Kopie: Erstellt eine Datenbank als Kopie einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der Quelldatenbank angegeben werden. OnlineSecondary/NonReadableSecondary: Erstellt eine Datenbank als sekundäres Replikat (lesbar oder nicht lesbar) einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der vorhandenen primären Datenbank angegeben werden. PointInTimeRestore: Erstellt eine Datenbank durch Wiederherstellen einer Zeitsicherung einer vorhandenen Datenbank. "sourceDatabaseId" muss als Ressourcen-ID der vorhandenen Datenbank angegeben werden, und "restorePointInTime" muss angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. sourceDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden, um wiederherzustellen. Wiederherstellen: Erstellt eine Datenbank durch Wiederherstellen einer Sicherung einer gelöschten Datenbank. sourceDatabaseId muss angegeben werden. Wenn "sourceDatabaseId" die ursprüngliche Ressourcen-ID der Datenbank ist, muss "sourceDatabaseDeletionDate" angegeben werden. Andernfalls muss "sourceDatabaseId" die wiederherstellbare verworfene Datenbankressourcen-ID sein, und "sourceDatabaseDeletionDate" wird ignoriert. restorePointInTime kann auch angegeben werden, um sie von einem früheren Zeitpunkt wiederherzustellen. RestoreLongTermRetentionBackup: Erstellt eine Datenbank, indem sie aus einem langfristigen Aufbewahrungstresor wiederhergestellt wird. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden. Copy, NonReadableSecondary, OnlineSecondary und RestoreLongTermRetentionBackup werden für DataWarehouse Edition nicht unterstützt.
properties.creationDate	string (date-time)	Das Erstellungsdatum der Datenbank (ISO8601 Format).
properties.currentServiceObjectiveId	string (uuid)	Die aktuelle Ziel-ID der Dienstebene der Datenbank. Dies ist die ID des Ziels der Dienstebene, das derzeit aktiv ist.
properties.databaseId	string (uuid)	Die ID der Datenbank.
properties.defaultSecondaryLocation	string	Der sekundäre Standardbereich für diese Datenbank.
properties.earliestRestoreDate	string (date-time)	Dadurch wird das früheste Startdatum und die früheste Wiederherstellungszeit für diese Datenbank (ISO8601 Format) aufgezeichnet.
properties.edition	DatabaseEdition	Die Ausgabe der Datenbank. Die DatabaseEditions-Aufzählung enthält alle gültigen Editionen. Wenn createMode nonReadableSecondary oder OnlineSecondary ist, wird dieser Wert ignoriert. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Um die SKUs (einschließlich SKU-Name, Tier/Edition, Familie und Kapazität) zu ermitteln, die für Ihr Abonnement in einer Azure-Region verfügbar sind, verwenden Sie die `Capabilities_ListByLocation` REST-API oder einen der folgenden Befehle: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
properties.elasticPoolName	string	Der Name des elastischen Pools, in dem sich die Datenbank befindet. Wenn elasticPoolName und requestedServiceObjectiveName aktualisiert werden, wird der Wert von requestedServiceObjectiveName ignoriert. Wird für DataWarehouse-Edition nicht unterstützt.
properties.failoverGroupId	string	Der Ressourcenbezeichner der Failovergruppe, die diese Datenbank enthält.
properties.maxSizeBytes	string	Die maximale Größe der Datenbank, die in Byte ausgedrückt wird. Wenn createMode nicht "Default" ist, wird dieser Wert ignoriert. Um mögliche Werte anzuzeigen, fragen Sie die Funktionen-API (/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities) ab, auf die die OperationId verweist: "Capabilities_ListByLocation".
properties.readScale	ReadScale	Konditional. Wenn es sich bei der Datenbank um eine geo-sekundäre Datenbank handelt, gibt readScale an, ob schreibgeschützte Verbindungen mit dieser Datenbank zulässig sind oder nicht. Wird für DataWarehouse-Edition nicht unterstützt.
properties.recommendedIndex	RecommendedIndex[]	Die empfohlenen Indizes für diese Datenbank.
properties.recoveryServicesRecoveryPointResourceId	string	Konditional. Wenn createMode "RestoreLongTermRetentionBackup" ist, ist dieser Wert erforderlich. Gibt die Ressourcen-ID des wiederherzustellenden Wiederherstellungspunkts an.
properties.requestedServiceObjectiveId	string (uuid)	Die konfigurierte Ziel-ID der Dienstebene der Datenbank. Dies ist das Ziel auf Dienstebene, das sich im Prozess der Anwendung auf die Datenbank befindet. Nach der erfolgreichen Aktualisierung entspricht sie dem Wert der currentServiceObjectiveId-Eigenschaft. Wenn requestedServiceObjectiveId und requestedServiceObjectiveName aktualisiert werden, überschreibt der Wert von requestedServiceObjectiveId den Wert von requestedServiceObjectiveName. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Um die Dienstziel-IDs zu ermitteln, die für Ihr Abonnement in einer Azure-Region verfügbar sind, verwenden Sie die `Capabilities_ListByLocation` REST-API.
properties.requestedServiceObjectiveName	ServiceObjectiveName	Der Name des konfigurierten Dienstebenenziels der Datenbank. Dies ist das Ziel auf Dienstebene, das sich im Prozess der Anwendung auf die Datenbank befindet. Nach der erfolgreichen Aktualisierung entspricht sie dem Wert der eigenschaft serviceLevelObjective. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Um die SKUs (einschließlich SKU-Name, Tier/Edition, Familie und Kapazität) zu ermitteln, die für Ihr Abonnement in einer Azure-Region verfügbar sind, verwenden Sie die `Capabilities_ListByLocation` REST-API oder einen der folgenden Befehle: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
properties.restorePointInTime	string (date-time)	Konditional. Wenn createMode PointInTimeRestore ist, ist dieser Wert erforderlich. Wenn createMode wiederhergestellt wird, ist dieser Wert optional. Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen. Muss größer oder gleich dem frühesten Wert der Quelldatenbank sein.
properties.sampleName	SampleName	Gibt den Namen des Beispielschemas an, das beim Erstellen dieser Datenbank angewendet werden soll. Wenn createMode nicht "Default" ist, wird dieser Wert ignoriert. Wird für DataWarehouse-Edition nicht unterstützt.
properties.serviceLevelObjective	ServiceObjectiveName	Das aktuelle Ziel der Dienstebene der Datenbank.
properties.serviceTierAdvisors	ServiceTierAdvisor[]	Die Liste der Dienstebenenratgeber für diese Datenbank. Expanded-Eigenschaft
properties.sourceDatabaseDeletionDate	string (date-time)	Konditional. Wenn createMode "Restore" ist und "sourceDatabaseId" die ursprüngliche Ressourcen-ID der gelöschten Datenbank ist, wenn sie vorhanden ist (im Gegensatz zur aktuellen, wiederherstellbaren verworfenen Datenbank-ID), ist dieser Wert erforderlich. Gibt die Uhrzeit an, zu der die Datenbank gelöscht wurde.
properties.sourceDatabaseId	string	Konditional. Wenn createMode "Copy", "NonReadableSecondary", "OnlineSecondary", "PointInTimeRestore", "Recovery" oder "Restore" lautet, ist dieser Wert erforderlich. Gibt die Ressourcen-ID der Quelldatenbank an. Wenn createMode nonReadableSecondary oder OnlineSecondary ist, muss der Name der Quelldatenbank mit der neuen Datenbank identisch sein, die erstellt wird.
properties.status	string	Der Status der Datenbank.
properties.transparentDataEncryption	TransparentDataEncryption[]	Die transparenten Datenverschlüsselungsinformationen für diese Datenbank.
properties.zoneRedundant	boolean	Gibt an, ob diese Datenbank zonenredundant ist, was bedeutet, dass die Replikate dieser Datenbank über mehrere Verfügbarkeitszonen verteilt werden.
tags	object	Ressourcentags.
type	string	Ressourcentyp.

OperationImpact

Objekt

Die geschätzten Auswirkungen der empfohlenen Indexaktion.

Name	Typ	Beschreibung
changeValueAbsolute	number (double)	Die absolute Auswirkung auf die Dimension.
changeValueRelative	number (double)	Die relativen Auswirkungen auf die Dimension (null, falls nicht zutreffend)
name	string	Der Name der Auswirkungsdimension.
unit	string	Die Einheit, in der geschätzte Auswirkungen auf die Dimension gemessen werden.

ReadScale

Enumeration

Konditional. Wenn es sich bei der Datenbank um eine geo-sekundäre Datenbank handelt, gibt readScale an, ob schreibgeschützte Verbindungen mit dieser Datenbank zulässig sind oder nicht. Wird für DataWarehouse-Edition nicht unterstützt.

Wert	Beschreibung
Enabled
Disabled

RecommendedIndex

Objekt

Die empfohlenen Indizes für diese Datenbank.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
name	string	Ressourcenname.
properties.action	RecommendedIndexAction	Die vorgeschlagene Indexaktion. Sie können einen fehlenden Index erstellen, einen nicht verwendeten Index ablegen oder einen vorhandenen Index neu erstellen, um die Leistung zu verbessern.
properties.columns	string[]	Spalten, über die Index erstellt werden soll
properties.created	string (date-time)	Die UTC-Datumsangabe, die anzeigt, wann diese Ressource erstellt wurde (ISO8601 Format).
properties.estimatedImpact	OperationImpact[]	Die geschätzten Auswirkungen der empfohlenen Indexaktion.
properties.includedColumns	string[]	Die Liste der Spaltennamen, die im Index enthalten sein sollen
properties.indexScript	string	Das vollständige Buildindexskript
properties.indexType	RecommendedIndexType	Der Indextyp (CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)
properties.lastModified	string (date-time)	Die UTC-Datumszeit, zu der diese Ressource zuletzt geändert wurde (ISO8601 Format).
properties.reportedImpact	OperationImpact[]	Die Werte, die nach Abschluss der Indexaktion gemeldet wurden.
properties.schema	string	Das Schema, in dem sich die Tabelle befindet, über die der Index erstellt werden soll
properties.state	RecommendedIndexState	Der aktuelle Empfehlungsstatus.
properties.table	string	Die Tabelle, auf der index erstellt werden soll.
type	string	Ressourcentyp.

RecommendedIndexAction

Enumeration

Die vorgeschlagene Indexaktion. Sie können einen fehlenden Index erstellen, einen nicht verwendeten Index ablegen oder einen vorhandenen Index neu erstellen, um die Leistung zu verbessern.

Wert	Beschreibung
Create
Drop
Rebuild

RecommendedIndexState

Enumeration

Der aktuelle Empfehlungsstatus.

Wert	Beschreibung
Active
Pending
Executing
Verifying
Pending Revert
Reverting
Reverted
Ignored
Expired
Blocked
Success

RecommendedIndexType

Enumeration

Der Indextyp (CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)

Wert	Beschreibung
CLUSTERED
NONCLUSTERED
COLUMNSTORE
CLUSTERED COLUMNSTORE

SampleName

Enumeration

Gibt den Namen des Beispielschemas an, das beim Erstellen dieser Datenbank angewendet werden soll. Wenn createMode nicht "Default" ist, wird dieser Wert ignoriert. Wird für DataWarehouse-Edition nicht unterstützt.

Wert	Beschreibung
AdventureWorksLT

ServiceObjectiveName

Enumeration

Der Name des konfigurierten Dienstebenenziels der Datenbank. Dies ist das Ziel auf Dienstebene, das sich im Prozess der Anwendung auf die Datenbank befindet. Nach der erfolgreichen Aktualisierung entspricht sie dem Wert der eigenschaft serviceLevelObjective.

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>

Wert	Beschreibung
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

Objekt

Die Liste der Dienstebenenratgeber für diese Datenbank. Expanded-Eigenschaft

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
name	string	Ressourcenname.
properties.activeTimeRatio	number (double)	Der activeTimeRatio für Dienstebenenratgeber.
properties.avgDtu	number (double)	Dient zum Abrufen oder Festlegen von "avgDtu" für den Dienstebenenratgeber.
properties.confidence	number (double)	Ruft die Vertrauensstellung für den Dienstebenenratgeber ab oder legt diese fest.
properties.currentServiceLevelObjective	string	Dient zum Abrufen oder Festlegen von currentServiceLevelObjective für den Dienstebenenratgeber.
properties.currentServiceLevelObjectiveId	string (uuid)	Dient zum Abrufen oder Festlegen von currentServiceLevelObjectiveId für den Dienstebenenratgeber.
properties.databaseSizeBasedRecommendationServiceLevelObjective	string	Dient zum Abrufen oder Festlegen von databaseSizeBasedRecommendationServiceLevelObjective für den Dienstebenenratgeber.
properties.databaseSizeBasedRecommendationServiceLevelObjectiveId	string (uuid)	Ruft databaseSizeBasedRecommendationServiceLevelObjectiveId für Dienstebenenratgeber ab oder legt diese fest.
properties.disasterPlanBasedRecommendationServiceLevelObjective	string	Dient zum Abrufen oder Festlegen von disasterPlanBasedRecommendationServiceLevelObjective für den Dienstebenenratgeber.
properties.disasterPlanBasedRecommendationServiceLevelObjectiveId	string (uuid)	Dient zum Abrufen oder Festlegen von disasterPlanBasedRecommendationServiceLevelObjectiveId für den Dienstebenenratgeber.
properties.maxDtu	number (double)	Ruft maxDtu für Dienstebenenratgeber ab oder legt diese fest.
properties.maxSizeInGB	number (double)	Dient zum Abrufen oder Festlegen von maxSizeInGB für den Dienstebenenratgeber.
properties.minDtu	number (double)	Ruft minDtu für service tier advisor ab oder legt diese fest.
properties.observationPeriodEnd	string (date-time)	Der Beobachtungszeitraum beginnt (ISO8601 Format).
properties.observationPeriodStart	string (date-time)	Der Beobachtungszeitraum beginnt (ISO8601 Format).
properties.overallRecommendationServiceLevelObjective	string	Dient zum Abrufen oder Festlegen von overallRecommendationServiceLevelObjective für den Dienstebenenratgeber.
properties.overallRecommendationServiceLevelObjectiveId	string (uuid)	Dient zum Abrufen oder Festlegen von overallRecommendationServiceLevelObjectiveId für Dienstebenenratgeber.
properties.serviceLevelObjectiveUsageMetrics	SloUsageMetric[]	Dient zum Abrufen oder Festlegen von serviceLevelObjectiveUsageMetrics für den Dienstebenenratgeber.
properties.usageBasedRecommendationServiceLevelObjective	string	Dient zum Abrufen oder Festlegen von usageBasedRecommendationServiceLevelObjective für den Dienstebenenratgeber.
properties.usageBasedRecommendationServiceLevelObjectiveId	string (uuid)	Dient zum Abrufen oder Festlegen von usageBasedRecommendationServiceLevelObjectiveId für den Dienstebenenratgeber.
type	string	Ressourcentyp.

SloUsageMetric

Objekt

Dient zum Abrufen oder Festlegen von serviceLevelObjectiveUsageMetrics für den Dienstebenenratgeber.

Name	Typ	Beschreibung
inRangeTimeRatio	number (double)	Ruft inRangeTimeRatio für SLO-Verwendungsmetrik ab oder legt diese fest.
serviceLevelObjective	ServiceObjectiveName	Die Metrik "serviceLevelObjective" für die SLO-Verwendung.
serviceLevelObjectiveId	string (uuid)	Die Metrik "serviceLevelObjectiveId" für die SLO-Verwendung.

TransparentDataEncryption

Objekt

Die transparenten Datenverschlüsselungsinformationen für diese Datenbank.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
location	string	Ressourcenspeicherort.
name	string	Ressourcenname.
properties.status	TransparentDataEncryptionStatus	Der Status der transparenten Datenverschlüsselung der Datenbank.
type	string	Ressourcentyp.

TransparentDataEncryptionStatus

Enumeration

Der Status der transparenten Datenverschlüsselung der Datenbank.

Wert	Beschreibung
Enabled
Disabled

Freigeben über

Databases - Update

URI-Parameter

Anforderungstext

Antworten

Beispiele

Update a database max

Beispielanforderung

Beispiel für eine Antwort

Update a database min

Beispielanforderung

Beispiel für eine Antwort

Definitionen

CreateMode

Database

DatabaseEdition

DatabaseUpdate

OperationImpact

ReadScale

RecommendedIndex

RecommendedIndexAction

RecommendedIndexState

RecommendedIndexType

SampleName

ServiceObjectiveName

ServiceTierAdvisor

SloUsageMetric

TransparentDataEncryption

TransparentDataEncryptionStatus