Databases - Get

Ottiene un database.

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

Parametri dell'URI

Name In Required Type Description
databaseName
path True
  • string

Nome del database.

resourceGroupName
path True
  • string

Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.

serverName
path True
  • string

Nome del server.

subscriptionId
path True
  • string

ID sottoscrizione che identifica una sottoscrizione di Azure.

api-version
query True
  • string

Versione dell'API da usare per la richiesta.

Risposte

Name Type Description
200 OK

È stato recuperato correttamente il database specificato.

Other Status Codes

Risposte di errore:

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

  • 404 ResourceNotFound: la risorsa richiesta non è stata trovata.

Esempio

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

Definizioni

CatalogCollationType

Regole di confronto del catalogo dei metadati.

CreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminata ripristinabile e sourceDatabaseDeletionDate viene ignorato. restorePointInTime può essere specificato anche per ripristinare da un momento precedente.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copy, Secondary e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.

CurrentBackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questo database.

Database

Risorsa di database.

DatabaseLicenseType

Tipo di licenza da applicare per questo database. LicenseIncludedse è necessaria una licenza o BasePrice se si dispone di una licenza e si è idonei per il Vantaggio Azure Hybrid.

DatabaseReadScale

Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nel stringa di connessione possono essere instradate a una replica secondaria di sola lettura nella stessa area.

DatabaseStatus

Stato del database.

RequestedBackupStorageRedundancy

Tipo di account di archiviazione da usare per archiviare i backup per questo database.

SampleName

Nome dello schema di esempio da applicare durante la creazione di questo database.

SecondaryType

Tipo secondario del database se è secondario. I valori validi sono Geo e Named.

Sku

SKU di risorsa arm.

CatalogCollationType

Regole di confronto del catalogo dei metadati.

Name Type Description
DATABASE_DEFAULT
  • string
SQL_Latin1_General_CP1_CI_AS
  • string

CreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminata ripristinabile e sourceDatabaseDeletionDate viene ignorato. restorePointInTime può essere specificato anche per ripristinare da un momento precedente.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copy, Secondary e RestoreLongTermRetentionBackup non sono supportati per l'edizione 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

Tipo di account di archiviazione usato per archiviare i backup per questo database.

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

Database

Risorsa di database.

Name Type Description
id
  • string

ID risorsa.

kind
  • string

Tipo di database. Si tratta di metadati usati per l'esperienza di portale di Azure.

location
  • string

Percorso della risorsa.

managedBy
  • string

Risorsa che gestisce il database.

name
  • string

Nome risorsa.

properties.autoPauseDelay
  • integer

Tempo in minuti dopo il quale il database viene automaticamente sospeso. Il valore -1 indica che la sospensione automatica è disabilitata

properties.catalogCollation

Regole di confronto del catalogo dei metadati.

properties.collation
  • string

Regole di confronto del database.

properties.createMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminata ripristinabile e sourceDatabaseDeletionDate viene ignorato. restorePointInTime può essere specificato anche per ripristinare da un momento precedente.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copy, Secondary e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.

properties.creationDate
  • string

Data di creazione del database (formato ISO8601).

properties.currentBackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questo database.

properties.currentServiceObjectiveName
  • string

Nome obiettivo del livello di servizio corrente del database.

properties.currentSku

Nome e livello dello SKU.

properties.databaseId
  • string

ID del database.

properties.defaultSecondaryLocation
  • string

Area secondaria predefinita per questo database.

properties.earliestRestoreDate
  • string

Questo registra la data e l'ora di inizio più recente disponibili per questo database (formato ISO8601).

properties.elasticPoolId
  • string

Identificatore di risorsa del pool elastico contenente questo database.

properties.failoverGroupId
  • string

Identificatore di risorsa gruppo di failover a cui appartiene il database.

properties.highAvailabilityReplicaCount
  • integer

Numero di repliche secondarie associate al database usato per fornire disponibilità elevata.

properties.licenseType

