Databases - Get

Lekér egy adatbázist.

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

URI-paraméterek

Name In Required Type Description
databaseName
path True
  • string

Az adatbázis neve.

resourceGroupName
path True
  • string

Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.

serverName
path True
  • string

A kiszolgáló neve.

subscriptionId
path True
  • string

Az Azure-előfizetést azonosító előfizetés-azonosító.

api-version
query True
  • string

A kéréshez használni kívánt API-verzió.

Válaszok

Name Type Description
200 OK

Sikeresen lekérte a megadott adatbázist.

Other Status Codes

Hibaválaszok: ***

  • 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található

  • 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben.

  • 404 ResourceNotFound – A kért erőforrás nem található.

Példák

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

Definíciók

CatalogCollationType

A metaadat-katalógus rendezése.

CreateMode

Az adatbázis létrehozásának módját határozza meg.

Alapértelmezett: rendszeres adatbázis-létrehozás.

Másolás: létrehoz egy adatbázist egy meglévő adatbázis másolataként. A sourceDatabaseId azonosítót a forrásadatbázis erőforrás-azonosítójaként kell megadni.

Másodlagos: létrehoz egy adatbázist egy meglévő adatbázis másodlagos replikájaként. A sourceDatabaseId azonosítót meg kell adni a meglévő elsődleges adatbázis erőforrás-azonosítójaként.

PointInTimeRestore: Adatbázist hoz létre egy meglévő adatbázis időponthoz kötött biztonsági mentésének visszaállításával. A sourceDatabaseId azonosítót meg kell adni a meglévő adatbázis erőforrás-azonosítójaként, és meg kell adni a restorePointInTime értéket.

Helyreállítás: Létrehoz egy adatbázist egy georeplikált biztonsági másolat visszaállításával. A visszaállítandó helyreállítható adatbázis erőforrás-azonosítójaként a sourceDatabaseId azonosítót kell megadni.

Visszaállítás: Létrehoz egy adatbázist egy törölt adatbázis biztonsági másolatának visszaállításával. Meg kell adni a sourceDatabaseId azonosítót. Ha a sourceDatabaseId az adatbázis eredeti erőforrás-azonosítója, akkor a sourceDatabaseDeletionDate értéket kell megadni. Ellenkező esetben a sourceDatabaseId azonosítónak kell lennie a visszaállítható elvetett adatbázis-erőforrás-azonosítónak, és a sourceDatabaseDeletionDate paraméter figyelmen kívül lesz hagyva. A restorePointInTime is megadható a visszaállításhoz egy korábbi időpontból.

RestoreLongTermRetentionBackup: Létrehoz egy adatbázist egy hosszú távú megőrzési tárolóból való visszaállítással. A recoveryServicesRecoveryPointResourceId értéket meg kell adni a helyreállítási pont erőforrás-azonosítójaként.

A Copy, Secondary és RestoreLongTermRetentionBackup nem támogatott a DataWarehouse kiadásban.

CurrentBackupStorageRedundancy

Az adatbázis biztonsági mentéseinek tárolására használt tárfióktípus.

Database

Egy adatbázis-erőforrás.

DatabaseLicenseType

Az adatbázishoz alkalmazandó licenctípus. LicenseIncludedha licencre van szüksége, vagy BasePrice rendelkezik licenccel, és jogosult a Azure Hybrid Benefit.

DatabaseReadScale

Az írásvédett útválasztás állapota. Ha engedélyezve van, azokat a kapcsolatokat, amelyeknek az alkalmazás szándéka a kapcsolati karakterlánc írásvédettre van állítva, átirányíthatja egy, ugyanabban a régióban lévő, olvashatóan másodlagos replikára.

DatabaseStatus

Az adatbázis állapota.

RequestedBackupStorageRedundancy

Az adatbázis biztonsági mentéseinek tárolására használt tárfiók típusa.

SampleName

Az adatbázis létrehozásakor alkalmazandó mintaséma neve.

SecondaryType

Az adatbázis másodlagos típusa, ha másodlagos. Az érvényes értékek a Geo és a Named.

