Databases - Get

Pobiera bazę danych.

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

Parametry identyfikatora URI

Name In Required Type Description
databaseName
path True
  • string

Nazwa bazy danych.

resourceGroupName
path True
  • string

Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.

serverName
path True
  • string

Nazwa serwera.

subscriptionId
path True
  • string

Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.

api-version
query True
  • string

Wersja interfejsu API do użycia dla żądania.

Odpowiedzi

Name Type Description
200 OK

Pomyślnie pobrano określoną bazę danych.

Other Status Codes

Odpowiedzi na błędy: ***

  • 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera

  • 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

  • 404 ResourceNotFound — żądany zasób nie został znaleziony.

Przykłady

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

Definicje

CatalogCollationType

Sortowanie wykazu metadanych.

CreateMode

Określa tryb tworzenia bazy danych.

Ustawienie domyślne: regularne tworzenie bazy danych.

Kopiowanie: tworzy bazę danych jako kopię istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu źródłowej bazy danych.

Pomocnicza: tworzy bazę danych jako pomocniczą replikę istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych.

PointInTimeRestore: tworzy bazę danych przez przywrócenie kopii zapasowej istniejącej bazy danych w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a należy określić wartość restorePointInTime.

Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId należy określić jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić.

Przywracanie: tworzy bazę danych przez przywrócenie kopii zapasowej usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli parametr sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem zasobu bazy danych, a element sourceDatabaseDeletionDate jest ignorowany. restorePointInTime można również określić, aby przywrócić z wcześniejszego punktu w czasie.

RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu długoterminowego przechowywania. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania.

Funkcja Copy, Secondary i RestoreLongTermRetentionBackup nie jest obsługiwana w przypadku wersji DataWarehouse.

CurrentBackupStorageRedundancy

Typ konta magazynu używany do przechowywania kopii zapasowych dla tej bazy danych.

Database

Zasób bazy danych.

DatabaseLicenseType

Typ licencji do zastosowania dla tej bazy danych. LicenseIncludedjeśli potrzebujesz licencji lub BasePrice masz licencję i kwalifikujesz się do Korzyść użycia hybrydowego platformy Azure.

DatabaseReadScale

Stan routingu tylko do odczytu. W przypadku włączenia połączeń, które mają ustawioną intencję aplikacji na odczyt w parametry połączenia, mogą być kierowane do repliki pomocniczej readonly w tym samym regionie.

DatabaseStatus

Stan bazy danych.

RequestedBackupStorageRedundancy

Typ konta magazynu, który ma być używany do przechowywania kopii zapasowych dla tej bazy danych.

SampleName

Nazwa przykładowego schematu do zastosowania podczas tworzenia tej bazy danych.

SecondaryType

Pomocniczy typ bazy danych, jeśli jest pomocniczy. Prawidłowe wartości to Geo i Nazwane.

Sku

Jednostka SKU zasobu usługi ARM.

CatalogCollationType

Sortowanie wykazu metadanych.

Name Type Description
DATABASE_DEFAULT
  • string
SQL_Latin1_General_CP1_CI_AS
  • string

CreateMode

Określa tryb tworzenia bazy danych.

Ustawienie domyślne: regularne tworzenie bazy danych.

Kopiowanie: tworzy bazę danych jako kopię istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu źródłowej bazy danych.

Pomocnicza: tworzy bazę danych jako pomocniczą replikę istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych.

PointInTimeRestore: tworzy bazę danych przez przywrócenie kopii zapasowej istniejącej bazy danych w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a należy określić wartość restorePointInTime.

Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId należy określić jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić.

Przywracanie: tworzy bazę danych przez przywrócenie kopii zapasowej usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli parametr sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem zasobu bazy danych, a element sourceDatabaseDeletionDate jest ignorowany. restorePointInTime można również określić, aby przywrócić z wcześniejszego punktu w czasie.

RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu długoterminowego przechowywania. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania.

