Freigeben über


Database Klasse

Definition

Eine Datenbankressource.

[Microsoft.Rest.Serialization.JsonTransformation]
public class Database : Microsoft.Azure.Management.Sql.Models.TrackedResource
[<Microsoft.Rest.Serialization.JsonTransformation>]
type Database = class
    inherit TrackedResource
Public Class Database
Inherits TrackedResource
Vererbung
Attribute

Konstruktoren

Database()

Initialisiert eine neue instance der Database-Klasse.

Database(String, String, String, String, IDictionary<String,String>, Sku, String, String, DatabaseIdentity, String, String, Nullable<Int64>, String, String, String, String, Nullable<Guid>, Nullable<DateTime>, String, String, String, String, Nullable<DateTime>, Nullable<DateTime>, String, String, String, String, String, Nullable<Boolean>, String, Nullable<Int64>, Nullable<DateTime>, String, Nullable<Int32>, String, Sku, Nullable<Int32>, String, String, Nullable<Double>, Nullable<DateTime>, Nullable<DateTime>, String, Nullable<Boolean>, Nullable<Boolean>, Nullable<Guid>, String)

Initialisiert eine neue instance der Database-Klasse.

Eigenschaften

AutoPauseDelay

Ruft die Zeit in Minuten ab, nach der die Datenbank automatisch angehalten wird, oder legt diese fest. Der Wert -1 bedeutet, dass die automatische Pause deaktiviert ist.

CatalogCollation

Ruft die Sortierung des Metadatenkatalogs ab oder legt diese fest. Mögliche Werte: "DATABASE_DEFAULT", "SQL_Latin1_General_CP1_CI_AS"

Collation

Ruft die Sortierung der Datenbank ab oder legt diese fest.

CreateMode

Ruft ab oder legt den Modus der Datenbankerstellung fest.

Standard: Reguläre Datenbankerstellung.

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

Sekundär: Erstellt eine Datenbank als 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 angegeben werden, und restorePointInTime muss angegeben werden.

Wiederherstellung: Erstellt eine Datenbank, indem eine georeplizierte Sicherung wiederhergestellt wird. sourceDatabaseId muss als wiederherzustellende 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 Wiederherstellen aus einem langfristigen Aufbewahrungstresor. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden.

Copy, Secondary und RestoreLongTermRetentionBackup werden für die DataWarehouse-Edition nicht unterstützt. Mögliche Werte: "Default", "Copy", "Secondary", "PointInTimeRestore", "Restore", "Recovery", "RestoreExternalBackup", "RestoreExternalBackupSecondary", "RestoreLongTermRetentionBackup", "OnlineSecondary"

CreationDate

Ruft das Erstellungsdatum der Datenbank ab (ISO8601-Format).

CurrentBackupStorageRedundancy

Ruft den Speicherkontotyp ab, der zum Speichern von Sicherungen für diese Datenbank verwendet wird. Mögliche Werte: "Geo", "Local", "Zone", "GeoZone"

CurrentServiceObjectiveName

Ruft den aktuellen Zielnamen für den Servicelevel der Datenbank ab.

CurrentSku

Ruft den Namen und die Ebene der SKU ab.

DatabaseId

Ruft die ID der Datenbank ab.

DefaultSecondaryLocation

Ruft die sekundäre Standardregion für diese Datenbank ab.

EarliestRestoreDate

Ruft mit dieser Methode das früheste Startdatum und die früheste Uhrzeit ab, zu der die Wiederherstellung für diese Datenbank verfügbar ist (ISO8601-Format).

Edition

Ruft die Edition der Datenbank ab. Wenn createMode OnlineSecondary 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, oder verwenden Sie den Azure CLI-Befehl az sql db list-editions -l westus --query[].name. Mögliche Werte: "Web", "Business", "Basic", "Standard", "Premium", "PremiumRS", "Free", "Stretch", "DataWarehouse", "System", "System2"

ElasticPoolId

Ruft den Ressourcenbezeichner des Pools für elastische Datenbanken ab, der diese Datenbank enthält, oder legt diesen fest.

ElasticPoolName

Ruft den Namen des Pools für elastische Datenbanken ab, 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.

FailoverGroupId