Sku

ARM-erőforrás-termékváltozat.

CatalogCollationType

A metaadat-katalógus rendezése.

Name Type Description
DATABASE_DEFAULT
  • string
SQL_Latin1_General_CP1_CI_AS
  • string

CreateMode

Az adatbázis létrehozásának módját határozza meg.

Alapértelmezett: rendszeres adatbázis-létrehozás.

Másolás: létrehoz egy adatbázist egy meglévő adatbázis másolataként. A sourceDatabaseId azonosítót a forrásadatbázis erőforrás-azonosítójaként kell megadni.

Másodlagos: létrehoz egy adatbázist egy meglévő adatbázis másodlagos replikájaként. A sourceDatabaseId azonosítót meg kell adni a meglévő elsődleges adatbázis erőforrás-azonosítójaként.

PointInTimeRestore: Adatbázist hoz létre egy meglévő adatbázis időponthoz kötött biztonsági mentésének visszaállításával. A sourceDatabaseId azonosítót meg kell adni a meglévő adatbázis erőforrás-azonosítójaként, és meg kell adni a restorePointInTime értéket.

Helyreállítás: Létrehoz egy adatbázist egy georeplikált biztonsági másolat visszaállításával. A visszaállítandó helyreállítható adatbázis erőforrás-azonosítójaként a sourceDatabaseId azonosítót kell megadni.

Visszaállítás: Létrehoz egy adatbázist egy törölt adatbázis biztonsági másolatának visszaállításával. Meg kell adni a sourceDatabaseId azonosítót. Ha a sourceDatabaseId az adatbázis eredeti erőforrás-azonosítója, akkor a sourceDatabaseDeletionDate értéket kell megadni. Ellenkező esetben a sourceDatabaseId azonosítónak kell lennie a visszaállítható elvetett adatbázis-erőforrás-azonosítónak, és a sourceDatabaseDeletionDate paraméter figyelmen kívül lesz hagyva. A restorePointInTime is megadható a visszaállításhoz egy korábbi időpontból.

RestoreLongTermRetentionBackup: Létrehoz egy adatbázist egy hosszú távú megőrzési tárolóból való visszaállítással. A recoveryServicesRecoveryPointResourceId értéket meg kell adni a helyreállítási pont erőforrás-azonosítójaként.

A Copy, Secondary és RestoreLongTermRetentionBackup nem támogatott a DataWarehouse kiadásban.

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

CurrentBackupStorageRedundancy

Az adatbázis biztonsági mentéseinek tárolására használt tárfióktípus.

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

Database

Egy adatbázis-erőforrás.

Name Type Description
id
  • string

Erőforrás-azonosító.

kind
  • string

Az adatbázis típusa. Ez a Azure Portal-élményhez használt metaadatok.

location
  • string

Erőforrás helye.

managedBy
  • string

Az adatbázist kezelő erőforrás.

name
  • string

Erőforrás neve.

properties.autoPauseDelay
  • integer

Az az idő percek alatt, amely után az adatbázis automatikusan szüneteltetve lesz. A -1 érték azt jelenti, hogy az automatikus szüneteltetés le van tiltva

properties.catalogCollation

A metaadat-katalógus rendezése.

properties.collation
  • string

Az adatbázis rendezése.

properties.createMode

Az adatbázis létrehozásának módját határozza meg.

Alapértelmezett: rendszeres adatbázis-létrehozás.

Másolás: létrehoz egy adatbázist egy meglévő adatbázis másolataként. A sourceDatabaseId azonosítót a forrásadatbázis erőforrás-azonosítójaként kell megadni.

Másodlagos: létrehoz egy adatbázist egy meglévő adatbázis másodlagos replikájaként. A sourceDatabaseId azonosítót meg kell adni a meglévő elsődleges adatbázis erőforrás-azonosítójaként.

PointInTimeRestore: Adatbázist hoz létre egy meglévő adatbázis időponthoz kötött biztonsági mentésének visszaállításával. A sourceDatabaseId azonosítót meg kell adni a meglévő adatbázis erőforrás-azonosítójaként, és meg kell adni a restorePointInTime értéket.