Tipo di licenza da applicare per questo database. LicenseIncludedse è necessaria una licenza o BasePrice se si dispone di una licenza e si è idonei per il Vantaggio Azure Hybrid.

properties.longTermRetentionBackupResourceId
  • string

Identificatore di risorsa del backup di conservazione a lungo termine associato all'operazione di creazione di questo database.

properties.maintenanceConfigurationId
  • string

ID di configurazione della manutenzione assegnato al database. Questa configurazione definisce il periodo in cui si verificheranno gli aggiornamenti della manutenzione.

properties.maxLogSizeBytes
  • integer

Dimensioni massime del log per questo database.

properties.maxSizeBytes
  • integer

Dimensioni massime del database espresso in byte.

properties.minCapacity
  • number

Capacità minima che il database avrà sempre allocato, se non sospeso

properties.pausedDate
  • string

Data in cui il database è stato sospeso dalla configurazione utente o dall'azione(formato ISO8601). Null se il database è pronto.

properties.readScale

Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nella propria stringa di connessione possono essere indirizzate a una replica secondaria di lettura nella stessa area.

properties.recoverableDatabaseId
  • string

Identificatore di risorsa del database recuperabile associato all'operazione di creazione del database.

properties.recoveryServicesRecoveryPointId
  • string

Identificatore della risorsa del punto di ripristino associato all'operazione di creazione di questo database.

properties.requestedBackupStorageRedundancy

Tipo di account di archiviazione da usare per archiviare i backup per questo database.

properties.requestedServiceObjectiveName
  • string

Nome obiettivo del livello di servizio richiesto del database.

properties.restorableDroppedDatabaseId
  • string

Identificatore della risorsa del database eliminato ripristinabile associato all'operazione di creazione del database.

properties.restorePointInTime
  • string

Specifica il formato ISO8601 del database di origine che verrà ripristinato per creare il nuovo database.

properties.resumedDate
  • string

Data in cui il database è stato ripreso dall'azione utente o dall'account di accesso al database (formato ISO8601). Null se il database viene sospeso.

properties.sampleName

Nome dello schema di esempio da applicare durante la creazione di questo database.

properties.secondaryType

Tipo secondario del database se è secondario. I valori validi sono Geo e Named.

properties.sourceDatabaseDeletionDate
  • string

Specifica l'ora di eliminazione del database.

properties.sourceDatabaseId
  • string

Identificatore di risorsa del database di origine associato all'operazione di creazione del database.

properties.status

Stato del database.

properties.zoneRedundant
  • boolean

Indipendentemente dal fatto che questo database sia ridondante della zona, ovvero le repliche di questo database verranno distribuite in più zone di disponibilità.

sku

SKU del database.

L'elenco degli SKU può variare in base all'area e all'offerta di supporto. Per determinare gli SKU (inclusi il nome SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API Capabilities_ListByLocation REST o uno dei comandi seguenti:

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

Tag di risorse.

type
  • string

Tipo di risorsa.

DatabaseLicenseType

Tipo di licenza da applicare per questo database. LicenseIncludedse è necessaria una licenza o BasePrice se si dispone di una licenza e si è idonei per il Vantaggio Azure Hybrid.

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

DatabaseReadScale

Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nel stringa di connessione possono essere instradate a una replica secondaria di sola lettura nella stessa area.

Name Type Description
Disabled
  • string
Enabled
  • string

DatabaseStatus

Stato del 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

Tipo di account di archiviazione da usare per archiviare i backup per questo database.

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

SampleName

Nome dello schema di esempio da applicare durante la creazione di questo database.

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

SecondaryType

Tipo secondario del database se è secondario. I valori validi sono Geo e Named.

Name Type Description
Geo
  • string
Named
  • string

Sku

SKU di risorsa arm.

Name Type Description
capacity
  • integer

Capacità dello SKU specifico.

family
  • string

Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.

name
  • string

Il nome dello SKU, in genere, una lettera + Codice Numero, ad esempio P3.

size
  • string

Dimensioni dello SKU specifico

tier
  • string

Livello o edizione dello SKU specifico, ad esempio Basic, Premium.