Ruft den Ressourcenbezeichner der Failovergruppe ab, zu dem diese Datenbank gehört.

FederatedClientId

Ruft die Client-ID ab, die für mandantenübergreifendes CMK-Szenario pro Datenbank verwendet wird, oder legt sie fest.

HighAvailabilityReplicaCount

Ruft die Anzahl der sekundären Replikate ab, die der Datenbank zugeordnet sind, die zur Bereitstellung von Hochverfügbarkeit verwendet werden, oder legt diese fest. Gilt nicht für eine Hyperscale-Datenbank in einem Pool für elastische Datenbanken.

Id

Ruft die Ressourcen-ID ab

(Geerbt von Resource)
Identity

Ruft die Azure Active Directory-Identität der Datenbank ab oder legt diese fest.

IsInfraEncryptionEnabled

Ruft die Infrastrukturverschlüsselung ab, die für diese Datenbank aktiviert ist.

IsLedgerOn

Ruft ab oder legt fest, ob es sich bei dieser Datenbank um eine Ledgerdatenbank handelt, was bedeutet, dass alle Tabellen in der Datenbank Ledgertabellen sind. Hinweis: Der Wert dieser Eigenschaft kann nicht geändert werden, nachdem die Datenbank erstellt wurde.

Kind

Ruft die Art der Datenbank ab. Dies sind Metadaten, die für die Azure-Portal-Benutzeroberfläche verwendet werden.

LicenseType

Ruft den Lizenztyp ab, der für diese Datenbank angewendet werden soll, oder legt diesen fest. LicenseIncluded, wenn Sie eine Lizenz benötigen oder BasePrice über eine Lizenz verfügen und für die Azure-Hybridvorteil berechtigt sind. Mögliche Werte: "LicenseIncluded", "BasePrice"

Location

Ruft den Ressourcenspeicherort ab oder legt diese fest.

(Geerbt von TrackedResource)
LongTermRetentionBackupResourceId

Ruft den Ressourcenbezeichner der langfristigen Aufbewahrungssicherung ab, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist, oder legt diesen fest.

MaintenanceConfigurationId

Ruft die der Datenbank zugewiesene Wartungskonfigurations-ID ab oder legt diese fest. Diese Konfiguration definiert den Zeitraum, in dem die Wartungsupdates durchgeführt werden.

ManagedBy

Ruft eine Ressource ab, die die Datenbank verwaltet.

MaxLogSizeBytes

Ruft die maximale Protokollgröße für diese Datenbank ab.

MaxSizeBytes

Ruft die maximale Größe der In Bytes ausgedrückten Datenbank ab oder legt diese fest.

MinCapacity

Ruft die minimale Kapazität ab, die die Datenbank immer zugewiesen hat, wenn sie nicht angehalten wird, oder legt sie fest.

Name

Ruft den Ressourcennamen ab.

(Geerbt von Resource)
PausedDate

Ruft das Datum ab, an dem die Datenbank durch Benutzerkonfiguration oder Aktion angehalten wurde (ISO8601-Format). NULL, wenn die Datenbank bereit ist.

ReadScale

Ruft den Zustand des schreibgeschützten Routings ab oder legt diese fest. Wenn diese Option aktiviert ist, können Verbindungen, deren Anwendungsabsicht in ihrer Verbindungszeichenfolge auf schreibonly festgelegt ist, an ein schreibgeschütztes sekundäres Replikat in derselben Region weitergeleitet werden. Gilt nicht für eine Hyperscale-Datenbank in einem Pool für elastische Datenbanken. Mögliche Werte sind: "Aktiviert", "Deaktiviert".

RecoverableDatabaseId

Ruft den Ressourcenbezeichner der wiederherstellbaren Datenbank ab, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist, oder legt diesen fest.

RecoveryServicesRecoveryPointId

Ruft den Ressourcenbezeichner des Wiederherstellungspunkts ab, der dem Erstellungsvorgang dieser Datenbank zugeordnet ist, oder legt diesen fest.

RequestedBackupStorageRedundancy

Ruft den Speicherkontotyp ab, der zum Speichern von Sicherungen für diese Datenbank verwendet werden soll, oder legt diesen fest. Mögliche Werte: "Geo", "Local", "Zone", "GeoZone"