Helyreállítás: Létrehoz egy adatbázist egy georeplikált biztonsági másolat visszaállításával. A visszaállítandó helyreállítható adatbázis erőforrás-azonosítójaként a sourceDatabaseId azonosítót kell megadni.

Visszaállítás: Létrehoz egy adatbázist egy törölt adatbázis biztonsági másolatának visszaállításával. Meg kell adni a sourceDatabaseId azonosítót. Ha a sourceDatabaseId az adatbázis eredeti erőforrás-azonosítója, akkor a sourceDatabaseDeletionDate értéket kell megadni. Ellenkező esetben a sourceDatabaseId azonosítónak kell lennie a visszaállítható elvetett adatbázis-erőforrás-azonosítónak, és a sourceDatabaseDeletionDate paraméter figyelmen kívül lesz hagyva. A restorePointInTime is megadható a visszaállításhoz egy korábbi időpontból.

RestoreLongTermRetentionBackup: Létrehoz egy adatbázist egy hosszú távú megőrzési tárolóból való visszaállítással. A recoveryServicesRecoveryPointResourceId értéket meg kell adni a helyreállítási pont erőforrás-azonosítójaként.

A Copy, Secondary és RestoreLongTermRetentionBackup nem támogatott a DataWarehouse kiadásban.

properties.creationDate
  • string

Az adatbázis létrehozásának dátuma (ISO8601 formátum).

properties.currentBackupStorageRedundancy

Az adatbázis biztonsági mentéseinek tárolására használt tárfióktípus.

properties.currentServiceObjectiveName
  • string

Az adatbázis aktuális szolgáltatásiszint-célkitűzésének neve.

properties.currentSku

A termékváltozat neve és szintje.

properties.databaseId
  • string

Az adatbázis azonosítója.

properties.defaultSecondaryLocation
  • string

Az adatbázis alapértelmezett másodlagos régiója.

properties.earliestRestoreDate
  • string

Ez az adatbázishoz elérhető legkorábbi kezdési dátumot és időpontot rögzíti (ISO8601 formátum).

properties.elasticPoolId
  • string

Az adatbázist tartalmazó rugalmas készlet erőforrás-azonosítója.

properties.failoverGroupId
  • string

A feladatátvételi csoport erőforrás-azonosítója, amelyhez ez az adatbázis tartozik.

properties.highAvailabilityReplicaCount
  • integer

A magas rendelkezésre állás biztosításához használt adatbázishoz társított másodlagos replikák száma.

properties.licenseType

Az adatbázishoz alkalmazandó licenctípus. LicenseIncludedha licencre van szüksége, vagy BasePrice ha rendelkezik licenccel, és jogosult a Azure Hybrid Benefit.

properties.longTermRetentionBackupResourceId
  • string

Az adatbázis létrehozási műveletéhez társított hosszú távú megőrzési biztonsági másolat erőforrás-azonosítója.

properties.maintenanceConfigurationId
  • string

Az adatbázishoz rendelt karbantartási konfiguráció azonosítója. Ez a konfiguráció határozza meg azt az időszakot, amikor a karbantartási frissítések történnek.

properties.maxLogSizeBytes
  • integer

Az adatbázis maximális naplómérete.

properties.maxSizeBytes
  • integer

Az adatbázis maximális mérete bájtban kifejezve.

properties.minCapacity
  • number

Minimális kapacitás, amelyet az adatbázis mindig lefoglalt, ha nincs szüneteltetve

properties.pausedDate
  • string

Az a dátum, amikor az adatbázist felhasználói konfiguráció vagy művelet szüneteltette (ISO8601 formátum). Null érték, ha az adatbázis készen áll.

properties.readScale

Az írásvédett útválasztás állapota. Ha engedélyezve van, azokat a kapcsolatokat, amelyeknél az alkalmazás szándéka csak olvashatóra van beállítva a kapcsolati karakterlánc lehet átirányítani egy, ugyanabban a régióban lévő, könnyen másodlagos replikára.

