Databases - Get

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Obtém uma base de dados.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
databaseName	path	True	string	O nome da base de dados.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Respostas

Name	Tipo	Description
200 OK	Database	Obteve com êxito a base de dados especificada.
Other Status Codes		Respostas de Erro: *** 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e subscrição especificados. 404 ResourceNotFound – o recurso pedido não foi encontrado.

Name

Tipo

Description

200 OK

Database

Obteve com êxito a base de dados especificada.

Other Status Codes

Respostas de Erro: ***

404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado
404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e subscrição especificados.
404 ResourceNotFound – o recurso pedido não foi encontrado.

Exemplos

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

Resposta da amostra

Código de estado:: 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"
}

Definições

Name	Description
BackupStorageRedundancy	O tipo de conta de armazenamento utilizado para armazenar cópias de segurança para esta base de dados.
CatalogCollationType	Agrupamento do catálogo de metadados.
CreateMode	Especifica o modo de criação da base de dados. Predefinição: criação regular de bases de dados. Copiar: cria uma base de dados como uma cópia de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados de origem. Secundário: cria uma base de dados como uma réplica secundária de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados primária existente. PointInTimeRestore: cria uma base de dados ao restaurar uma cópia de segurança para um ponto anterior no tempo de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados existente e o restorePointInTime tem de ser especificado. Recuperação: cria uma base de dados ao restaurar uma cópia de segurança georreplicada. sourceDatabaseId tem de ser especificado como o ID de recurso de base de dados recuperável a restaurar. Restauro: cria uma base de dados ao restaurar uma cópia de segurança de uma base de dados eliminada. sourceDatabaseId tem de ser especificado. Se sourceDatabaseId for o ID de recurso original da base de dados, tem de especificar sourceDatabaseDeletionDate. Caso contrário, sourceDatabaseId tem de ser o ID do recurso de base de dados removido recuperável e sourceDatabaseDeletionDate é ignorado. restorePointInTime também pode ser especificado para restaurar a partir de um ponto anterior no tempo. RestoreLongTermRetentionBackup: cria uma base de dados ao restaurar a partir de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId tem de ser especificado como o ID do recurso do ponto de recuperação. Copy, Secondary e RestoreLongTermRetentionBackup não são suportados para a edição DataWarehouse.
Database	Um recurso de base de dados.
DatabaseIdentity	Configuração de identidade do Azure Active Directory para um recurso.
DatabaseIdentityType	O tipo de identidade
DatabaseLicenseType	O tipo de licença a aplicar a esta base de dados. `LicenseIncluded`se precisar de uma licença ou `BasePrice` se tiver uma licença e for elegível para o Benefício Híbrido do Azure.
DatabaseReadScale	O estado do encaminhamento só de leitura. Se estiver ativada, as ligações que tenham a intenção da aplicação definidas de forma só de leitura no respetivo cadeia de ligação podem ser encaminhadas para uma réplica só de leitura secundária na mesma região. Não aplicável a uma base de dados Hyperscale num conjunto elástico.
DatabaseStatus	O estado da base de dados.
DatabaseUserIdentity	Configuração de identidade do Azure Active Directory para um recurso.
SampleName	O nome do esquema de exemplo a aplicar ao criar esta base de dados.
SecondaryType	O tipo secundário da base de dados, se for secundário. Os valores válidos são Geo e Named.
Sku	Um SKU de Recurso do ARM.

BackupStorageRedundancy

O tipo de conta de armazenamento utilizado para armazenar cópias de segurança para esta base de dados.

Name	Tipo	Description
Geo	string
GeoZone	string
Local	string
Zone	string

CatalogCollationType

Agrupamento do catálogo de metadados.

Name	Tipo	Description
DATABASE_DEFAULT	string
SQL_Latin1_General_CP1_CI_AS	string

CreateMode

Especifica o modo de criação da base de dados.

Predefinição: criação regular de bases de dados.

Copiar: cria uma base de dados como uma cópia de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados de origem.

Secundário: cria uma base de dados como uma réplica secundária de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados primária existente.

PointInTimeRestore: cria uma base de dados ao restaurar uma cópia de segurança para um ponto anterior no tempo de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados existente e o restorePointInTime tem de ser especificado.

Recuperação: cria uma base de dados ao restaurar uma cópia de segurança georreplicada. sourceDatabaseId tem de ser especificado como o ID de recurso de base de dados recuperável a restaurar.

Restauro: cria uma base de dados ao restaurar uma cópia de segurança de uma base de dados eliminada. sourceDatabaseId tem de ser especificado. Se sourceDatabaseId for o ID de recurso original da base de dados, tem de especificar sourceDatabaseDeletionDate. Caso contrário, sourceDatabaseId tem de ser o ID do recurso de base de dados removido recuperável e sourceDatabaseDeletionDate é ignorado. restorePointInTime também pode ser especificado para restaurar a partir de um ponto anterior no tempo.

RestoreLongTermRetentionBackup: cria uma base de dados ao restaurar a partir de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId tem de ser especificado como o ID do recurso do ponto de recuperação.

Copy, Secondary e RestoreLongTermRetentionBackup não são suportados para a edição DataWarehouse.

Name	Tipo	Description
Copy	string
Default	string
OnlineSecondary	string
PointInTimeRestore	string
Recovery	string
Restore	string
RestoreExternalBackup	string
RestoreExternalBackupSecondary	string
RestoreLongTermRetentionBackup	string
Secondary	string

Database

Um recurso de base de dados.

Name	Tipo	Description
id	string	ID do Recurso.
identity	DatabaseIdentity	A identidade do Azure Active Directory da base de dados.
kind	string	Tipo de base de dados. Estes são os metadados utilizados para a experiência de portal do Azure.
location	string	Localização do recurso.
managedBy	string	Recurso que gere a base de dados.
name	string	Nome do recurso.
properties.autoPauseDelay	integer	Tempo em minutos após o qual a base de dados é colocada em pausa automaticamente. Um valor de -1 significa que a pausa automática está desativada
properties.catalogCollation	CatalogCollationType	Agrupamento do catálogo de metadados.
properties.collation	string	O agrupamento da base de dados.
properties.createMode	CreateMode	Especifica o modo de criação da base de dados. Predefinição: criação regular de bases de dados. Copiar: cria uma base de dados como uma cópia de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados de origem. Secundário: cria uma base de dados como uma réplica secundária de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados primária existente. PointInTimeRestore: cria uma base de dados ao restaurar uma cópia de segurança para um ponto anterior no tempo de uma base de dados existente. sourceDatabaseId tem de ser especificado como o ID de recurso da base de dados existente e o restorePointInTime tem de ser especificado. Recuperação: cria uma base de dados ao restaurar uma cópia de segurança georreplicada. sourceDatabaseId tem de ser especificado como o ID de recurso de base de dados recuperável a restaurar. Restauro: cria uma base de dados ao restaurar uma cópia de segurança de uma base de dados eliminada. sourceDatabaseId tem de ser especificado. Se sourceDatabaseId for o ID de recurso original da base de dados, tem de especificar sourceDatabaseDeletionDate. Caso contrário, sourceDatabaseId tem de ser o ID do recurso de base de dados removido restabelecido e sourceDatabaseDeletionDate é ignorado. restorePointInTime também pode ser especificado para restaurar a partir de um ponto anterior no tempo. RestoreLongTermRetentionBackup: cria uma base de dados ao restaurar a partir de um cofre de retenção de longo prazo. recoveryServicesRecoveryPointResourceId tem de ser especificado como o ID de recurso do ponto de recuperação. Copy, Secondary e RestoreLongTermRetentionBackup não são suportados para a edição DataWarehouse.
properties.creationDate	string	A data de criação da base de dados (formato ISO8601).
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	O tipo de conta de armazenamento utilizado para armazenar cópias de segurança para esta base de dados.
properties.currentServiceObjectiveName	string	O nome do objetivo de nível de serviço atual da base de dados.
properties.currentSku	Sku	O nome e a camada do SKU.
properties.databaseId	string	O ID da base de dados.
properties.defaultSecondaryLocation	string	A região secundária predefinida para esta base de dados.
properties.earliestRestoreDate	string	Isto regista a data e hora de início mais antigas que o restauro está disponível para esta base de dados (ISO8601 formato).
properties.elasticPoolId	string	O identificador de recurso do conjunto elástico que contém esta base de dados.
properties.failoverGroupId	string	Identificador de recurso do Grupo de Ativação Pós-falha ao qual esta base de dados pertence.
properties.federatedClientId	string	O ID de cliente utilizado para o cenário de CMK entre inquilinos por base de dados
properties.highAvailabilityReplicaCount	integer	O número de réplicas secundárias associadas à base de dados que são utilizadas para fornecer elevada disponibilidade. Não aplicável a uma base de dados Hyperscale num conjunto elástico.
properties.isInfraEncryptionEnabled	boolean	A encriptação de infraestrutura está ativada para esta base de dados.
properties.isLedgerOn	boolean	Se esta base de dados é ou não uma base de dados de livros razão, o que significa que todas as tabelas na base de dados são tabelas de livros razão. Nota: o valor desta propriedade não pode ser alterado após a criação da base de dados.
properties.licenseType	DatabaseLicenseType	O tipo de licença a aplicar a esta base de dados. `LicenseIncluded`se precisar de uma licença ou `BasePrice` se tiver uma licença e for elegível para o Benefício Híbrido do Azure.
properties.longTermRetentionBackupResourceId	string	O identificador de recursos da cópia de segurança de retenção de longo prazo associada à operação de criação desta base de dados.
properties.maintenanceConfigurationId	string	ID de configuração de manutenção atribuído à base de dados. Esta configuração define o período em que as atualizações de manutenção irão ocorrer.
properties.maxLogSizeBytes	integer	O tamanho máximo do registo para esta base de dados.
properties.maxSizeBytes	integer	O tamanho máximo da base de dados expresso em bytes.
properties.minCapacity	number	Capacidade mínima que a base de dados terá sempre alocada, se não estiver em pausa
properties.pausedDate	string	A data em que a base de dados foi colocada em pausa pela configuração ou ação do utilizador (formato ISO8601). Nulo se a base de dados estiver pronta.
properties.readScale	DatabaseReadScale	O estado do encaminhamento só de leitura. Se estiver ativada, as ligações que tenham a intenção de aplicação definida como só de leitura nos respetivos cadeia de ligação podem ser encaminhadas para uma réplica só de leitura secundária na mesma região. Não aplicável a uma base de dados Hyperscale num conjunto elástico.
properties.recoverableDatabaseId	string	O identificador de recursos da base de dados recuperável associada à operação de criação desta base de dados.
properties.recoveryServicesRecoveryPointId	string	O identificador do recurso do ponto de recuperação associado à operação de criação desta base de dados.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	O tipo de conta de armazenamento a utilizar para armazenar cópias de segurança para esta base de dados.
properties.requestedServiceObjectiveName	string	O nome do objetivo de nível de serviço pedido da base de dados.
properties.restorableDroppedDatabaseId	string	O identificador de recursos da base de dados removida restabelecida associada à operação de criação desta base de dados.
properties.restorePointInTime	string	Especifica o ponto anterior no tempo (ISO8601 formato) da base de dados de origem que será restaurada para criar a nova base de dados.
properties.resumedDate	string	A data em que a base de dados foi retomada pela ação do utilizador ou pelo início de sessão da base de dados (ISO8601 formato). Nulo se a base de dados estiver em pausa.
properties.sampleName	SampleName	O nome do esquema de exemplo a aplicar ao criar esta base de dados.
properties.secondaryType	SecondaryType	O tipo secundário da base de dados, se for secundária. Os valores válidos são Geo e Named.
properties.sourceDatabaseDeletionDate	string	Especifica a hora em que a base de dados foi eliminada.
properties.sourceDatabaseId	string	O identificador de recursos da base de dados de origem associada à operação de criação desta base de dados.
properties.sourceResourceId	string	O identificador de recurso da origem associada à operação de criação desta base de dados. Esta propriedade só é suportada para a edição DataWarehouse e permite restaurar entre subscrições. Quando sourceResourceId é especificado, sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId e sourceDatabaseDeletionDate não devem ser especificados e CreateMode tem de ser PointInTimeRestore, Restore ou Recover. Quando createMode é PointInTimeRestore, sourceResourceId tem de ser o ID de recurso da base de dados existente ou do conjunto de sql existente e o restorePointInTime tem de ser especificado. Quando createMode é Restaurar, sourceResourceId tem de ser o ID de recurso da base de dados removida restabelecida ou do conjunto de sql removido restauráveis. Quando createMode é Recuperar, sourceResourceId tem de ser o ID de recurso da base de dados recuperável ou do conjunto de sql recuperável. Quando a subscrição de origem pertence a um inquilino diferente da subscrição de destino, o cabeçalho "x-ms-authorization-auxiliary" tem de conter o token de autenticação para o inquilino de origem. Para obter mais detalhes sobre o cabeçalho "x-ms-authorization-auxiliary", veja https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
properties.status	DatabaseStatus	O estado da base de dados.
properties.zoneRedundant	boolean	Se esta base de dados tem ou não redundância entre zonas, o que significa que as réplicas desta base de dados serão distribuídas por várias zonas de disponibilidade.
sku	Sku	O SKU da base de dados. A lista de SKUs pode variar consoante a região e a oferta de suporte. Para determinar os SKUs (incluindo o nome do SKU, escalão/edição, família e capacidade) que estão disponíveis para a sua subscrição numa região do Azure, utilize a `Capabilities_ListByLocation` API REST ou um dos seguintes comandos: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso.

DatabaseIdentity

Configuração de identidade do Azure Active Directory para um recurso.

Name	Tipo	Description
tenantId	string	O ID de inquilino do Azure Active Directory.
type	DatabaseIdentityType	O tipo de identidade
userAssignedIdentities	<string, DatabaseUserIdentity>	Os IDs de recursos das identidades atribuídas pelo utilizador a utilizar

DatabaseIdentityType

O tipo de identidade

Name	Tipo	Description
None	string
UserAssigned	string

DatabaseLicenseType

O tipo de licença a aplicar a esta base de dados. LicenseIncludedse precisar de uma licença ou BasePrice se tiver uma licença e for elegível para o Benefício Híbrido do Azure.

Name	Tipo	Description
BasePrice	string
LicenseIncluded	string

DatabaseReadScale

O estado do encaminhamento só de leitura. Se estiver ativada, as ligações que tenham a intenção da aplicação definidas de forma só de leitura no respetivo cadeia de ligação podem ser encaminhadas para uma réplica só de leitura secundária na mesma região. Não aplicável a uma base de dados Hyperscale num conjunto elástico.

Name	Tipo	Description
Disabled	string
Enabled	string

DatabaseStatus

O estado da base de dados.

Name	Tipo	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

Configuração de identidade do Azure Active Directory para um recurso.

Name	Tipo	Description
clientId	string	O ID de cliente do Azure Active Directory.
principalId	string	O ID principal do Azure Active Directory.

SampleName

O nome do esquema de exemplo a aplicar ao criar esta base de dados.

Name	Tipo	Description
AdventureWorksLT	string
WideWorldImportersFull	string
WideWorldImportersStd	string

SecondaryType

O tipo secundário da base de dados, se for secundário. Os valores válidos são Geo e Named.

Name	Tipo	Description
Geo	string
Named	string

Sku

Um SKU de Recurso do ARM.

Name	Tipo	Description
capacity	integer	Capacidade do SKU específico.
family	string	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.
name	string	O nome do SKU, normalmente, uma letra + Código de número, por exemplo, P3.
size	string	Tamanho do SKU específico
tier	string	O escalão ou edição do SKU específico, por exemplo, Básico, Premium.

Partilhar via

Databases - Get

Parâmetros do URI

Respostas

Exemplos

Gets a database.

Pedido de amostra

Resposta da amostra

Definições

BackupStorageRedundancy

CatalogCollationType

CreateMode

Database

DatabaseIdentity

DatabaseIdentityType

DatabaseLicenseType

DatabaseReadScale

DatabaseStatus

DatabaseUserIdentity

SampleName

SecondaryType

Sku

Recursos adicionais