Databases - Get

Referencia

Szolgáltatás:: SQL Database

API-verzió:: 2021-11-01

Lekéri az adatbázist.

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

URI-paraméterek

Name	In	Kötelező	Típus	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	Típus	Description
200 OK	Database	Sikerült beolvasni 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ó.

Name

Típus

Description

200 OK

Database

Sikerült beolvasni 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.

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-11-01


/**
 * Samples for Databases Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/GetVCoreDatabase.json
     */
    /**
     * Sample code: Gets a database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getsADatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases().getWithResponse("Default-SQL-SouthEastAsia",
            "testsvr", "testdb", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Mintaválasz

Állapotkód:: 200

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

Definíciók

Name	Description
BackupStorageRedundancy	Az adatbázis biztonsági mentéseinek tárolására használt tárfiók típusa.
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. sourceDatabaseId értéket kell megadni a forrásadatbázis erőforrás-azonosítójaként. Másodlagos: létrehoz egy adatbázist egy meglévő adatbázis másodlagos replikájaként. sourceDatabaseId értéket kell megadni 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 értéket 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 mentés visszaállításával. A sourceDatabaseId értéket a visszaállítandó helyreállítható adatbázis-erőforrás-azonosítóként 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. sourceDatabaseId értéket kell megadni. Ha a sourceDatabaseId az adatbázis eredeti erőforrás-azonosítója, akkor meg kell adni a sourceDatabaseDeletionDate értéket. Ellenkező esetben a sourceDatabaseId-nek a visszaállítható elvetett adatbázis-erőforrás-azonosítónak kell lennie, é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: Adatbázist hoz létre egy hosszú távú megőrzési tárolóból való visszaállítással. recoveryServicesRecoveryPointResourceId értéket kell megadni 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.
Database	Adatbázis-erőforrás.
DatabaseIdentity	Azure Active Directory-identitáskonfiguráció egy erőforráshoz.
DatabaseIdentityType	Az identitás típusa
DatabaseLicenseType	Az adatbázishoz alkalmazandó licenctípus. `LicenseIncluded`ha licencre van szüksége, vagy `BasePrice` ha rendelkezik licenccel, és jogosult a Azure Hybrid Benefit.
DatabaseReadScale	Az írásvédett útválasztás állapota. Ha engedélyezve van, a kapcsolati karakterlánc az alkalmazás szándékával rendelkező kapcsolatok átirányíthatók egy, ugyanabban a régióban lévő, olvashatóan másodlagos replikára. Rugalmas készleten belüli rugalmas skálázású adatbázisokra nem alkalmazható.
DatabaseStatus	Az adatbázis állapota.
DatabaseUserIdentity	Azure Active Directory-identitáskonfiguráció egy erőforráshoz.
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áltozata.

BackupStorageRedundancy

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

Name	Típus	Description
Geo	string
GeoZone	string
Local	string
Zone	string

CatalogCollationType

A metaadat-katalógus rendezése.

Name	Típus	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. sourceDatabaseId értéket kell megadni a forrásadatbázis erőforrás-azonosítójaként.

Másodlagos: létrehoz egy adatbázist egy meglévő adatbázis másodlagos replikájaként. sourceDatabaseId értéket kell megadni 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 értéket 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 mentés visszaállításával. A sourceDatabaseId értéket a visszaállítandó helyreállítható adatbázis-erőforrás-azonosítóként 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. sourceDatabaseId értéket kell megadni. Ha a sourceDatabaseId az adatbázis eredeti erőforrás-azonosítója, akkor meg kell adni a sourceDatabaseDeletionDate értéket. Ellenkező esetben a sourceDatabaseId-nek a visszaállítható elvetett adatbázis-erőforrás-azonosítónak kell lennie, é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: Adatbázist hoz létre egy hosszú távú megőrzési tárolóból való visszaállítással. recoveryServicesRecoveryPointResourceId értéket kell megadni 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	Típus	Description
Copy	string
Default	string
OnlineSecondary	string
PointInTimeRestore	string
Recovery	string
Restore	string
RestoreExternalBackup	string
RestoreExternalBackupSecondary	string
RestoreLongTermRetentionBackup	string
Secondary	string

Database

Adatbázis-erőforrás.

Name	Típus	Description
id	string	Erőforrás-azonosító.
identity	DatabaseIdentity	Az adatbázis Azure Active Directory-identitása.
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 adatbázis automatikus szüneteltetése után percek alatt. A -1 érték azt jelenti, hogy az automatikus szüneteltetés le van tiltva
properties.catalogCollation	CatalogCollationType	A metaadat-katalógus rendezése.
properties.collation	string	Az adatbázis rendezése.
properties.createMode	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. sourceDatabaseId értéket kell megadni a forrásadatbázis erőforrás-azonosítójaként. Másodlagos: létrehoz egy adatbázist egy meglévő adatbázis másodlagos replikájaként. sourceDatabaseId értéket kell megadni 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 értéket 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 mentés visszaállításával. A sourceDatabaseId értéket a visszaállítandó helyreállítható adatbázis-erőforrás-azonosítóként 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. sourceDatabaseId értéket kell megadni. Ha a sourceDatabaseId az adatbázis eredeti erőforrás-azonosítója, akkor meg kell adni a sourceDatabaseDeletionDate értéket. Ellenkező esetben a sourceDatabaseId-nek a visszaállítható elvetett adatbázis-erőforrás-azonosítónak kell lennie, é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: Adatbázist hoz létre egy hosszú távú megőrzési tárolóból való visszaállítással. recoveryServicesRecoveryPointResourceId értéket kell megadni 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	BackupStorageRedundancy	Az adatbázis biztonsági mentéseinek tárolására használt tárfiók típusa.
properties.currentServiceObjectiveName	string	Az adatbázis aktuális szolgáltatásiszint-célkitűzésének neve.
properties.currentSku	Sku	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 rögzíti az adatbázishoz elérhető legkorábbi kezdési dátumot és időpontot (ISO8601 formátumot).
properties.elasticPoolId	string	Az adatbázist tartalmazó rugalmas készlet erőforrás-azonosítója.
properties.failoverGroupId	string	Feladatátvételi csoport erőforrás-azonosítója, amelyhez az adatbázis tartozik.
properties.federatedClientId	string	A bérlők közötti adatbázis-CMK-forgatókönyvben használt ügyfél-azonosító
properties.highAvailabilityReplicaCount	integer	Az adatbázishoz társított másodlagos replikák száma, amelyek magas rendelkezésre állást biztosítanak. Rugalmas készleten belüli rugalmas skálázású adatbázisokra nem alkalmazható.
properties.isInfraEncryptionEnabled	boolean	Az adatbázishoz engedélyezve van az infratitkosítás.
properties.isLedgerOn	boolean	Azt, hogy ez az adatbázis főkönyv-adatbázis-e, vagyis az adatbázisban lévő összes tábla főkönyvtáblák. Megjegyzés: a tulajdonság értéke nem módosítható az adatbázis létrehozása után.
properties.licenseType	DatabaseLicenseType	Az adatbázishoz alkalmazandó licenctípus. `LicenseIncluded`ha 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ú adatmegőrzési biztonsági mentés 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 bekövetkeznek.
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 (ISO8601 formátum) szüneteltette. Null értékű, ha az adatbázis készen áll.
properties.readScale	DatabaseReadScale	Az írásvédett útválasztás állapota. Ha engedélyezve van, a kapcsolati karakterlánc az alkalmazás szándékával rendelkező kapcsolatok átirányíthatók egy, ugyanabban a régióban lévő, olvashatóan másodlagos replikára. Rugalmas készleten belüli rugalmas skálázású adatbázisokra nem alkalmazható.
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	BackupStorageRedundancy	Az adatbázis biztonsági másolatainak 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 annak a forrásadatbázisnak az időpontját (ISO8601 formátumát), amely az új adatbázis létrehozásához lesz visszaá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	SampleName	Az adatbázis létrehozásakor alkalmazandó mintaséma neve.
properties.secondaryType	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 idejé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.sourceResourceId	string	Az adatbázis létrehozási műveletéhez társított forrás erőforrás-azonosítója. Ez a tulajdonság csak a DataWarehouse kiadás esetében támogatott, és lehetővé teszi az előfizetések közötti visszaállítást. A sourceResourceId megadásakor a sourceDatabaseId, a recoverableDatabaseId, a restoreableDroppedDatabaseId és a sourceDatabaseDeletionDate nem adható meg, a CreateMode értéknek pedig PointInTimeRestore, Restore vagy Recover értéknek kell lennie. Ha a createMode a PointInTimeRestore, a sourceResourceId értéknek a meglévő adatbázis vagy a meglévő SQL-készlet erőforrás-azonosítójának kell lennie, és meg kell adni a restorePointInTime értéket. Ha a createMode visszaállítás, a sourceResourceId-nek a visszaállítható elvetett adatbázis vagy visszaállítható elvetett SQL-készlet erőforrás-azonosítójának kell lennie. Ha a createMode a Helyreállítás, a sourceResourceId-nek a helyreállítható adatbázis vagy a helyreállítható SQL-készlet erőforrás-azonosítójának kell lennie. Ha a forráselőfizetés egy másik bérlőhöz tartozik, mint a célelőfizetés, az "x-ms-authorization-auxiliary" fejlécnek tartalmaznia kell a forrásbérlőhöz tartozó hitelesítési jogkivonatot. További információ az "x-ms-authorization-auxiliary" fejlécről: https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
properties.status	DatabaseStatus	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	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 Előfizetéshez egy Azure-régióban elérhető termékváltozatok (beleértve a termékváltozat nevét, a réteget/kiadást, a családot és a kapacitást) 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.

DatabaseIdentity

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

Name	Típus	Description
tenantId	string	Az Azure Active Directory-bérlő azonosítója.
type	DatabaseIdentityType	Az identitás típusa
userAssignedIdentities	<string, DatabaseUserIdentity>	A felhasználó által hozzárendelt identitások használandó erőforrás-azonosítói

DatabaseIdentityType

Az identitás típusa

Name	Típus	Description
None	string
UserAssigned	string

DatabaseLicenseType

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

Name	Típus	Description
BasePrice	string
LicenseIncluded	string

DatabaseReadScale

Az írásvédett útválasztás állapota. Ha engedélyezve van, a kapcsolati karakterlánc az alkalmazás szándékával rendelkező kapcsolatok átirányíthatók egy, ugyanabban a régióban lévő, olvashatóan másodlagos replikára. Rugalmas készleten belüli rugalmas skálázású adatbázisokra nem alkalmazható.

Name	Típus	Description
Disabled	string
Enabled	string

DatabaseStatus

Az adatbázis állapota.

Name	Típus	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
Starting	string
Stopped	string
Stopping	string
Suspect	string

DatabaseUserIdentity

Azure Active Directory-identitáskonfiguráció egy erőforráshoz.

Name	Típus	Description
clientId	string	Az Azure Active Directory ügyfélazonosítója.
principalId	string	Az Azure Active Directory egyszerű azonosítója.

SampleName

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

Name	Típus	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	Típus	Description
Geo	string
Named	string

Sku

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

Name	Típus	Description
capacity	integer	Az adott termékváltozat kapacitása.
family	string	Ha a szolgáltatás különböző hardvergenerációkkal rendelkezik ugyanahhoz a termékváltozathoz, akkor az itt rögzíthető.
name	string	A termékváltozat neve, általában betű + Szám kód, pl. P3.
size	string	Az adott termékváltozat mérete
tier	string	Az adott termékváltozat (pl. Alapszintű, Prémium) szintje vagy kiadása.

Megosztás a következőn keresztül:

Databases - Get

URI-paraméterek

Válaszok

Példák

Gets a database.

Mintakérelem

Mintaválasz

Definíciók

BackupStorageRedundancy

CatalogCollationType

CreateMode

Database

DatabaseIdentity

DatabaseIdentityType

DatabaseLicenseType

DatabaseReadScale

DatabaseStatus

DatabaseUserIdentity

SampleName

SecondaryType

Sku

További források