Databases - Get

Ruft eine Datenbank ab

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}?api-version=2021-02-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

Der 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 in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht 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=2021-02-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,
    "isInfraEncryptionEnabled": false,
    "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",
    "isLedgerOn": false
  },
  "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: 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 durch Wiederherstellen einer georeplizierten Sicherung. 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 Langzeitaufbewahrungstresor. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden.

Copy, Secondary 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. LicenseIncluded , wenn Sie eine Lizenz benötigen oder BasePrice wenn Sie über eine Lizenz verfügen und für die Azure-Hybridvorteil berechtigt sind.

DatabaseReadScale

Der Zustand des schreibgeschützten Routings. Wenn diese Option aktiviert ist, können Verbindungen, für die die Anwendungsabsicht in der Verbindungszeichenfolge auf readonly festgelegt ist, an ein schreibgeschütztes sekundäres Replikat in derselben Region weitergeleitet werden.

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 Datenbank handelt. Gültige Werte sind Geo und Named.

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: 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 durch Wiederherstellen einer georeplizierten Sicherung. 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 Langzeitaufbewahrungstresor. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden.

Copy, Secondary 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 sind Metadaten, die für die Azure-Portal verwendet werden.

location
  • string

Ressourcenspeicherort

managedBy
  • string

Ressource, die die Datenbank verwaltet.

name
  • string

Name der Ressource.

properties.autoPauseDelay
  • integer

Zeit in Minuten, nach der die Datenbank automatisch angehalten wird. Der Wert -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: 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 durch Wiederherstellen einer georeplizierten Sicherung. 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 Langzeitaufbewahrungstresor. recoveryServicesRecoveryPointResourceId muss als Ressourcen-ID des Wiederherstellungspunkts angegeben werden.

Copy, Secondary 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 Servicelevel-Zielname der Datenbank.

properties.currentSku

Der Name und die Ebene der SKU.

properties.databaseId
  • string

Die ID der Datenbank.

properties.defaultSecondaryLocation
  • string

Die sekundäre Standardregion für diese Datenbank.

properties.earliestRestoreDate
  • string

Dadurch werden das früheste Startdatum und die früheste Uhrzeit aufgezeichnet, zu der die Wiederherstellung für diese Datenbank verfügbar ist (ISO8601-Format).

properties.elasticPoolId
  • string

Der Ressourcenbezeichner des Pools für elastische Datenbanken, der diese Datenbank enthält.

properties.failoverGroupId
  • string

Ressourcenbezeichner der Failovergruppe, zu der diese Datenbank gehört.

properties.highAvailabilityReplicaCount
  • integer

Die Anzahl der sekundären Replikate, die der Datenbank zugeordnet sind und zur Bereitstellung von Hochverfügbarkeit verwendet werden.

properties.isInfraEncryptionEnabled
  • boolean

Die Infrastrukturverschlüsselung ist für diese Datenbank aktiviert.

properties.isLedgerOn
  • boolean

Gibt an, 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 nach dem Erstellen der Datenbank nicht mehr geändert werden.

properties.licenseType

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

properties.longTermRetentionBackupResourceId
  • string

Der Ressourcenbezeichner der Langfristigen Aufbewahrungssicherung, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.

properties.maintenanceConfigurationId
  • string

Wartungskonfigurations-ID, die der Datenbank zugewiesen ist. Diese Konfiguration definiert den Zeitraum, in dem die Wartungsupdates ausgeführt werden.

properties.maxLogSizeBytes
  • integer

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

properties.maxSizeBytes
  • integer

Die maximale Größe der Datenbank in Bytes.

properties.minCapacity
  • number

Minimale Kapazität, die der Datenbank immer zugeordnet ist, wenn sie nicht angehalten wird

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 diese Option aktiviert ist, können Verbindungen, für die die Anwendungsabsicht in der Verbindungszeichenfolge auf readonly festgelegt ist, an ein schreibgeschütztes sekundäres Replikat in derselben Region weitergeleitet werden.

properties.recoverableDatabaseId
  • string

Der Ressourcenbezeichner der wiederherstellbaren Datenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.

properties.recoveryServicesRecoveryPointId
  • string

Der Ressourcenbezeichner des Wiederherstellungspunkts, der dem Erstellungsvorgang 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 Servicelevel-Zielname der Datenbank.

properties.restorableDroppedDatabaseId
  • string

Der Ressourcenbezeichner der wiederherstellbaren gelöschten Datenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.

properties.restorePointInTime
  • string

Gibt den Zeitpunkt (ISO8601-Format) der Quelldatenbank an, die zum Erstellen der neuen Datenbank wiederhergestellt wird.

properties.resumedDate
  • string

Das Datum, an dem die Datenbank durch Eine Benutzeraktion oder Datenbankanmeldung (ISO8601-Format) fortgesetzt wurde. 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 Datenbank handelt. Gültige Werte sind Geo und Named.

properties.sourceDatabaseDeletionDate
  • string

Gibt den Zeitpunkt an, zu dem die Datenbank gelöscht wurde.

properties.sourceDatabaseId
  • string

Der Ressourcenbezeichner der Quelldatenbank, die dem Erstellungsvorgang dieser Datenbank zugeordnet ist.

properties.status

Der Status der 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.

sku

Die Datenbank-SKU.

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 für Ihr Abonnement in einer Capabilities_ListByLocation Azure-Region verfügbar sind:

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. LicenseIncluded , wenn Sie eine Lizenz benötigen oder BasePrice wenn Sie über eine Lizenz verfügen und für die Azure-Hybridvorteil berechtigt sind.

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

DatabaseReadScale

Der Zustand des schreibgeschützten Routings. Wenn diese Option aktiviert ist, können Verbindungen, für die die Anwendungsabsicht in der Verbindungszeichenfolge auf readonly festgelegt ist, an ein schreibgeschütztes sekundäres Replikat in derselben Region weitergeleitet werden.

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 Datenbank handelt. Gültige Werte sind Geo und Named.

Name Type Description
Geo
  • string
Named
  • string

Sku

Eine ARM-Ressourcen-SKU.

Name Type Description
capacity
  • integer

Kapazität der jeweiligen SKU.

family
  • string

Wenn der Dienst über unterschiedliche Hardwaregenerationen für dieselbe SKU verfügt, kann dies hier erfasst werden.

name
  • string

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

size
  • string

Größe der jeweiligen SKU

tier
  • string

Der Tarif oder die Edition der jeweiligen SKU, z. B. Basic, Premium.