Databases - Get

Mendapatkan database.

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

Parameter URI

Name In Required Type Description
databaseName
path True
  • string

Nama database.

resourceGroupName
path True
  • string

Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.

serverName
path True
  • string

Nama server.

subscriptionId
path True
  • string

ID langganan yang mengidentifikasi langganan Azure.

api-version
query True
  • string

Versi API yang digunakan untuk permintaan.

Respons

Name Type Description
200 OK

Berhasil mengambil database yang ditentukan.

Other Status Codes

Respons Kesalahan: ***

  • 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan

  • 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan.

  • 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan.

Contoh

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

Definisi

CatalogCollationType

Kolate katalog metadata.

CreateMode

Menentukan mode pembuatan database.

Default: pembuatan database reguler.

Salin: membuat database sebagai salinan database yang sudah ada. sourceDatabaseId harus ditentukan sebagai ID sumber daya database sumber.

Sekunder: membuat database sebagai replika sekunder dari database yang ada. sourceDatabaseId harus ditentukan sebagai ID sumber daya dari database utama yang ada.

PointInTimeRestore: Membuat database dengan memulihkan cadangan titik waktu database yang sudah ada. sourceDatabaseId harus ditentukan sebagai ID sumber daya database yang ada, dan restorePointInTime harus ditentukan.

Pemulihan: Membuat database dengan memulihkan cadangan yang direplikasi secara geografis. sourceDatabaseId harus ditentukan sebagai ID sumber daya database yang dapat dipulihkan untuk dipulihkan.

Pemulihan: Membuat database dengan memulihkan cadangan database yang dihapus. sourceDatabaseId harus ditentukan. Jika sourceDatabaseId adalah ID sumber daya asli database, maka sourceDatabaseDeletionDate harus ditentukan. Jika tidak, sourceDatabaseId harus berupa ID sumber daya database yang dihilangkan dan sourceDatabaseDeletionDate diabaikan. restorePointInTime juga dapat ditentukan untuk memulihkan dari titik waktu sebelumnya.

RestoreLongTermRetentionBackup: Membuat database dengan memulihkan dari vault retensi jangka panjang. recoveryServicesRecoveryPointResourceId harus ditentukan sebagai ID sumber daya titik pemulihan.

Copy, Secondary, dan RestoreLongTermRetentionBackup tidak didukung untuk edisi DataWarehouse.

CurrentBackupStorageRedundancy

Jenis akun penyimpanan yang digunakan untuk menyimpan cadangan untuk database ini.

Database

Sumber daya database.

DatabaseLicenseType

Jenis lisensi yang akan diterapkan untuk database ini. LicenseIncluded jika Anda memerlukan lisensi, atau BasePrice jika Anda memiliki lisensi dan memenuhi syarat untuk Azure Hybrid Benefit.

DatabaseReadScale

Status perutean baca-saja. Jika diaktifkan, koneksi yang memiliki niat aplikasi diatur ke baca-saja di string koneksi mereka dapat dirutekan ke replika sekunder baca-saja di wilayah yang sama.

DatabaseStatus

Status database.

RequestedBackupStorageRedundancy

Jenis akun penyimpanan yang akan digunakan untuk menyimpan cadangan untuk database ini.

SampleName

Nama skema sampel yang akan diterapkan saat membuat database ini.

SecondaryType

Jenis sekunder database jika merupakan sekunder. Nilai yang valid adalah Geo dan Named.

Sku

SKU Sumber Daya ARM.

CatalogCollationType

Kolate katalog metadata.

Name Type Description
DATABASE_DEFAULT
  • string
SQL_Latin1_General_CP1_CI_AS
  • string

CreateMode

Menentukan mode pembuatan database.

Default: pembuatan database reguler.

Salin: membuat database sebagai salinan database yang sudah ada. sourceDatabaseId harus ditentukan sebagai ID sumber daya database sumber.

Sekunder: membuat database sebagai replika sekunder dari database yang ada. sourceDatabaseId harus ditentukan sebagai ID sumber daya dari database utama yang ada.

PointInTimeRestore: Membuat database dengan memulihkan cadangan titik waktu database yang sudah ada. sourceDatabaseId harus ditentukan sebagai ID sumber daya database yang ada, dan restorePointInTime harus ditentukan.

Pemulihan: Membuat database dengan memulihkan cadangan yang direplikasi secara geografis. sourceDatabaseId harus ditentukan sebagai ID sumber daya database yang dapat dipulihkan untuk dipulihkan.