Funkcja Copy, Secondary i RestoreLongTermRetentionBackup nie jest obsługiwana w przypadku wersji DataWarehouse.

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

CurrentBackupStorageRedundancy

Typ konta magazynu używany do przechowywania kopii zapasowych dla tej bazy danych.

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

Database

Zasób bazy danych.

Name Type Description
id
  • string

Identyfikator zasobu.

kind
  • string

Rodzaj bazy danych. Są to metadane używane w środowisku Azure Portal.

location
  • string

Lokalizacja zasobu.

managedBy
  • string

Zasób, który zarządza bazą danych.

name
  • string

Nazwa zasobu.

properties.autoPauseDelay
  • integer

Czas w minutach, po którym baza danych jest automatycznie wstrzymana. Wartość -1 oznacza, że automatyczne wstrzymanie jest wyłączone

properties.catalogCollation

Sortowanie wykazu metadanych.

properties.collation
  • string

Sortowanie bazy danych.

properties.createMode

Określa tryb tworzenia bazy danych.

Ustawienie domyślne: regularne tworzenie bazy danych.

Kopiowanie: tworzy bazę danych jako kopię istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu źródłowej bazy danych.

Pomocnicza: tworzy bazę danych jako pomocniczą replikę istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych.

PointInTimeRestore: tworzy bazę danych przez przywrócenie kopii zapasowej istniejącej bazy danych w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a należy określić wartość restorePointInTime.

Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId należy określić jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić.

Przywracanie: tworzy bazę danych przez przywrócenie kopii zapasowej usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli parametr sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem zasobu bazy danych, a element sourceDatabaseDeletionDate jest ignorowany. restorePointInTime można również określić, aby przywrócić z wcześniejszego punktu w czasie.

RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu długoterminowego przechowywania. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania.

Funkcja Copy, Secondary i RestoreLongTermRetentionBackup nie jest obsługiwana w przypadku wersji DataWarehouse.

properties.creationDate
  • string

Data utworzenia bazy danych (format ISO8601).

properties.currentBackupStorageRedundancy

Typ konta magazynu używany do przechowywania kopii zapasowych dla tej bazy danych.

properties.currentServiceObjectiveName
  • string

Bieżąca nazwa celu poziomu usługi bazy danych.

properties.currentSku

Nazwa i warstwa jednostki SKU.

properties.databaseId
  • string

Identyfikator bazy danych.

properties.defaultSecondaryLocation
  • string

Domyślny region pomocniczy dla tej bazy danych.

properties.earliestRestoreDate
  • string

Rejestruje najwcześniejszą datę i godzinę rozpoczęcia przywracania dla tej bazy danych (format ISO8601).

properties.elasticPoolId
  • string

Identyfikator zasobu elastycznej puli zawierającej tę bazę danych.

properties.failoverGroupId
  • string

Identyfikator zasobu grupy trybu failover, do którego należy ta baza danych.

properties.highAvailabilityReplicaCount
  • integer

Liczba replik pomocniczych skojarzonych z bazą danych, które są używane do zapewnienia wysokiej dostępności.

properties.licenseType

Typ licencji do zastosowania dla tej bazy danych. LicenseIncludedjeśli potrzebujesz licencji lub BasePrice masz licencję i kwalifikujesz się do Korzyść użycia hybrydowego platformy Azure.

properties.longTermRetentionBackupResourceId
  • string

Identyfikator zasobu kopii zapasowej długoterminowego przechowywania skojarzonej z operacją tworzenia tej bazy danych.

properties.maintenanceConfigurationId
  • string

Identyfikator konfiguracji konserwacji przypisany do bazy danych. Ta konfiguracja definiuje okres, w których będą wykonywane aktualizacje konserwacji.

properties.maxLogSizeBytes
  • integer

Maksymalny rozmiar dziennika dla tej bazy danych.

properties.maxSizeBytes
  • integer

Maksymalny rozmiar bazy danych wyrażony w bajtach.

properties.minCapacity
  • number

