Databases - Get

  • Başvuru
Service:
SQL Database
API Version:
2021-11-01-preview

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-preview

URI Parametreleri

Name In Required Type 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 Type Description
200 OK

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.

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

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

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ü. LicenseIncludedlisansa 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, bağlantı dizesinde uygulama amacı 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 Type Description
Geo
  • string
GeoZone
  • string
Local
  • string
Zone
  • string

CatalogCollationType

Meta veri kataloğu harmanlaması.

Name Type 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 Type 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 Type Description
id
  • string

Kaynak Kimliği.
identity

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

Meta veri kataloğu harmanlaması.
properties.collation
  • string

Veritabanının harmanlaması.
properties.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

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'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

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.
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

Salt okunur yönlendirmenin durumu. Etkinleştirilirse, bağlantı dizelerinde uygulama amacı 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

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üklenebilir 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 işlemi (ISO8601 biçimi) tarafından sürdürüldiği tarih. Veritabanı duraklatıldıysa null.
properties.sampleName

Bu veritabanı oluşturulurken uygulanacak örnek şemanın adı.
properties.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

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

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 Type Description
tenantId
  • string

Azure Active Directory kiracı kimliği.
type

Kimlik türü
userAssignedIdentities

Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri

DatabaseIdentityType

Kimlik türü

Name Type 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 Type Description
BasePrice
  • string
LicenseIncluded
  • string

DatabaseReadScale

Salt okunur yönlendirmenin durumu. Etkinleştirilirse, bağlantı dizesinde uygulama amacı 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 Type Description
Disabled
  • string
Enabled
  • string

DatabaseStatus

Veritabanının durumu.

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
Starting
  • string
Stopped
  • string
Stopping
  • string
Suspect
  • string

DatabaseUserIdentity

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

Name Type 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 Type 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 Type Description
Geo
  • string
Named
  • string

Sku

ARM Kaynağı SKU'su.

Name Type 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.