Pemulihan: Membuat database dengan memulihkan cadangan database yang dihapus. sourceDatabaseId harus ditentukan. Jika sourceDatabaseId adalah ID sumber daya asli database, maka sourceDatabaseDeletionDate harus ditentukan. Jika tidak, sourceDatabaseId harus berupa ID sumber daya database yang dihilangkan dan sourceDatabaseDeletionDate diabaikan. restorePointInTime juga dapat ditentukan untuk memulihkan dari titik waktu sebelumnya.

RestoreLongTermRetentionBackup: Membuat database dengan memulihkan dari vault retensi jangka panjang. recoveryServicesRecoveryPointResourceId harus ditentukan sebagai ID sumber daya titik pemulihan.

Copy, Secondary, dan RestoreLongTermRetentionBackup tidak didukung untuk edisi 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

Jenis akun penyimpanan yang digunakan untuk menyimpan cadangan untuk database ini.

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

Database

Sumber daya database.

Name Type Description
id
  • string

ID Sumber Daya.

kind
  • string

Jenis database. Ini adalah metadata yang digunakan untuk pengalaman portal Azure.

location
  • string

Lokasi sumber daya.

managedBy
  • string

Sumber daya yang mengelola database.

name
  • string

Nama sumber daya.

properties.autoPauseDelay
  • integer

Waktu dalam menit setelah database dijeda secara otomatis. Nilai -1 berarti jeda otomatis dinonaktifkan

properties.catalogCollation

Kolate katalog metadata.

properties.collation
  • string

Kolatasi database.

properties.createMode

Menentukan mode pembuatan database.

Default: pembuatan database reguler.

Salin: membuat database sebagai salinan database yang sudah ada. sourceDatabaseId harus ditentukan sebagai ID sumber daya database sumber.

Sekunder: membuat database sebagai replika sekunder dari database yang ada. sourceDatabaseId harus ditentukan sebagai ID sumber daya dari database utama yang ada.

PointInTimeRestore: Membuat database dengan memulihkan cadangan titik waktu database yang sudah ada. sourceDatabaseId harus ditentukan sebagai ID sumber daya database yang ada, dan restorePointInTime harus ditentukan.

Pemulihan: Membuat database dengan memulihkan cadangan yang direplikasi secara geografis. sourceDatabaseId harus ditentukan sebagai ID sumber daya database yang dapat dipulihkan untuk dipulihkan.

Pemulihan: Membuat database dengan memulihkan cadangan database yang dihapus. sourceDatabaseId harus ditentukan. Jika sourceDatabaseId adalah ID sumber daya asli database, maka sourceDatabaseDeletionDate harus ditentukan. Jika tidak, sourceDatabaseId harus berupa ID sumber daya database yang dihilangkan dan sourceDatabaseDeletionDate diabaikan. restorePointInTime juga dapat ditentukan untuk memulihkan dari titik waktu sebelumnya.

RestoreLongTermRetentionBackup: Membuat database dengan memulihkan dari vault retensi jangka panjang. recoveryServicesRecoveryPointResourceId harus ditentukan sebagai ID sumber daya titik pemulihan.

Copy, Secondary, dan RestoreLongTermRetentionBackup tidak didukung untuk edisi DataWarehouse.

properties.creationDate
  • string

Tanggal pembuatan database (format ISO8601).

properties.currentBackupStorageRedundancy

Jenis akun penyimpanan yang digunakan untuk menyimpan cadangan untuk database ini.

properties.currentServiceObjectiveName
  • string

Nama tujuan tingkat layanan database saat ini.

properties.currentSku

Nama dan tingkat SKU.

properties.databaseId
  • string

ID database.

properties.defaultSecondaryLocation
  • string

Wilayah sekunder default untuk database ini.

properties.earliestRestoreDate
  • string

Ini mencatat tanggal dan waktu mulai paling awal yang pemulihan tersedia untuk database ini (format ISO8601).

properties.elasticPoolId
  • string

Pengidentifikasi sumber daya kumpulan elastis yang berisi database ini.

properties.failoverGroupId
  • string

Pengidentifikasi sumber daya Grup Failover tempat database ini berada.

properties.highAvailabilityReplicaCount
  • integer

Jumlah replika sekunder yang terkait dengan database yang digunakan untuk memberikan ketersediaan tinggi.

properties.licenseType

Jenis lisensi yang akan diterapkan untuk database ini. LicenseIncluded jika Anda memerlukan lisensi, atau BasePrice jika Anda memiliki lisensi dan memenuhi syarat untuk Azure Hybrid Benefit.

properties.longTermRetentionBackupResourceId
  • string

Pengidentifikasi sumber daya cadangan retensi jangka panjang yang terkait dengan operasi pembuatan database ini.