properties.recoverableDatabaseId
  • string

Az adatbázis létrehozási műveletéhez társított helyreállítható adatbázis erőforrás-azonosítója.

properties.recoveryServicesRecoveryPointId
  • string

Az adatbázis létrehozási műveletéhez társított helyreállítási pont erőforrás-azonosítója.

properties.requestedBackupStorageRedundancy

Az adatbázis biztonsági mentéseinek tárolására használt tárfiók típusa.

properties.requestedServiceObjectiveName
  • string

Az adatbázis kért szolgáltatásiszint-célkitűzésének neve.

properties.restorableDroppedDatabaseId
  • string

Az adatbázis létrehozási műveletéhez társított visszaállítható elvetett adatbázis erőforrás-azonosítója.

properties.restorePointInTime
  • string

Megadja a forrásadatbázis azon időpontját (ISO8601 formátuma), amely az új adatbázis létrehozásához vissza lesz állítva.

properties.resumedDate
  • string

Az adatbázis felhasználói művelet vagy adatbázis-bejelentkezés (ISO8601 formátum) általi folytatásának dátuma. Null érték, ha az adatbázis szüneteltetve van.

properties.sampleName

Az adatbázis létrehozásakor alkalmazandó mintaséma neve.

properties.secondaryType

Az adatbázis másodlagos típusa, ha másodlagos. Az érvényes értékek a Geo és a Named.

properties.sourceDatabaseDeletionDate
  • string

Az adatbázis törlésének időpontját adja meg.

properties.sourceDatabaseId
  • string

Az adatbázis létrehozási műveletéhez társított forrásadatbázis erőforrás-azonosítója.

properties.status

Az adatbázis állapota.

properties.zoneRedundant
  • boolean

Függetlenül attól, hogy ez az adatbázis zónaredundáns-e, ami azt jelenti, hogy az adatbázis replikái több rendelkezésre állási zónában lesznek elosztva.

sku

Az adatbázis termékváltozata.

A termékváltozatok listája régiónként és támogatási ajánlatonként változhat. Az Azure-régióban az előfizetéséhez elérhető termékváltozatok (beleértve a termékváltozat nevét, szintjét/kiadását, családját és kapacitását) meghatározásához használja a Capabilities_ListByLocation REST API-t vagy az alábbi parancsok egyikét:

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

Erőforráscímkék.

type
  • string

Erőforrástípus.

DatabaseLicenseType

Az adatbázishoz alkalmazandó licenctípus. LicenseIncludedha licencre van szüksége, vagy BasePrice rendelkezik licenccel, és jogosult a Azure Hybrid Benefit.

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

DatabaseReadScale

Az írásvédett útválasztás állapota. Ha engedélyezve van, azokat a kapcsolatokat, amelyeknek az alkalmazás szándéka a kapcsolati karakterlánc írásvédettre van állítva, átirányíthatja egy, ugyanabban a régióban lévő, olvashatóan másodlagos replikára.

Name Type Description
Disabled
  • string
Enabled
  • string

DatabaseStatus

Az adatbázis állapota.

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

Az adatbázis biztonsági mentéseinek tárolására használt tárfiók típusa.

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

SampleName

Az adatbázis létrehozásakor alkalmazandó mintaséma neve.

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

SecondaryType

Az adatbázis másodlagos típusa, ha másodlagos. Az érvényes értékek a Geo és a Named.

Name Type Description
Geo
  • string
Named
  • string

Sku

ARM-erőforrás-termékváltozat.

Name Type Description
capacity
  • integer

Az adott termékváltozat kapacitása.

family
  • string

Ha a szolgáltatás eltérő hardvergenerációval rendelkezik ugyanahhoz az SKU-hoz, az itt rögzíthető.

name
  • string

A termékváltozat neve, általában betű + számkód, pl. P3.

size
  • string

Az adott termékváltozat mérete

tier
  • string

Az adott termékváltozat szintje vagy kiadása, például alapszintű, Prémium.