Databases - Get

Başvuru

Service:: SQL Database

API Version:: 2021-11-01

Bir veritabanı alır.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
databaseName	path	True	string	Veritabanının adı.
resourceGroupName	path	True	string	Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
serverName	path	True	string	Sunucunun adı.
subscriptionId	path	True	string	Azure aboneliğini tanımlayan abonelik kimliği.
api-version	query	True	string	İstek için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	Database	Belirtilen veritabanı başarıyla alındı.
Other Status Codes		Hata Yanıtları: *** 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok. 404 ResourceNotFound - İstenen kaynak bulunamadı.

Name

Tür

Description

200 OK

Database

Belirtilen veritabanı başarıyla alındı.

Other Status Codes

Hata Yanıtları: ***

404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı
404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok.
404 ResourceNotFound - İstenen kaynak bulunamadı.

Örnekler

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


import com.azure.core.util.Context;

/** 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", 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

Sample Response

Status code:: 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"
}

Tanımlar

Name	Description
BackupStorageRedundancy	Bu veritabanı için yedeklemeleri depolamak için kullanılan depolama hesabı türü.
CatalogCollationType	Meta veri kataloğu harmanlaması.
CreateMode	Veritabanı oluşturma modunu belirtir. Varsayılan: normal veritabanı oluşturma. Kopyala: Veritabanını var olan bir veritabanının kopyası olarak oluşturur. sourceDatabaseId, kaynak veritabanının kaynak kimliği olarak belirtilmelidir. İkincil: Mevcut bir veritabanının ikincil çoğaltması olarak bir veritabanı oluşturur. sourceDatabaseId, mevcut birincil veritabanının kaynak kimliği olarak belirtilmelidir. PointInTimeRestore: Mevcut bir veritabanının belirli bir nokta yedeklemesini geri yükleyerek bir veritabanı oluşturur. mevcut veritabanının kaynak kimliği olarak sourceDatabaseId belirtilmelidir ve restorePointInTime belirtilmelidir. Kurtarma: Coğrafi olarak çoğaltılmış bir yedeklemeyi geri yükleyerek bir veritabanı oluşturur. geri yüklenecek kurtarılabilir veritabanı kaynak kimliği olarak sourceDatabaseId belirtilmelidir. Geri Yükleme: Silinen bir veritabanının yedeğini geri yükleyerek bir veritabanı oluşturur. sourceDatabaseId belirtilmelidir. Veritabanının özgün kaynak kimliği sourceDatabaseId ise sourceDatabaseDeletionDate belirtilmelidir. Aksi takdirde sourceDatabaseId geri yüklenebilir bırakılan veritabanı kaynak kimliği olmalıdır ve sourceDatabaseDeletionDate yoksayılır. restorePointInTime, zamanın önceki bir noktasından geri yüklemek için de belirtilebilir. RestoreLongTermRetentionBackup: Uzun süreli saklama kasasından geri yükleyerek bir veritabanı oluşturur. kurtarma noktası kaynak kimliği olarak recoveryServicesRecoveryPointResourceId belirtilmelidir. Copy, Secondary ve RestoreLongTermRetentionBackup, DataWarehouse sürümü için desteklenmez.
Database	Veritabanı kaynağı.
DatabaseIdentity	Bir kaynak için Azure Active Directory kimlik yapılandırması.
DatabaseIdentityType	Kimlik türü
DatabaseLicenseType	Bu veritabanı için uygulanacak lisans türü. `LicenseIncluded`lisansa ihtiyacınız varsa veya `BasePrice` lisansınız varsa ve Azure Hibrit Avantajı için uygunsanız.
DatabaseReadScale	Salt okunur yönlendirmenin durumu. Etkinleştirilirse, uygulama amacı bağlantı dizesi salt okunur olarak ayarlanmış bağlantılar aynı bölgedeki salt okunur ikincil çoğaltmaya yönlendirilebilir. Elastik havuz içindeki hiper ölçek veritabanı için geçerli değildir.
DatabaseStatus	Veritabanının durumu.
DatabaseUserIdentity	Bir kaynak için Azure Active Directory kimlik yapılandırması.
SampleName	Bu veritabanını oluştururken uygulanacak örnek şemanın adı.
SecondaryType	İkincil bir veritabanıysa, veritabanının ikincil türü. Geçerli değerler Geo ve Named değerleridir.
Sku	ARM Kaynağı SKU'su.

BackupStorageRedundancy

Bu veritabanı için yedeklemeleri depolamak için kullanılan depolama hesabı türü.

Name	Tür	Description
Geo	string
GeoZone	string
Local	string
Zone	string

CatalogCollationType

Meta veri kataloğu harmanlaması.

Name	Tür	Description
DATABASE_DEFAULT	string
SQL_Latin1_General_CP1_CI_AS	string

CreateMode

Veritabanı oluşturma modunu belirtir.

Varsayılan: normal veritabanı oluşturma.

Kopyala: Veritabanını var olan bir veritabanının kopyası olarak oluşturur. sourceDatabaseId, kaynak veritabanının kaynak kimliği olarak belirtilmelidir.

İkincil: Mevcut bir veritabanının ikincil çoğaltması olarak bir veritabanı oluşturur. sourceDatabaseId, mevcut birincil veritabanının kaynak kimliği olarak belirtilmelidir.

PointInTimeRestore: Mevcut bir veritabanının belirli bir nokta yedeklemesini geri yükleyerek bir veritabanı oluşturur. mevcut veritabanının kaynak kimliği olarak sourceDatabaseId belirtilmelidir ve restorePointInTime belirtilmelidir.

Kurtarma: Coğrafi olarak çoğaltılmış bir yedeklemeyi geri yükleyerek bir veritabanı oluşturur. geri yüklenecek kurtarılabilir veritabanı kaynak kimliği olarak sourceDatabaseId belirtilmelidir.

Geri Yükleme: Silinen bir veritabanının yedeğini geri yükleyerek bir veritabanı oluşturur. sourceDatabaseId belirtilmelidir. Veritabanının özgün kaynak kimliği sourceDatabaseId ise sourceDatabaseDeletionDate belirtilmelidir. Aksi takdirde sourceDatabaseId geri yüklenebilir bırakılan veritabanı kaynak kimliği olmalıdır ve sourceDatabaseDeletionDate yoksayılır. restorePointInTime, zamanın önceki bir noktasından geri yüklemek için de belirtilebilir.

RestoreLongTermRetentionBackup: Uzun süreli saklama kasasından geri yükleyerek bir veritabanı oluşturur. kurtarma noktası kaynak kimliği olarak recoveryServicesRecoveryPointResourceId belirtilmelidir.

Copy, Secondary ve RestoreLongTermRetentionBackup, DataWarehouse sürümü için desteklenmez.

Name	Tür	Description
Copy	string
Default	string
OnlineSecondary	string
PointInTimeRestore	string
Recovery	string
Restore	string
RestoreExternalBackup	string
RestoreExternalBackupSecondary	string
RestoreLongTermRetentionBackup	string
Secondary	string

Database

Veritabanı kaynağı.

Name	Tür	Description
id	string	Kaynak Kimliği.
identity	DatabaseIdentity	Veritabanının Azure Active Directory kimliği.
kind	string	Veritabanı türü. Bu, Azure portal deneyimi için kullanılan meta verilerdir.
location	string	Kaynak konumu.
managedBy	string	Veritabanını yöneten kaynak.
name	string	Kaynak adı.
properties.autoPauseDelay	integer	Veritabanının otomatik olarak duraklatıldığı dakika cinsinden süre. -1 değeri, otomatik duraklamanın devre dışı bırakıldığını gösterir
properties.catalogCollation	CatalogCollationType	Meta veri kataloğu harmanlaması.
properties.collation	string	Veritabanının harmanlaması.
properties.createMode	CreateMode	Veritabanı oluşturma modunu belirtir. Varsayılan: normal veritabanı oluşturma. Kopyala: Veritabanını var olan bir veritabanının kopyası olarak oluşturur. sourceDatabaseId, kaynak veritabanının kaynak kimliği olarak belirtilmelidir. İkincil: Veritabanını var olan bir veritabanının ikincil çoğaltması olarak oluşturur. sourceDatabaseId, mevcut birincil veritabanının kaynak kimliği olarak belirtilmelidir. PointInTimeRestore: Mevcut bir veritabanının belirli bir nokta yedeklemesini geri yükleyerek bir veritabanı oluşturur. sourceDatabaseId mevcut veritabanının kaynak kimliği olarak belirtilmelidir ve restorePointInTime belirtilmelidir. Kurtarma: Coğrafi olarak çoğaltılmış bir yedeklemeyi geri yükleyerek bir veritabanı oluşturur. geri yüklenecek kurtarılabilir veritabanı kaynak kimliği olarak sourceDatabaseId belirtilmelidir. Geri Yükleme: Silinen bir veritabanının yedeğini geri yükleyerek bir veritabanı oluşturur. sourceDatabaseId belirtilmelidir. sourceDatabaseId veritabanının özgün kaynak kimliğiyse sourceDatabaseDeletionDate belirtilmelidir. Aksi takdirde sourceDatabaseId geri yüklenebilir bırakılan veritabanı kaynak kimliği olmalıdır ve sourceDatabaseDeletionDate yoksayılır. zamanın önceki bir noktasından geri yüklemek için restorePointInTime da belirtilebilir. RestoreLongTermRetentionBackup: Uzun süreli saklama kasasından geri yükleyerek bir veritabanı oluşturur. recoveryServicesRecoveryPointResourceId, kurtarma noktası kaynak kimliği olarak belirtilmelidir. Copy, Secondary ve RestoreLongTermRetentionBackup, DataWarehouse sürümü için desteklenmez.
properties.creationDate	string	Veritabanının oluşturulma tarihi (ISO8601 biçimi).
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Bu veritabanının yedeklerini depolamak için kullanılan depolama hesabı türü.
properties.currentServiceObjectiveName	string	Veritabanının geçerli hizmet düzeyi hedef adı.
properties.currentSku	Sku	SKU'nun adı ve katmanı.
properties.databaseId	string	Veritabanının kimliği.
properties.defaultSecondaryLocation	string	Bu veritabanı için varsayılan ikincil bölge.
properties.earliestRestoreDate	string	Bu, bu veritabanı için geri yüklemenin kullanılabilir olduğu en erken başlangıç tarihini ve saatini kaydeder (ISO8601 biçimi).
properties.elasticPoolId	string	Bu veritabanını içeren elastik havuzun kaynak tanımlayıcısı.
properties.failoverGroupId	string	Bu veritabanının ait olduğu Yük Devretme Grubu kaynak tanımlayıcısı.
properties.federatedClientId	string	Veritabanı başına kiracılar arası CMK senaryosu için kullanılan İstemci kimliği
properties.highAvailabilityReplicaCount	integer	Veritabanıyla ilişkilendirilmiş ve yüksek kullanılabilirlik sağlamak için kullanılan ikincil çoğaltmaların sayısı. Elastik havuz içindeki hiper ölçek veritabanı için geçerli değildir.
properties.isInfraEncryptionEnabled	boolean	Bu veritabanı için altyapı şifrelemesi etkinleştirildi.
properties.isLedgerOn	boolean	Bu veritabanının bir kayıt defteri veritabanı olup olmadığı, veritabanındaki tüm tabloların kayıt defteri tabloları olduğu anlamına gelir. Not: Veritabanı oluşturulduktan sonra bu özelliğin değeri değiştirilemez.
properties.licenseType	DatabaseLicenseType	Bu veritabanı için uygulanacak lisans türü. `LicenseIncluded`lisansa ihtiyacınız varsa veya `BasePrice` lisansınız varsa ve Azure Hibrit Avantajı için uygunsanız.
properties.longTermRetentionBackupResourceId	string	Bu veritabanının oluşturma işlemiyle ilişkili uzun süreli saklama yedeklemesinin kaynak tanımlayıcısı.
properties.maintenanceConfigurationId	string	Veritabanına atanan bakım yapılandırma kimliği. Bu yapılandırma, bakım güncelleştirmelerinin gerçekleşeceği dönemi tanımlar.
properties.maxLogSizeBytes	integer	Bu veritabanı için en büyük günlük boyutu.
properties.maxSizeBytes	integer	Veritabanının bayt cinsinden ifade edilen en büyük boyutu.
properties.minCapacity	number	Duraklatılmadıysa veritabanının her zaman ayıracağı en düşük kapasite
properties.pausedDate	string	Veritabanının kullanıcı yapılandırması veya eylemi (ISO8601 biçimi) tarafından duraklatıldığı tarih. Veritabanı hazırsa null.
properties.readScale	DatabaseReadScale	Salt okunur yönlendirmenin durumu. Etkinleştirilirse, uygulama amacı bağlantı dizesi salt okunur olarak ayarlanmış bağlantılar aynı bölgedeki salt okunur ikincil çoğaltmaya yönlendirilebilir. Elastik havuz içindeki hiper ölçek veritabanı için geçerli değildir.
properties.recoverableDatabaseId	string	Bu veritabanının oluşturma işlemiyle ilişkili kurtarılabilir veritabanının kaynak tanımlayıcısı.
properties.recoveryServicesRecoveryPointId	string	Bu veritabanının oluşturma işlemiyle ilişkili kurtarma noktasının kaynak tanımlayıcısı.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Bu veritabanının yedeklerini depolamak için kullanılacak depolama hesabı türü.
properties.requestedServiceObjectiveName	string	Veritabanının istenen hizmet düzeyi hedef adı.
properties.restorableDroppedDatabaseId	string	Bu veritabanının oluşturma işlemiyle ilişkili geri yüklenebilen bırakılan veritabanının kaynak tanımlayıcısı.
properties.restorePointInTime	string	Yeni veritabanını oluşturmak için geri yüklenecek kaynak veritabanının zaman noktasını (ISO8601 biçimi) belirtir.
properties.resumedDate	string	Veritabanının kullanıcı eylemi veya veritabanı oturum açma (ISO8601 biçimi) tarafından sürdürüldiği tarih. Veritabanı duraklatıldıysa null.
properties.sampleName	SampleName	Bu veritabanı oluşturulurken uygulanacak örnek şemanın adı.
properties.secondaryType	SecondaryType	İkincil bir veritabanıysa, veritabanının ikincil türü. Geçerli değerler Coğrafi ve Adlandırılmış değerlerdir.
properties.sourceDatabaseDeletionDate	string	Veritabanının silindiği saati belirtir.
properties.sourceDatabaseId	string	Bu veritabanının oluşturma işlemiyle ilişkili kaynak veritabanının kaynak tanımlayıcısı.
properties.sourceResourceId	string	Bu veritabanının oluşturma işlemiyle ilişkili kaynağın kaynak tanımlayıcısı. Bu özellik yalnızca DataWarehouse sürümü için desteklenir ve abonelikler arasında geri yüklemeye izin verir. sourceResourceId belirtildiğinde sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId ve sourceDatabaseDeletionDate belirtilmemeli ve CreateMode PointInTimeRestore, Restore veya Recover olmalıdır. createMode PointInTimeRestore olduğunda sourceResourceId mevcut veritabanının veya mevcut SQL havuzunun kaynak kimliği olmalı ve restorePointInTime belirtilmelidir. createMode Geri Yükleme olduğunda sourceResourceId geri yüklenebilir bırakılan veritabanının veya geri yüklenebilir bırakılan SQL havuzunun kaynak kimliği olmalıdır. createMode Kurtar olduğunda sourceResourceId kurtarılabilir veritabanının veya kurtarılabilir SQL havuzunun kaynak kimliği olmalıdır. Kaynak abonelik hedef abonelikten farklı bir kiracıya aitse, "x-ms-authorization-auxiliary" üst bilgisi kaynak kiracı için kimlik doğrulama belirteci içermelidir. "x-ms-authorization-auxiliary" üst bilgisi hakkında daha fazla ayrıntı için bkz. https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
properties.status	DatabaseStatus	Veritabanının durumu.
properties.zoneRedundant	boolean	Bu veritabanının alanlar arası yedekli olup olmadığı, bu veritabanının çoğaltmalarının birden çok kullanılabilirlik alanına yayılacağı anlamına gelir.
sku	Sku	Veritabanı SKU'su. SKU'ların listesi bölgeye ve destek teklifine göre farklılık gösterebilir. Bir Azure bölgesindeki aboneliğinizde kullanılabilen SKU'ları (SKU adı, katman/sürüm, aile ve kapasite dahil) belirlemek için REST API'sini `Capabilities_ListByLocation` veya aşağıdaki komutlardan birini kullanın: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
tags	object	Kaynak etiketleri.
type	string	Kaynak türü.

DatabaseIdentity

Bir kaynak için Azure Active Directory kimlik yapılandırması.

Name	Tür	Description
tenantId	string	Azure Active Directory kiracı kimliği.
type	DatabaseIdentityType	Kimlik türü
userAssignedIdentities	<string, DatabaseUserIdentity>	Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri

DatabaseIdentityType

Kimlik türü

Name	Tür	Description
None	string
UserAssigned	string

DatabaseLicenseType

Bu veritabanı için uygulanacak lisans türü. LicenseIncludedlisansa ihtiyacınız varsa veya BasePrice lisansınız varsa ve Azure Hibrit Avantajı için uygunsanız.

Name	Tür	Description
BasePrice	string
LicenseIncluded	string

DatabaseReadScale

Salt okunur yönlendirmenin durumu. Etkinleştirilirse, uygulama amacı bağlantı dizesi salt okunur olarak ayarlanmış bağlantılar aynı bölgedeki salt okunur ikincil çoğaltmaya yönlendirilebilir. Elastik havuz içindeki hiper ölçek veritabanı için geçerli değildir.

Name	Tür	Description
Disabled	string
Enabled	string

DatabaseStatus

Veritabanının durumu.

Name	Tür	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

Bir kaynak için Azure Active Directory kimlik yapılandırması.

Name	Tür	Description
clientId	string	Azure Active Directory istemci kimliği.
principalId	string	Azure Active Directory asıl kimliği.

SampleName

Bu veritabanını oluştururken uygulanacak örnek şemanın adı.

Name	Tür	Description
AdventureWorksLT	string
WideWorldImportersFull	string
WideWorldImportersStd	string

SecondaryType

İkincil bir veritabanıysa, veritabanının ikincil türü. Geçerli değerler Geo ve Named değerleridir.

Name	Tür	Description
Geo	string
Named	string

Sku

ARM Kaynağı SKU'su.

Name	Tür	Description
capacity	integer	Belirli bir SKU'nun kapasitesi.
family	string	Hizmetin aynı SKU için farklı nesil donanımları varsa, bu durum burada yakalanabilir.
name	string	SKU adı, genellikle bir harf + Sayı kodu, örneğin P3.
size	string	Belirli SKU'nun boyutu
tier	string	Belirli bir SKU'nun katmanı veya sürümü, örneğin Temel, Premium.

Databases - Get

URI Parametreleri

Yanıtlar

Örnekler

Gets a database.

Sample Request

Sample Response

Tanımlar

BackupStorageRedundancy

CatalogCollationType

CreateMode

Database

DatabaseIdentity

DatabaseIdentityType

DatabaseLicenseType

DatabaseReadScale

DatabaseStatus

DatabaseUserIdentity

SampleName

SecondaryType

Sku

Ek kaynaklar