properties.maintenanceConfigurationId
  • string

Id konfigurasi pemeliharaan yang ditetapkan ke database. Konfigurasi ini menentukan periode kapan pembaruan pemeliharaan akan terjadi.

properties.maxLogSizeBytes
  • integer

Ukuran log maks untuk database ini.

properties.maxSizeBytes
  • integer

Ukuran maksimum database yang dinyatakan dalam byte.

properties.minCapacity
  • number

Kapasitas minimal yang akan selalu dialokasikan database, jika tidak dijeda

properties.pausedDate
  • string

Tanggal ketika database dijeda oleh konfigurasi atau tindakan pengguna (format ISO8601). Null jika database sudah siap.

properties.readScale

Status perutean baca-saja. Jika diaktifkan, koneksi yang memiliki niat aplikasi diatur ke baca-saja di string koneksi mereka dapat dirutekan ke replika sekunder baca-saja di wilayah yang sama.

properties.recoverableDatabaseId
  • string

Pengidentifikasi sumber daya database yang dapat dipulihkan yang terkait dengan operasi pembuatan database ini.

properties.recoveryServicesRecoveryPointId
  • string

Pengidentifikasi sumber daya titik pemulihan yang terkait dengan operasi pembuatan database ini.

properties.requestedBackupStorageRedundancy

Jenis akun penyimpanan yang akan digunakan untuk menyimpan cadangan untuk database ini.

properties.requestedServiceObjectiveName
  • string

Nama tujuan tingkat layanan database yang diminta.

properties.restorableDroppedDatabaseId
  • string

Pengidentifikasi sumber daya database yang dapat dihilangkan yang dapat dihilangkan yang terkait dengan operasi pembuatan database ini.

properties.restorePointInTime
  • string

Menentukan titik waktu (format ISO8601) dari database sumber yang akan dipulihkan untuk membuat database baru.

properties.resumedDate
  • string

Tanggal ketika database dilanjutkan oleh tindakan pengguna atau login database (format ISO8601). Null jika database dijeda.

properties.sampleName

Nama skema sampel yang akan diterapkan saat membuat database ini.

properties.secondaryType

Jenis sekunder database jika merupakan sekunder. Nilai yang valid adalah Geo dan Named.

properties.sourceDatabaseDeletionDate
  • string

Menentukan waktu database dihapus.

properties.sourceDatabaseId
  • string

Pengidentifikasi sumber daya database sumber yang terkait dengan operasi pembuatan database ini.

properties.status

Status database.

properties.zoneRedundant
  • boolean

Apakah database ini zona redundan atau tidak, yang berarti replika database ini akan tersebar di beberapa zona ketersediaan.

sku

SKU database.

Daftar SKU dapat bervariasi menurut wilayah dan penawaran dukungan. Untuk menentukan SKU (termasuk nama SKU, tingkat/edisi, keluarga, dan kapasitas) yang tersedia untuk langganan Anda di wilayah Azure, gunakan Capabilities_ListByLocation REST API atau salah satu perintah berikut:

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

Tag sumber daya.

type
  • string

Jenis sumber daya

DatabaseLicenseType

Jenis lisensi yang akan diterapkan untuk database ini. LicenseIncluded jika Anda memerlukan lisensi, atau BasePrice jika Anda memiliki lisensi dan memenuhi syarat untuk Azure Hybrid Benefit.

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

DatabaseReadScale

Status perutean baca-saja. Jika diaktifkan, koneksi yang memiliki niat aplikasi diatur ke baca-saja di string koneksi mereka dapat dirutekan ke replika sekunder baca-saja di wilayah yang sama.

Name Type Description
Disabled
  • string
Enabled
  • string

DatabaseStatus

Status database.

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

Jenis akun penyimpanan yang akan digunakan untuk menyimpan cadangan untuk database ini.

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

SampleName

Nama skema sampel yang akan diterapkan saat membuat database ini.

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

SecondaryType

Jenis sekunder database jika merupakan sekunder. Nilai yang valid adalah Geo dan Named.

Name Type Description
Geo
  • string
Named
  • string

Sku

SKU Sumber Daya ARM.

Name Type Description
capacity
  • integer

Kapasitas SKU tertentu.

family
  • string

Jika layanan memiliki generasi perangkat keras yang berbeda, untuk SKU yang sama, maka itu dapat ditangkap di sini.

name
  • string

Nama SKU, biasanya, kode huruf + Angka, misalnya P3.

size
  • string

Ukuran SKU tertentu

tier
  • string

Tingkat atau edisi SKU tertentu, misalnya Dasar, Premium.