Databases - Update

Referenz

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. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	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	OK
202 Accepted		Akzeptiert

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: reguläre Datenbankerstellung. Kopieren: Erstellt eine Datenbank als Kopie einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der Quelldatenbank angegeben werden. OnlineSecondary/NonReadableSecondary: Erstellt eine Datenbank als (lesbares oder nicht lesbares) sekundäres Replikat einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der vorhandenen primären Datenbank angegeben werden. PointInTimeRestore: Erstellt eine Datenbank, indem eine Zeitpunktsicherung einer vorhandenen Datenbank wiederhergestellt wird. sourceDatabaseId muss als Ressourcen-ID der vorhandenen Datenbank und restorePointInTime angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. sourceDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden. Wiederherstellen: Erstellt eine Datenbank, indem eine Sicherung einer gelöschten Datenbank wiederhergestellt wird. sourceDatabaseId muss angegeben werden. Wenn sourceDatabaseId die ursprüngliche Ressourcen-ID der Datenbank ist, muss sourceDatabaseDeletionDate angegeben werden. Andernfalls muss sourceDatabaseId die wiederherstellbare gelöschte Datenbankressourcen-ID sein, und sourceDatabaseDeletionDate wird ignoriert. restorePointInTime kann auch für die Wiederherstellung von einem früheren Zeitpunkt angegeben werden. RestoreLongTermRetentionBackup: Erstellt eine Datenbank durch Wiederherstellung aus einem Tresor für die langfristige Aufbewahrung. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden. Copy, NonReadableSecondary, OnlineSecondary und RestoreLongTermRetentionBackup werden für die DataWarehouse-Edition nicht unterstützt.
Database	Stellt eine Datenbank dar.
DatabaseEdition	Die Edition der Datenbank. Die DatabaseEditions-Enumeration enthält alle gültigen Editionen. Wenn createMode nicht lesbarsecondary oder OnlineSecondary ist, wird dieser Wert ignoriert. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Verwenden Sie die REST-API oder einen der folgenden Befehle, um die SKUs (einschließlich SKU-Name, Ebene/Edition, Familie und Kapazität) zu ermitteln, die `Capabilities_ListByLocation` für Ihr Abonnement in einer Azure-Region verfügbar sind: `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 Durchführung empfohlener Indexaktionen.
ReadScale	Bedingte. 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. Wird für die 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 löschen 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 Standard ist, wird dieser Wert ignoriert. Wird für die DataWarehouse-Edition nicht unterstützt.
ServiceObjectiveName	Der Name des konfigurierten Servicelevelziels der Datenbank. Dies ist das Servicelevelziel, das gerade auf die Datenbank angewendet wird. Nach der erfolgreichen Aktualisierung entspricht es dem Wert der serviceLevelObjective-Eigenschaft. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Verwenden Sie die REST-API oder einen der folgenden Befehle, um die SKUs (einschließlich SKU-Name, Ebene/Edition, Familie und Kapazität) zu ermitteln, die `Capabilities_ListByLocation` für Ihr Abonnement in einer Azure-Region verfügbar sind: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
ServiceTierAdvisor	Die Liste der Dienstebenenratgeber für diese Datenbank. Erweiterte Eigenschaft
SloUsageMetric	Ruft serviceLevelObjectiveUsageMetrics für den Dienstebenenratgeber ab oder legt diese fest.
TransparentDataEncryption	Die transparenten Datenverschlüsselungsinformationen für diese Datenbank.
TransparentDataEncryptionStatus	Die status der transparenten Datenverschlüsselung der Datenbank.

CreateMode

Gibt den Modus der Datenbankerstellung an.

Standard: reguläre Datenbankerstellung.

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

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

PointInTimeRestore: Erstellt eine Datenbank, indem eine Zeitpunktsicherung einer vorhandenen Datenbank wiederhergestellt wird. sourceDatabaseId muss als Ressourcen-ID der vorhandenen Datenbank und restorePointInTime angegeben werden.

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

Wiederherstellen: Erstellt eine Datenbank, indem eine Sicherung einer gelöschten Datenbank wiederhergestellt wird. sourceDatabaseId muss angegeben werden. Wenn sourceDatabaseId die ursprüngliche Ressourcen-ID der Datenbank ist, muss sourceDatabaseDeletionDate angegeben werden. Andernfalls muss sourceDatabaseId die wiederherstellbare gelöschte Datenbankressourcen-ID sein, und sourceDatabaseDeletionDate wird ignoriert. restorePointInTime kann auch für die Wiederherstellung von einem früheren Zeitpunkt angegeben werden.

RestoreLongTermRetentionBackup: Erstellt eine Datenbank durch Wiederherstellung aus einem Tresor für die langfristige Aufbewahrung. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden.

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

Name	Typ	Beschreibung
Copy	string
Default	string
NonReadableSecondary	string
OnlineSecondary	string
PointInTimeRestore	string
Recovery	string
Restore	string
RestoreLongTermRetentionBackup	string

Database

Stellt eine Datenbank dar.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
kind	string	Art der Datenbank. Dies sind Metadaten, die für die Azure-Portal-Benutzeroberfläche verwendet werden.
location	string	Ressourcenspeicherort
name	string	Name der Ressource.
properties.collation	string	Die Sortierung der Datenbank. Wenn createMode nicht Standard ist, wird dieser Wert ignoriert.
properties.containmentState	integer	Der Einschlussstatus der Datenbank.
properties.createMode	CreateMode	Gibt den Modus der Datenbankerstellung an. Standard: reguläre Datenbankerstellung. Kopieren: Erstellt eine Datenbank als Kopie einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der Quelldatenbank angegeben werden. OnlineSecondary/NonReadableSecondary: Erstellt eine Datenbank als (lesbares oder nicht lesbares) sekundäres Replikat einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der vorhandenen primären Datenbank angegeben werden. PointInTimeRestore: Erstellt eine Datenbank, indem eine Zeitpunktsicherung einer vorhandenen Datenbank wiederhergestellt wird. sourceDatabaseId muss als Ressourcen-ID der vorhandenen Datenbank und restorePointInTime angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. sourceDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden. Wiederherstellen: Erstellt eine Datenbank, indem eine Sicherung einer gelöschten Datenbank wiederhergestellt wird. sourceDatabaseId muss angegeben werden. Wenn sourceDatabaseId die ursprüngliche Ressourcen-ID der Datenbank ist, muss sourceDatabaseDeletionDate angegeben werden. Andernfalls muss sourceDatabaseId die wiederherstellbare gelöschte Datenbankressourcen-ID sein, und sourceDatabaseDeletionDate wird ignoriert. restorePointInTime kann auch für die Wiederherstellung von einem früheren Zeitpunkt angegeben werden. RestoreLongTermRetentionBackup: Erstellt eine Datenbank durch Wiederherstellung aus einem Tresor für die langfristige Aufbewahrung. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden. Copy, NonReadableSecondary, OnlineSecondary und RestoreLongTermRetentionBackup werden für die DataWarehouse-Edition nicht unterstützt.
properties.creationDate	string	Das Erstellungsdatum der Datenbank (ISO8601 Format).
properties.currentServiceObjectiveId	string	Die aktuelle Ziel-ID des Servicelevels der Datenbank. Dies ist die ID des Dienstlevelziels, das derzeit aktiv ist.
properties.databaseId	string	Die ID der Datenbank.
properties.defaultSecondaryLocation	string	Die sekundäre Standardregion für diese Datenbank.
properties.earliestRestoreDate	string	Dadurch wird das früheste Startdatum und die früheste Wiederherstellungszeit für diese Datenbank (ISO8601 Format) aufgezeichnet.
properties.edition	DatabaseEdition	Die Edition der Datenbank. Die DatabaseEditions-Enumeration enthält alle gültigen Editionen. Wenn createMode nicht lesbarsecondary oder OnlineSecondary ist, wird dieser Wert ignoriert. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Verwenden Sie die REST-API oder einen der folgenden Befehle, um die SKUs (einschließlich SKU-Name, Ebene/Edition, Familie und Kapazität) zu ermitteln, die `Capabilities_ListByLocation` für Ihr Abonnement in einer Azure-Region verfügbar sind: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
properties.elasticPoolName	string	Der Name des Pools für elastische Datenbanken, in dem sich die Datenbank befindet. Wenn elasticPoolName und requestedServiceObjectiveName aktualisiert werden, wird der Wert von requestedServiceObjectiveName ignoriert. Wird für die 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, ausgedrückt in Bytes. Wenn createMode nicht Standard 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 von operationId: "Capabilities_ListByLocation" verwiesen wird.
properties.readScale	ReadScale	Bedingte. 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. Wird für die DataWarehouse-Edition nicht unterstützt.
properties.recommendedIndex	RecommendedIndex[]	Die empfohlenen Indizes für diese Datenbank.
properties.recoveryServicesRecoveryPointResourceId	string	Bedingte. Wenn createMode auf RestoreLongTermRetentionBackup festgelegt ist, ist dieser Wert erforderlich. Gibt die Ressourcen-ID des Wiederherstellungspunkts an, aus dem wiederhergestellt werden soll.
properties.requestedServiceObjectiveId	string	Die konfigurierte Ziel-ID des Servicelevels der Datenbank. Dies ist das Servicelevelziel, das gerade auf die Datenbank angewendet wird. Nach der erfolgreichen Aktualisierung entspricht sie dem Wert der eigenschaft currentServiceObjectiveId. 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. Verwenden Sie die REST-API, um die Dienstziel-IDs zu ermitteln, die `Capabilities_ListByLocation` für Ihr Abonnement in einer Azure-Region verfügbar sind.
properties.requestedServiceObjectiveName	ServiceObjectiveName	Der Name des konfigurierten Servicelevelziels der Datenbank. Dies ist das Servicelevelziel, das gerade auf die Datenbank angewendet wird. Nach der erfolgreichen Aktualisierung entspricht es dem Wert der serviceLevelObjective-Eigenschaft. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Verwenden Sie die REST-API oder einen der folgenden Befehle, um die SKUs (einschließlich SKU-Name, Ebene/Edition, Familie und Kapazität) zu ermitteln, die `Capabilities_ListByLocation` für Ihr Abonnement in einer Azure-Region verfügbar sind: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
properties.restorePointInTime	string	Bedingte. Wenn createMode den Wert PointInTimeRestore aufweist, ist dieser Wert erforderlich. Wenn createMode auf Restore festgelegt ist, ist dieser Wert optional. Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die zum Erstellen der neuen Datenbank wiederhergestellt wird. Muss größer oder gleich dem frühestenRestoreDate-Wert der Quelldatenbank sein.
properties.sampleName	SampleName	Gibt den Namen des Beispielschemas an, das beim Erstellen dieser Datenbank angewendet werden soll. Wenn createMode nicht Standard ist, wird dieser Wert ignoriert. Wird für die DataWarehouse-Edition nicht unterstützt.
properties.serviceLevelObjective	ServiceObjectiveName	Das aktuelle Servicelevelziel der Datenbank.
properties.serviceTierAdvisors	ServiceTierAdvisor[]	Die Liste der Dienstebenenratgeber für diese Datenbank. Erweiterte Eigenschaft
properties.sourceDatabaseDeletionDate	string	Bedingte. Wenn createMode restore ist und sourceDatabaseId die ursprüngliche Ressourcen-ID der gelöschten Datenbank ist, wenn sie vorhanden war (im Gegensatz zur aktuellen wiederherstellbaren gelöschten Datenbank-ID), ist dieser Wert erforderlich. Gibt den Zeitpunkt an, zu dem die Datenbank gelöscht wurde.
properties.sourceDatabaseId	string	Bedingte. Wenn createMode auf Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery oder Restore festgelegt ist, ist dieser Wert erforderlich. Gibt die Ressourcen-ID der Quelldatenbank an. Wenn createMode NichtlesbarSecondary 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	Unabhängig davon, ob diese Datenbank zonenredundant ist, bedeutet dies, dass die Replikate dieser Datenbank auf mehrere Verfügbarkeitszonen verteilt werden.
tags	object	Ressourcentags.
type	string	Der Ressourcentyp.

DatabaseEdition

Die Edition der Datenbank. Die DatabaseEditions-Enumeration enthält alle gültigen Editionen. Wenn createMode nicht lesbarsecondary oder OnlineSecondary ist, wird dieser Wert ignoriert.

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

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

Get-AzSqlServerServiceObjective -Location <location>

Name	Typ	Beschreibung
Basic	string
Business	string
BusinessCritical	string
DataWarehouse	string
Free	string
GeneralPurpose	string
Hyperscale	string
Premium	string
PremiumRS	string
Standard	string
Stretch	string
System	string
System2	string
Web	string

DatabaseUpdate

Die erforderlichen Parameter zum Aktualisieren einer Datenbank.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.collation	string	Die Sortierung der Datenbank. Wenn createMode nicht Standard ist, wird dieser Wert ignoriert.
properties.containmentState	integer	Der Einschlussstatus der Datenbank.
properties.createMode	CreateMode	Gibt den Modus der Datenbankerstellung an. Standard: reguläre Datenbankerstellung. Kopieren: Erstellt eine Datenbank als Kopie einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der Quelldatenbank angegeben werden. OnlineSecondary/NonReadableSecondary: Erstellt eine Datenbank als (lesbares oder nicht lesbares) sekundäres Replikat einer vorhandenen Datenbank. sourceDatabaseId muss als Ressourcen-ID der vorhandenen primären Datenbank angegeben werden. PointInTimeRestore: Erstellt eine Datenbank, indem eine Zeitpunktsicherung einer vorhandenen Datenbank wiederhergestellt wird. sourceDatabaseId muss als Ressourcen-ID der vorhandenen Datenbank und restorePointInTime angegeben werden. Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. sourceDatabaseId muss als wiederherstellbare Datenbankressourcen-ID angegeben werden. Wiederherstellen: Erstellt eine Datenbank, indem eine Sicherung einer gelöschten Datenbank wiederhergestellt wird. sourceDatabaseId muss angegeben werden. Wenn sourceDatabaseId die ursprüngliche Ressourcen-ID der Datenbank ist, muss sourceDatabaseDeletionDate angegeben werden. Andernfalls muss sourceDatabaseId die wiederherstellbare gelöschte Datenbankressourcen-ID sein, und sourceDatabaseDeletionDate wird ignoriert. restorePointInTime kann auch für die Wiederherstellung von einem früheren Zeitpunkt angegeben werden. RestoreLongTermRetentionBackup: Erstellt eine Datenbank durch Wiederherstellung aus einem Tresor für die langfristige Aufbewahrung. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden. Copy, NonReadableSecondary, OnlineSecondary und RestoreLongTermRetentionBackup werden für die DataWarehouse-Edition nicht unterstützt.
properties.creationDate	string	Das Erstellungsdatum der Datenbank (ISO8601 Format).
properties.currentServiceObjectiveId	string	Die aktuelle Ziel-ID des Servicelevels der Datenbank. Dies ist die ID des Dienstlevelziels, das derzeit aktiv ist.
properties.databaseId	string	Die ID der Datenbank.
properties.defaultSecondaryLocation	string	Die sekundäre Standardregion für diese Datenbank.
properties.earliestRestoreDate	string	Dadurch wird das früheste Startdatum und die früheste Wiederherstellungszeit für diese Datenbank (ISO8601 Format) aufgezeichnet.
properties.edition	DatabaseEdition	Die Edition der Datenbank. Die DatabaseEditions-Enumeration enthält alle gültigen Editionen. Wenn createMode nicht lesbarsecondary oder OnlineSecondary ist, wird dieser Wert ignoriert. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Verwenden Sie die REST-API oder einen der folgenden Befehle, um die SKUs (einschließlich SKU-Name, Ebene/Edition, Familie und Kapazität) zu ermitteln, die `Capabilities_ListByLocation` für Ihr Abonnement in einer Azure-Region verfügbar sind: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
properties.elasticPoolName	string	Der Name des Pools für elastische Datenbanken, in dem sich die Datenbank befindet. Wenn elasticPoolName und requestedServiceObjectiveName aktualisiert werden, wird der Wert von requestedServiceObjectiveName ignoriert. Wird für die 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, ausgedrückt in Bytes. Wenn createMode nicht Standard 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 von operationId: "Capabilities_ListByLocation" verwiesen wird.
properties.readScale	ReadScale	Bedingte. 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. Wird für die DataWarehouse-Edition nicht unterstützt.
properties.recommendedIndex	RecommendedIndex[]	Die empfohlenen Indizes für diese Datenbank.
properties.recoveryServicesRecoveryPointResourceId	string	Bedingte. Wenn createMode auf RestoreLongTermRetentionBackup festgelegt ist, ist dieser Wert erforderlich. Gibt die Ressourcen-ID des Wiederherstellungspunkts an, aus dem wiederhergestellt werden soll.
properties.requestedServiceObjectiveId	string	Die konfigurierte Ziel-ID des Servicelevels der Datenbank. Dies ist das Servicelevelziel, das gerade auf die Datenbank angewendet wird. Nach der erfolgreichen Aktualisierung entspricht sie dem Wert der eigenschaft currentServiceObjectiveId. 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. Verwenden Sie die REST-API, um die Dienstziel-IDs zu ermitteln, die `Capabilities_ListByLocation` für Ihr Abonnement in einer Azure-Region verfügbar sind.
properties.requestedServiceObjectiveName	ServiceObjectiveName	Der Name des konfigurierten Servicelevelziels der Datenbank. Dies ist das Servicelevelziel, das gerade auf die Datenbank angewendet wird. Nach der erfolgreichen Aktualisierung entspricht es dem Wert der serviceLevelObjective-Eigenschaft. Die Liste der SKUs kann je nach Region und Supportangebot variieren. Verwenden Sie die REST-API oder einen der folgenden Befehle, um die SKUs (einschließlich SKU-Name, Ebene/Edition, Familie und Kapazität) zu ermitteln, die `Capabilities_ListByLocation` für Ihr Abonnement in einer Azure-Region verfügbar sind: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
properties.restorePointInTime	string	Bedingte. Wenn createMode den Wert PointInTimeRestore aufweist, ist dieser Wert erforderlich. Wenn createMode auf Restore festgelegt ist, ist dieser Wert optional. Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die zum Erstellen der neuen Datenbank wiederhergestellt wird. Muss größer oder gleich dem frühestenRestoreDate-Wert der Quelldatenbank sein.
properties.sampleName	SampleName	Gibt den Namen des Beispielschemas an, das beim Erstellen dieser Datenbank angewendet werden soll. Wenn createMode nicht Standard ist, wird dieser Wert ignoriert. Wird für die DataWarehouse-Edition nicht unterstützt.
properties.serviceLevelObjective	ServiceObjectiveName	Das aktuelle Servicelevelziel der Datenbank.
properties.serviceTierAdvisors	ServiceTierAdvisor[]	Die Liste der Dienstebenenratgeber für diese Datenbank. Erweiterte Eigenschaft
properties.sourceDatabaseDeletionDate	string	Bedingte. Wenn createMode restore ist und sourceDatabaseId die ursprüngliche Ressourcen-ID der gelöschten Datenbank ist, wenn sie vorhanden war (im Gegensatz zur aktuellen wiederherstellbaren gelöschten Datenbank-ID), ist dieser Wert erforderlich. Gibt den Zeitpunkt an, zu dem die Datenbank gelöscht wurde.
properties.sourceDatabaseId	string	Bedingte. Wenn createMode auf Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery oder Restore festgelegt ist, ist dieser Wert erforderlich. Gibt die Ressourcen-ID der Quelldatenbank an. Wenn createMode NichtlesbarSecondary 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	Unabhängig davon, ob diese Datenbank zonenredundant ist, bedeutet dies, dass die Replikate dieser Datenbank auf mehrere Verfügbarkeitszonen verteilt werden.
tags	object	Ressourcentags.
type	string	Der Ressourcentyp.

OperationImpact

Die geschätzten Auswirkungen der Durchführung empfohlener Indexaktionen.

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

ReadScale

Bedingte. 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. Wird für die DataWarehouse-Edition nicht unterstützt.

Name	Typ	Beschreibung
Disabled	string
Enabled	string

RecommendedIndex

Die empfohlenen Indizes für diese Datenbank.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.action	RecommendedIndexAction	Die vorgeschlagene Indexaktion. Sie können einen fehlenden Index erstellen, einen nicht verwendeten Index löschen oder einen vorhandenen Index neu erstellen, um die Leistung zu verbessern.
properties.columns	string[]	Spalten, über die der Index erstellt werden soll
properties.created	string	Die UTC-Datetime, die zeigt, wann diese Ressource erstellt wurde (ISO8601 Format).
properties.estimatedImpact	OperationImpact[]	Die geschätzten Auswirkungen der Durchführung empfohlener Indexaktionen.
properties.includedColumns	string[]	Die Liste der Spaltennamen, die in den Index aufgenommen werden sollen
properties.indexScript	string	Das vollständige Buildindexskript
properties.indexType	RecommendedIndexType	Der Indextyp (CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)
properties.lastModified	string	Die UTC-Datum/Uhrzeit der letzten Änderung dieser Ressource (ISO8601 Format).
properties.reportedImpact	OperationImpact[]	Die nach Abschluss der Indexaktion gemeldeten Werte.
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, für die der Index erstellt werden soll.
type	string	Der Ressourcentyp.

RecommendedIndexAction

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

Name	Typ	Beschreibung
Create	string
Drop	string
Rebuild	string

RecommendedIndexState

Der aktuelle Empfehlungsstatus.

Name	Typ	Beschreibung
Active	string
Blocked	string
Executing	string
Expired	string
Ignored	string
Pending	string
Pending Revert	string
Reverted	string
Reverting	string
Success	string
Verifying	string

RecommendedIndexType

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

Name	Typ	Beschreibung
CLUSTERED	string
CLUSTERED COLUMNSTORE	string
COLUMNSTORE	string
NONCLUSTERED	string

SampleName

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

Name	Typ	Beschreibung
AdventureWorksLT	string

ServiceObjectiveName

Der Name des konfigurierten Servicelevelziels der Datenbank. Dies ist das Servicelevelziel, das gerade auf die Datenbank angewendet wird. Nach der erfolgreichen Aktualisierung entspricht es dem Wert der serviceLevelObjective-Eigenschaft.

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

Get-AzSqlServerServiceObjective -Location <location>

Name	Typ	Beschreibung
Basic	string
DS100	string
DS1000	string
DS1200	string
DS1500	string
DS200	string
DS2000	string
DS300	string
DS400	string
DS500	string
DS600	string
DW100	string
DW1000	string
DW10000c	string
DW1000c	string
DW1200	string
DW1500	string
DW15000c	string
DW1500c	string
DW200	string
DW2000	string
DW2000c	string
DW2500c	string
DW300	string
DW3000	string
DW30000c	string
DW3000c	string
DW400	string
DW500	string
DW5000c	string
DW600	string
DW6000	string
DW6000c	string
DW7500c	string
ElasticPool	string
Free	string
P1	string
P11	string
P15	string
P2	string
P3	string
P4	string
P6	string
PRS1	string
PRS2	string
PRS4	string
PRS6	string
S0	string
S1	string
S12	string
S2	string
S3	string
S4	string
S6	string
S7	string
S9	string
System	string
System0	string
System1	string
System2	string
System2L	string
System3	string
System3L	string
System4	string
System4L	string

ServiceTierAdvisor

Die Liste der Dienstebenenratgeber für diese Datenbank. Erweiterte Eigenschaft

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.activeTimeRatio	number	ActiveTimeRatio für den Dienstebenenratgeber.
properties.avgDtu	number	Ruft avgDtu für den Dienstebenenratgeber ab oder legt diese fest.
properties.confidence	number	Ruft die Zuverlässigkeit für den Dienstebenenratgeber ab oder legt diese fest.
properties.currentServiceLevelObjective	string	Ruft currentServiceLevelObjective für den Dienstebenenratgeber ab oder legt diesen fest.
properties.currentServiceLevelObjectiveId	string	Ruft currentServiceLevelObjectiveId für den Dienstebenenratgeber ab oder legt diese fest.
properties.databaseSizeBasedRecommendationServiceLevelObjective	string	Ruft databaseSizeBasedRecommendationServiceLevelObjective für den Dienstebenenratgeber ab oder legt diese fest.
properties.databaseSizeBasedRecommendationServiceLevelObjectiveId	string	Ruft databaseSizeBasedRecommendationServiceLevelObjectiveId für den Dienstebenenratgeber ab oder legt diese fest.
properties.disasterPlanBasedRecommendationServiceLevelObjective	string	Ruft disasterPlanBasedRecommendationServiceLevelObjective für den Dienstebenenratgeber ab oder legt diesen fest.
properties.disasterPlanBasedRecommendationServiceLevelObjectiveId	string	Ruft disasterPlanBasedRecommendationServiceLevelObjectiveId für den Dienstebenenratgeber ab oder legt diesen fest.
properties.maxDtu	number	Ruft maxDtu für den Dienstebenenratgeber ab oder legt diese fest.
properties.maxSizeInGB	number	Ruft maxSizeInGB für den Dienstebenenratgeber ab oder legt diese fest.
properties.minDtu	number	Ruft minDtu für den Dienstebenenratgeber ab oder legt diese fest.
properties.observationPeriodEnd	string	Der Beobachtungszeitraum beginnt (ISO8601 Format).
properties.observationPeriodStart	string	Der Beobachtungszeitraum beginnt (ISO8601 Format).
properties.overallRecommendationServiceLevelObjective	string	Ruft overallRecommendationServiceLevelObjective für den Dienstebenenratgeber ab oder legt dieses fest.
properties.overallRecommendationServiceLevelObjectiveId	string	Ruft overallRecommendationServiceLevelObjectiveId für den Dienstebenenratgeber ab oder legt diese fest.
properties.serviceLevelObjectiveUsageMetrics	SloUsageMetric[]	Ruft serviceLevelObjectiveUsageMetrics für den Dienstebenenratgeber ab oder legt diese fest.
properties.usageBasedRecommendationServiceLevelObjective	string	Ruft usageBasedRecommendationServiceLevelObjective für den Dienstebenenratgeber ab oder legt diesen fest.
properties.usageBasedRecommendationServiceLevelObjectiveId	string	Ruft usageBasedRecommendationServiceLevelObjectiveId für den Dienstebenenratgeber ab oder legt diese fest.
type	string	Der Ressourcentyp.

SloUsageMetric

Ruft serviceLevelObjectiveUsageMetrics für den Dienstebenenratgeber ab oder legt diese fest.

Name	Typ	Beschreibung
inRangeTimeRatio	number	Ruft inRangeTimeRatio für die SLO-Nutzungsmetrik ab oder legt diese fest.
serviceLevelObjective	ServiceObjectiveName	Die Metrik serviceLevelObjective für die SLO-Verwendung.
serviceLevelObjectiveId	string	Die ServiceLevelObjectiveId für die SLO-Nutzungsmetrik.

TransparentDataEncryption

Die transparenten Datenverschlüsselungsinformationen für diese Datenbank.

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

TransparentDataEncryptionStatus

Die status der transparenten Datenverschlüsselung der Datenbank.

Name	Typ	Beschreibung
Disabled	string
Enabled	string

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

Zusätzliche Ressourcen