Databases - Get

Ruft eine Datenbank ab

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}?api-version=2020-11-01-preview

URI-Parameter

Name In Required Type Description
databaseName
path True
  • string

Der Name der Datenbank.

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.

Antworten

Name Type Description
200 OK

Die angegebene Datenbank wurde erfolgreich abgerufen.

Other Status Codes

Fehlerantworten: ***

  • 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.

  • 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist nicht in der angegebenen Ressourcengruppe und im Abonnement vorhanden.

  • 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden.

Beispiele

Gets a database.

Sample Request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2020-11-01-preview

Sample Response

{
  "sku": {
    "name": "BC_Gen5",
    "tier": "BusinessCritical",
    "capacity": 2
  },
  "kind": "v12.0,user,vcore",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen5_2",
    "requestedServiceObjectiveName": "BC_Gen5_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "zoneRedundant": false,
    "readScale": "Enabled",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "currentSku": {
      "name": "BC_Gen5",
      "tier": "BusinessCritical",
      "capacity": 2
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Definitionen

CatalogCollationType

Sortierung des Metadatenkatalogs.

CreateMode

Gibt den Modus der Datenbankerstellung an.

Standard: regelmäßige 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 ein Punkt in der Zeitsicherung einer vorhandenen Datenbank wiederhergestellt wird. sourceDatabaseId muss als Ressourcen-ID der vorhandenen Datenbank angegeben werden und WiederherstellungsPointInTime muss angegeben werden.

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

Wiederherstellung: 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 wiederherstellende Datenbankressourcen-ID sein und sourceDatabaseDeletionDate ignoriert werden. RestorePointInTime kann auch angegeben werden, um von einem früheren Zeitpunkt aus wiederherzustellen.

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

Kopieren, Sekundäre und RestoreLongTermRetentionBackup werden für die DataWarehouse-Edition nicht unterstützt.

CurrentBackupStorageRedundancy

Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Datenbank verwendet wird.

Database

Eine Datenbankressource.

DatabaseLicenseType

Der Lizenztyp, der für diese Datenbank angewendet werden soll. LicenseIncludedwenn Sie eine Lizenz benötigen oder über eine Lizenz verfügen und BasePrice für die Azure-Hybridvorteil berechtigt sind.

DatabaseReadScale

Der Zustand des schreibgeschützten Routings. Wenn dies aktiviert ist, werden Verbindungen mit Anwendungsabsicht auf Lesezugriff in ihrem Verbindungszeichenfolge möglicherweise an ein readonly sekundäres Replikat in derselben Region weitergeleitet.

DatabaseStatus

Der Status der Datenbank.

RequestedBackupStorageRedundancy

Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Datenbank verwendet werden soll.

SampleName

Der Name des Beispielschemas, das beim Erstellen dieser Datenbank angewendet werden soll.

SecondaryType

Der sekundäre Typ der Datenbank, wenn es sich um eine sekundäre Datei handelt. Gültige Werte sind Geo und Benannt.

Sku

Eine ARM-Ressourcen-SKU.

CatalogCollationType

Sortierung des Metadatenkatalogs.

Name Type Description
DATABASE_DEFAULT
  • string
SQL_Latin1_General_CP1_CI_AS
  • string

CreateMode

Gibt den Modus der Datenbankerstellung an.

Standard: regelmäßige 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 ein Punkt in der Zeitsicherung einer vorhandenen Datenbank wiederhergestellt wird. sourceDatabaseId muss als Ressourcen-ID der vorhandenen Datenbank angegeben werden und WiederherstellungsPointInTime muss angegeben werden.

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

Wiederherstellung: 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 wiederherstellende Datenbankressourcen-ID sein und sourceDatabaseDeletionDate ignoriert werden. RestorePointInTime kann auch angegeben werden, um von einem früheren Zeitpunkt aus wiederherzustellen.

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

Kopieren, Sekundäre und RestoreLongTermRetentionBackup werden für die DataWarehouse-Edition nicht unterstützt.

Name Type Description
Copy
  • string
Default
  • string
OnlineSecondary
  • string
PointInTimeRestore
  • string
Recovery
  • string
Restore
  • string
RestoreExternalBackup
  • string
RestoreExternalBackupSecondary
  • string
RestoreLongTermRetentionBackup
  • string
Secondary
  • string

CurrentBackupStorageRedundancy

Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Datenbank verwendet wird.

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

Database

Eine Datenbankressource.

Name Type Description
id
  • string

Ressourcen-ID

kind
  • string

Art der Datenbank. Dies ist Metadaten, die für die Azure-Portal Erfahrung verwendet werden.

location
  • string

Ressourcenspeicherort

managedBy
  • string

Ressource, die die Datenbank verwaltet.

name
  • string

Name der Ressource.

properties.autoPauseDelay
  • integer

Zeit in Minuten, nach denen die Datenbank automatisch angehalten wird. Ein Wert von -1 bedeutet, dass die automatische Pause deaktiviert ist

properties.catalogCollation

Sortierung des Metadatenkatalogs.

properties.collation
  • string

Die Sortierung der Datenbank.

properties.createMode

Gibt den Modus der Datenbankerstellung an.

Standard: regelmäßige 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 ein Punkt in der Zeitsicherung einer vorhandenen Datenbank wiederhergestellt wird. sourceDatabaseId muss als Ressourcen-ID der vorhandenen Datenbank angegeben werden und WiederherstellungsPointInTime muss angegeben werden.

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

Wiederherstellung: 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 wiederherstellende Datenbankressourcen-ID sein und sourceDatabaseDeletionDate ignoriert werden. RestorePointInTime kann auch angegeben werden, um von einem früheren Zeitpunkt aus wiederherzustellen.

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

Kopieren, Sekundäre und RestoreLongTermRetentionBackup werden für die DataWarehouse-Edition nicht unterstützt.

properties.creationDate
  • string

Das Erstellungsdatum der Datenbank (ISO8601-Format).

properties.currentBackupStorageRedundancy

Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Datenbank verwendet wird.

properties.currentServiceObjectiveName
  • string

Der aktuelle Zielname der Dienstebene der Datenbank.

properties.currentSku

Der Name und die Ebene der SKU.

properties.databaseId
  • string

Die ID der Datenbank.

properties.defaultSecondaryLocation
  • string

Der Standard sekundäre Bereich für diese Datenbank.

properties.earliestRestoreDate
  • string

Dies zeichnet das früheste Startdatum und die Uhrzeit auf, die für diese Datenbank verfügbar ist (ISO8601-Format).

properties.elasticPoolId
  • string

Der Ressourcenbezeichner des elastischen Pools, der diese Datenbank enthält.

properties.failoverGroupId
  • string

Failovergruppe-Ressourcenbezeichner, zu dem diese Datenbank gehört.

properties.highAvailabilityReplicaCount
  • integer

Die Anzahl der sekundären Replikate, die der Datenbank zugeordnet sind, die verwendet werden, um hohe Verfügbarkeit bereitzustellen.

properties.licenseType

Der Lizenztyp, der für diese Datenbank angewendet werden soll. LicenseIncludedwenn Sie eine Lizenz benötigen oder über eine Lizenz verfügen und BasePrice für die Azure-Hybridvorteil berechtigt sind.

properties.longTermRetentionBackupResourceId
  • string

Der Ressourcenbezeichner der langfristigen Aufbewahrungssicherung, die dem Erstellen des Vorgangs dieser Datenbank zugeordnet ist.

properties.maintenanceConfigurationId
  • string

Wartungskonfigurations-ID, die der Datenbank zugewiesen ist. Diese Konfiguration definiert den Zeitraum, in dem die Wartungsupdates auftreten.

properties.maxLogSizeBytes
  • integer

Die maximale Protokollgröße für diese Datenbank.

properties.maxSizeBytes
  • integer

Die maximale Größe der Datenbank, die in Bytes ausgedrückt wird.

properties.minCapacity
  • number

Minimale Kapazität, die die Datenbank immer zugewiesen hat, wenn nicht angehalten

properties.pausedDate
  • string

Das Datum, an dem die Datenbank von der Benutzerkonfiguration oder -aktion angehalten wurde(ISO8601-Format). Null, wenn die Datenbank bereit ist.

properties.readScale

Der Zustand des schreibgeschützten Routings. Wenn dies aktiviert ist, werden Verbindungen mit Anwendungsabsicht auf Lesezugriff in ihrem Verbindungszeichenfolge möglicherweise an ein readonly sekundäres Replikat in derselben Region weitergeleitet.

properties.recoverableDatabaseId
  • string

Der Ressourcenbezeichner der wiederherstellbaren Datenbank, die dem Erstellen des Vorgangs dieser Datenbank zugeordnet ist.

properties.recoveryServicesRecoveryPointId
  • string

Der Ressourcenbezeichner des Wiederherstellungspunkts, der dem Erstellen des Vorgangs dieser Datenbank zugeordnet ist.

properties.requestedBackupStorageRedundancy

Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Datenbank verwendet werden soll.

properties.requestedServiceObjectiveName
  • string

Der angeforderte Zielname der Dienstebene der Datenbank.

properties.restorableDroppedDatabaseId
  • string

Der Ressourcenbezeichner der abgesetzten Datenbank, die dem Erstellen des Vorgangs dieser Datenbank zugeordnet ist.

properties.restorePointInTime
  • string

Gibt den Zeitpunkt (ISO8601-Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen.

properties.resumedDate
  • string

Das Datum, an dem die Datenbank durch Benutzeraktion oder Datenbankanmeldung fortgesetzt wurde (ISO8601-Format). Null, wenn die Datenbank angehalten wird.

properties.sampleName

Der Name des Beispielschemas, das beim Erstellen dieser Datenbank angewendet werden soll.

properties.secondaryType

Der sekundäre Typ der Datenbank, wenn es sich um eine sekundäre Datei handelt. Gültige Werte sind Geo und Benannt.

properties.sourceDatabaseDeletionDate
  • string

Gibt die Uhrzeit an, zu der die Datenbank gelöscht wurde.

properties.sourceDatabaseId
  • string

Der Ressourcenbezeichner der Quelldatenbank, die dem Erstellen des Vorgangs dieser Datenbank zugeordnet ist.

properties.status

Der Status der Datenbank.

properties.zoneRedundant
  • boolean

Ob diese Datenbank zone redundant ist, was bedeutet, dass die Replikate dieser Datenbank über mehrere Verfügbarkeitszonen verteilt werden.

sku

Die Datenbank-SKU.

Die Liste der SKUs kann je nach Region und Supportangebot variieren. Um die SKUs (einschließlich des SKU-Namens, der Ebene/Edition, der Familie und der Kapazität) zu bestimmen, 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>
tags
  • object

Ressourcentags.

type
  • string

Der Ressourcentyp.

DatabaseLicenseType

Der Lizenztyp, der für diese Datenbank angewendet werden soll. LicenseIncludedwenn Sie eine Lizenz benötigen oder über eine Lizenz verfügen und BasePrice für die Azure-Hybridvorteil berechtigt sind.

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

DatabaseReadScale

Der Zustand des schreibgeschützten Routings. Wenn dies aktiviert ist, werden Verbindungen mit Anwendungsabsicht auf Lesezugriff in ihrem Verbindungszeichenfolge möglicherweise an ein readonly sekundäres Replikat in derselben Region weitergeleitet.

Name Type Description
Disabled
  • string
Enabled
  • string

DatabaseStatus

Der Status der Datenbank.

Name Type Description
AutoClosed
  • string
Copying
  • string
Creating
  • string
Disabled
  • string
EmergencyMode
  • string
Inaccessible
  • string
Offline
  • string
OfflineChangingDwPerformanceTiers
  • string
OfflineSecondary
  • string
Online
  • string
OnlineChangingDwPerformanceTiers
  • string
Paused
  • string
Pausing
  • string
Recovering
  • string
RecoveryPending
  • string
Restoring
  • string
Resuming
  • string
Scaling
  • string
Shutdown
  • string
Standby
  • string
Suspect
  • string

RequestedBackupStorageRedundancy

Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Datenbank verwendet werden soll.

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

SampleName

Der Name des Beispielschemas, das beim Erstellen dieser Datenbank angewendet werden soll.

Name Type Description
AdventureWorksLT
  • string
WideWorldImportersFull
  • string
WideWorldImportersStd
  • string

SecondaryType

Der sekundäre Typ der Datenbank, wenn es sich um eine sekundäre Datei handelt. Gültige Werte sind Geo und Benannt.

Name Type Description
Geo
  • string
Named
  • string

Sku

Eine ARM-Ressourcen-SKU.

Name Type Description
capacity
  • integer

Kapazität der bestimmten SKU.

family
  • string

Wenn der Dienst unterschiedliche Hardwaregenerationen aufweist, dann kann dies hier erfasst werden.

name
  • string

Der Name der SKU, in der Regel ein Buchstaben + Zahlencode, z. B. P3.

size
  • string

Größe der bestimmten SKU

tier
  • string

Die Ebene oder Edition der bestimmten SKU, z. B. Basic, Premium.