Minimalna pojemność, którą baza danych zawsze będzie przydzielana, jeśli nie zostanie wstrzymana

properties.pausedDate
  • string

Data wstrzymania bazy danych przez konfigurację użytkownika lub akcję (format ISO8601). Wartość null, jeśli baza danych jest gotowa.

properties.readScale

Stan routingu tylko do odczytu. W przypadku włączenia połączeń, które mają ustawioną intencję aplikacji na odczyt w parametry połączenia, mogą być kierowane do repliki pomocniczej readonly w tym samym regionie.

properties.recoverableDatabaseId
  • string

Identyfikator zasobu możliwej do odzyskania bazy danych skojarzony z operacją tworzenia tej bazy danych.

properties.recoveryServicesRecoveryPointId
  • string

Identyfikator zasobu punktu odzyskiwania skojarzonego z operacją tworzenia tej bazy danych.

properties.requestedBackupStorageRedundancy

Typ konta magazynu, który ma być używany do przechowywania kopii zapasowych dla tej bazy danych.

properties.requestedServiceObjectiveName
  • string

Żądana nazwa celu poziomu usługi bazy danych.

properties.restorableDroppedDatabaseId
  • string

Identyfikator zasobu usuniętej bazy danych skojarzonej z operacją tworzenia tej bazy danych.

properties.restorePointInTime
  • string

Określa punkt w czasie (format ISO8601) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych.

properties.resumedDate
  • string

Data wznowienia bazy danych przez akcję użytkownika lub identyfikator logowania bazy danych (format ISO8601). Wartość null, jeśli baza danych jest wstrzymana.

properties.sampleName

Nazwa przykładowego schematu do zastosowania podczas tworzenia tej bazy danych.

properties.secondaryType

Pomocniczy typ bazy danych, jeśli jest pomocniczy. Prawidłowe wartości to Geo i Nazwane.

properties.sourceDatabaseDeletionDate
  • string

Określa czas usunięcia bazy danych.

properties.sourceDatabaseId
  • string

Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych.

properties.status

Stan bazy danych.

properties.zoneRedundant
  • boolean

Niezależnie od tego, czy ta baza danych jest strefowo nadmiarowa, co oznacza, że repliki tej bazy danych będą rozłożone na wiele stref dostępności.

sku

Jednostka SKU bazy danych.

Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu Capabilities_ListByLocation API REST lub jednego z następujących poleceń:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
tags
  • object

Tagi zasobów.

type
  • string

Typ zasobu.

DatabaseLicenseType

Typ licencji do zastosowania dla tej bazy danych. LicenseIncludedjeśli potrzebujesz licencji lub BasePrice masz licencję i kwalifikujesz się do Korzyść użycia hybrydowego platformy Azure.

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

DatabaseReadScale

Stan routingu tylko do odczytu. W przypadku włączenia połączeń, które mają ustawioną intencję aplikacji na odczyt w parametry połączenia, mogą być kierowane do repliki pomocniczej readonly w tym samym regionie.

Name Type Description
Disabled
  • string
Enabled
  • string

DatabaseStatus

Stan bazy danych.

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

Typ konta magazynu, który ma być używany do przechowywania kopii zapasowych dla tej bazy danych.

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

SampleName

Nazwa przykładowego schematu do zastosowania podczas tworzenia tej bazy danych.

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

SecondaryType

Pomocniczy typ bazy danych, jeśli jest pomocniczy. Prawidłowe wartości to Geo i Nazwane.

Name Type Description
Geo
  • string
Named
  • string

Sku

Jednostka SKU zasobu usługi ARM.

Name Type Description
capacity
  • integer

Pojemność określonej jednostki SKU.

family
  • string

Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.

name
  • string

Nazwa jednostki SKU, zazwyczaj litera + kod liczbowy, np. P3.

size
  • string

Rozmiar określonej jednostki SKU

tier
  • string

Warstwa lub wersja określonej jednostki SKU, np. Podstawowa, Premium.