RequestedServiceObjectiveName

Ruft den angeforderten Zielnamen der Datenbank ab.

RestorableDroppedDatabaseId

Ruft den Ressourcenbezeichner der wiederherstellbaren gelöschten Datenbank ab, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist, oder legt diesen fest.

RestorePointInTime

Ruft ab oder legt den Zeitpunkt (ISO8601-Format) der Quelldatenbank fest, die zum Erstellen der neuen Datenbank wiederhergestellt wird.

ResumedDate

Ruft das Datum ab, an dem die Datenbank durch eine Benutzeraktion oder Datenbankanmeldung fortgesetzt wurde (ISO8601-Format). NULL, wenn die Datenbank angehalten wird.

SampleName

Ruft den Namen des Beispielschemas ab, das beim Erstellen dieser Datenbank angewendet werden soll, oder legt diesen fest. Mögliche Werte: "AdventureWorksLT", "WideWorldImportersStd", "WideWorldImportersFull"

SecondaryType

Ruft den sekundären Typ der Datenbank ab, wenn es sich um einen sekundären Typ handelt, oder legt ihn fest. Gültige Werte sind Geo und Benannt. Mögliche Werte: "Geo", "Benannt"

ServiceLevelObjective

Ruft das aktuelle Servicelevelziel der Datenbank ab.

Sku

Ruft die Datenbank-SKU ab oder legt sie fest.

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, Tarif/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 &amp;lt;location&amp;gt; -o table
Get-AzSqlServerServiceObjective -Location &amp;lt;location&amp;gt;
SourceDatabaseDeletionDate

Ruft ab oder legt fest, zu dem die Datenbank gelöscht wurde.

SourceDatabaseId

Ruft den Ressourcenbezeichner der Quelldatenbank ab, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist, oder legt diesen fest.

SourceResourceId

Ruft den Ressourcenbezeichner der Quelle ab, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist, oder legt diesen fest.

Wenn sourceResourceId angegeben wird, dürfen sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId und sourceDatabaseDeletionDate nicht angegeben werden, und CreateMode muss PointInTimeRestore, Restore oder Recover sein.

Wenn createMode PointInTimeRestore ist, muss sourceResourceId die Ressourcen-ID einer vorhandenen Datenbank oder eines vorhandenen SQL-Pools sein, und restorePointInTime muss angegeben werden.

Wenn createMode restore ist, muss sourceResourceId die Ressourcen-ID der wiederherstellbaren gelöschten Datenbank oder des wiederherstellbaren gelöschten SQL-Pools sein.

Wenn createMode Wiederherstellen ist, muss sourceResourceId die Ressourcen-ID der wiederherstellbaren Datenbank oder des wiederherstellbaren SQL-Pools sein.

Diese Eigenschaft ermöglicht die Abonnementwiederherstellung, die nur für die DataWarehouse-Edition unterstützt wird.

Wenn das Quellabonnement zu einem anderen Mandanten als dem Zielabonnement gehört, muss der Header "x-ms-authorization-auxiliary" ein Authentifizierungstoken für den Quellmandanten enthalten. Weitere Informationen zum Header "x-ms-authorization-auxiliary" finden Sie unter https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant

Status

Ruft die status der Datenbank ab. Mögliche Werte sind: "Online", "Restoreing", "RecoveryPending", "Recovering", "Suspect", "Offline", "Standby", "Shutdown", "EmergencyMode", "AutoClosed", "Copying", "Creating", "Inaccessible", "OfflineSecondary", "Pausing", "Paused", "Resuming", "Scaling", "OfflineChangingDwPerformanceTiers", "OnlineChangingDwPerformanceTiers", "Disabled", "Stop", "Stopped", "Starting"

Tags

Ruft Ressourcentags ab oder legt diese fest.

(Geerbt von TrackedResource)
Type

Ruft den Ressourcentyp ab.

(Geerbt von Resource)
ZoneRedundant

Ruft ab oder legt fest, ob diese Datenbank zonenredundant ist, was bedeutet, dass die Replikate dieser Datenbank auf mehrere Verfügbarkeitszonen verteilt werden.

Methoden

Validate()

Überprüfen Sie das Objekt.

Gilt für: