Servers - Import Database

Referência

Service:: SQL Database

API Version:: 2021-11-01

Importa um bacpac para um novo banco de dados.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
administratorLogin	True	string	Nome de logon do administrador.
administratorLoginPassword	True	string	Senha de logon do administrador.
storageKey	True	string	Chave de armazenamento.
storageKeyType	True	StorageKeyType	Tipo de chave de armazenamento.
storageUri	True	string	URI de armazenamento.
authenticationType		string	Tipo de autenticação.
databaseName		string	Nome do banco de dados de importação.
edition		string	Edição do banco de dados de importação.
maxSizeBytes		string	Tamanho máximo em bytes para o banco de dados de importação.
networkIsolation		NetworkIsolationSettings	Informações de recurso opcionais para habilitar o isolamento de rede para solicitação.
serviceObjectiveName		string	Nome do objetivo de nível de serviço do banco de dados de importação.

Respostas

Nome	Tipo	Description
200 OK	ImportExportOperationResult	O banco de dados foi importado com êxito.
202 Accepted		A importação do banco de dados está em andamento.
Other Status Codes		Respostas de erro: *** 400 MissingImportExportInputParameters – Parâmetros de entrada ImportExport ausentes. 400 InvalidImportExportInputParameter - Falha na solicitação de importação/exportação devido a um parâmetro de entrada inválido. 400 PolybaseImportAuthenticationTypeNotSupported - O parâmetro de tipo de autenticação não é compatível com a operação PolybaseImport. 400 DatabaseExtensionsInvalidOperationMode - Parâmetro operationMode inválido para a extensão de banco de dados. 400 DatabaseExtensionsInvalidStorageKeyType - O tipo de chave de armazenamento deve ser 'StorageAccessKey'. 400 DatabaseExtensionsMissingStorageUri – O URI de armazenamento não pode estar vazio. 400 InvalidSku - O usuário especificou um sku inválido. 400 InvalidTierSkuCombination - A camada especificada não dá suporte ao sku especificado. 400 DatabaseInvalidSkuPropertyCombination – as propriedades do sku solicitado são inconsistentes. Marcar que uma combinação válida seja especificada. Consulte https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability para obter mais detalhes. 400 InvalidMaxSizeTierCombination – a camada especificada não dá suporte ao tamanho máximo do banco de dados especificado. 400 FeatureDisabledOnSelectedEdition - O usuário tentou usar um recurso que está desabilitado na edição atual do banco de dados. 400 InvalidImportExportParameter - Falha na solicitação de Importação/Exportação devido a um parâmetro de entrada inválido. 400 InvalidTier - O usuário especificou uma camada inválida. 400 InvalidOperationType - Forneça um tipo de operação válido. 400 ImportExportJobError - A operação ImportExport falhou. 400 BlockedByOutboundFirewall - As regras de firewall de saída bloquearam a solicitação. 404 ResourceNotFound - Solicitação inválida que especifica um recurso inexistente. 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 ImportExportOperationIdNotFound - A ID da operação para importação ou exportação não pode ser encontrada. 404 ServerNotInSubscription – O servidor especificado não existe na assinatura especificada. 404 OperationIdNotFound - A operação com Id não existe. 409 ImportExportOperationInProgress - Há uma operação de importação ou exportação em andamento no banco de dados. 409 OperationCancelled - A operação foi cancelada pelo usuário. 409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

Nome

Tipo

Description

200 OK

ImportExportOperationResult

O banco de dados foi importado com êxito.

202 Accepted

A importação do banco de dados está em andamento.

Other Status Codes

Respostas de erro: ***

400 MissingImportExportInputParameters – Parâmetros de entrada ImportExport ausentes.
400 InvalidImportExportInputParameter - Falha na solicitação de importação/exportação devido a um parâmetro de entrada inválido.
400 PolybaseImportAuthenticationTypeNotSupported - O parâmetro de tipo de autenticação não é compatível com a operação PolybaseImport.
400 DatabaseExtensionsInvalidOperationMode - Parâmetro operationMode inválido para a extensão de banco de dados.
400 DatabaseExtensionsInvalidStorageKeyType - O tipo de chave de armazenamento deve ser 'StorageAccessKey'.
400 DatabaseExtensionsMissingStorageUri – O URI de armazenamento não pode estar vazio.
400 InvalidSku - O usuário especificou um sku inválido.
400 InvalidTierSkuCombination - A camada especificada não dá suporte ao sku especificado.
400 DatabaseInvalidSkuPropertyCombination – as propriedades do sku solicitado são inconsistentes. Marcar que uma combinação válida seja especificada. Consulte https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability para obter mais detalhes.
400 InvalidMaxSizeTierCombination – a camada especificada não dá suporte ao tamanho máximo do banco de dados especificado.
400 FeatureDisabledOnSelectedEdition - O usuário tentou usar um recurso que está desabilitado na edição atual do banco de dados.
400 InvalidImportExportParameter - Falha na solicitação de Importação/Exportação devido a um parâmetro de entrada inválido.
400 InvalidTier - O usuário especificou uma camada inválida.
400 InvalidOperationType - Forneça um tipo de operação válido.
400 ImportExportJobError - A operação ImportExport falhou.
400 BlockedByOutboundFirewall - As regras de firewall de saída bloquearam a solicitação.
404 ResourceNotFound - Solicitação inválida que especifica um recurso inexistente.
404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados.
404 ImportExportOperationIdNotFound - A ID da operação para importação ou exportação não pode ser encontrada.
404 ServerNotInSubscription – O servidor especificado não existe na assinatura especificada.
404 OperationIdNotFound - A operação com Id não existe.
409 ImportExportOperationInProgress - Há uma operação de importação ou exportação em andamento no banco de dados.
409 OperationCancelled - A operação foi cancelada pelo usuário.
409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso.
429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.
429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.
500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente.
503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

Exemplos

Imports to a new database, using private link for the SQL server and storage account.

Imports to a new database.

Imports to a new database, using private link for the SQL server and storage account.

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2021-11-01

{
  "databaseName": "testdb",
  "storageKeyType": "StorageAccessKey",
  "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac",
  "administratorLogin": "login",
  "administratorLoginPassword": "password",
  "authenticationType": "Sql",
  "networkIsolation": {
    "sqlServerResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr",
    "storageAccountResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Storage/storageAccounts/test-privatelink"
  }
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.ImportNewDatabaseDefinition;
import com.azure.resourcemanager.sql.models.NetworkIsolationSettings;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/** Samples for Servers ImportDatabase. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportNewDatabaseWithNetworkIsolation
     * .json
     */
    /**
     * Sample code: Imports to a new database, using private link for the SQL server and storage account.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToANewDatabaseUsingPrivateLinkForTheSQLServerAndStorageAccount(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().importDatabase("Default-SQL-SouthEastAsia", "testsvr",
            new ImportNewDatabaseDefinition().withDatabaseName("testdb")
                .withStorageKeyType(StorageKeyType.STORAGE_ACCESS_KEY).withStorageKey("fakeTokenPlaceholder")
                .withStorageUri("https://test.blob.core.windows.net/test.bacpac").withAdministratorLogin("login")
                .withAdministratorLoginPassword("fakeTokenPlaceholder").withAuthenticationType("Sql")
                .withNetworkIsolation(new NetworkIsolationSettings().withStorageAccountResourceId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Storage/storageAccounts/test-privatelink")
                    .withSqlServerResourceId(
                        "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr")),
            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

{
  "properties": {
    "requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
    "requestType": "Import",
    "queuedTime": "2/2/2020 8:33:27 PM",
    "lastModifiedTime": "2/2/2020 8:34:47 PM",
    "blobUri": "https://test.blob.core.windows.net/test.bacpac",
    "serverName": "testsvr.database.windows.net",
    "databaseName": "testdb",
    "status": "Completed"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
  "name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
  "type": "Microsoft.Sql/servers/databases/importExportOperationResults"
}

Status code:: 202

Imports to a new database.

Sample Request

HTTP
Java

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2021-11-01

{
  "databaseName": "testdb",
  "storageKeyType": "StorageAccessKey",
  "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac",
  "administratorLogin": "login",
  "administratorLoginPassword": "password",
  "authenticationType": "Sql"
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.ImportNewDatabaseDefinition;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/** Samples for Servers ImportDatabase. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportNewDatabase.json
     */
    /**
     * Sample code: Imports to a new database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToANewDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().importDatabase("Default-SQL-SouthEastAsia", "testsvr",
            new ImportNewDatabaseDefinition().withDatabaseName("testdb")
                .withStorageKeyType(StorageKeyType.STORAGE_ACCESS_KEY).withStorageKey("fakeTokenPlaceholder")
                .withStorageUri("https://test.blob.core.windows.net/test.bacpac").withAdministratorLogin("login")
                .withAdministratorLoginPassword("fakeTokenPlaceholder").withAuthenticationType("Sql"),
            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

{
  "properties": {
    "requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
    "requestType": "Import",
    "queuedTime": "2/2/2020 8:33:27 PM",
    "lastModifiedTime": "2/2/2020 8:34:47 PM",
    "blobUri": "https://test.blob.core.windows.net/test.bacpac",
    "serverName": "testsvr.database.windows.net",
    "databaseName": "testdb",
    "status": "Completed"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
  "name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
  "type": "Microsoft.Sql/servers/databases/importExportOperationResults"
}

Status code:: 202

Definições

Nome	Description
ImportExportOperationResult	Um recurso de resultado da operação ImportExport.
ImportNewDatabaseDefinition	Contém as informações necessárias para executar a operação de importação para o novo banco de dados.
NetworkIsolationSettings	Contém os recursos do ARM para os quais criar uma conexão de ponto de extremidade privado.
PrivateEndpointConnectionRequestStatus	Contém as solicitações de conexão de ponto de extremidade privado status.
StorageKeyType	Tipo de chave de armazenamento.

ImportExportOperationResult

Um recurso de resultado da operação ImportExport.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.blobUri	string	URI do blob.
properties.databaseName	string	nome do banco de dados.
properties.errorMessage	string	Mensagem de erro.
properties.lastModifiedTime	string	Hora da última modificação.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Obtém o status de pontos de extremidade privados associados a essa solicitação.
properties.queuedTime	string	Tempo na fila.
properties.requestId	string	ID da solicitação.
properties.requestType	string	Tipo de solicitação.
properties.serverName	string	Nome de servidor.
properties.status	string	Status da operação.
type	string	Tipo de recurso.

ImportNewDatabaseDefinition

Contém as informações necessárias para executar a operação de importação para o novo banco de dados.

Nome	Tipo	Description
administratorLogin	string	Nome de logon do administrador.
administratorLoginPassword	string	Senha de logon do administrador.
authenticationType	string	Tipo de autenticação.
databaseName	string	Nome do banco de dados de importação.
edition	string	Edição do banco de dados de importação.
maxSizeBytes	string	Tamanho máximo em bytes para o banco de dados de importação.
networkIsolation	NetworkIsolationSettings	Informações de recurso opcionais para habilitar o isolamento de rede para solicitação.
serviceObjectiveName	string	Nome do objetivo de nível de serviço do banco de dados de importação.
storageKey	string	Chave de armazenamento.
storageKeyType	StorageKeyType	Tipo de chave de armazenamento.
storageUri	string	URI de armazenamento.

NetworkIsolationSettings

Contém os recursos do ARM para os quais criar uma conexão de ponto de extremidade privado.

Nome	Tipo	Description
sqlServerResourceId	string	A ID do recurso para o SQL Server que é o destino dessa solicitação. Se definido, a conexão de ponto de extremidade privado será criada para o SQL Server. Deve corresponder ao servidor que é o destino da operação.
storageAccountResourceId	string	A ID do recurso da conta de armazenamento usada para armazenar o arquivo BACPAC. Se definido, a conexão de ponto de extremidade privado será criada para a conta de armazenamento. Deve corresponder à conta de armazenamento usada para o parâmetro StorageUri.

PrivateEndpointConnectionRequestStatus

Contém as solicitações de conexão de ponto de extremidade privado status.

Nome	Tipo	Description
privateEndpointConnectionName	string	O nome da conexão para o ponto de extremidade privado.
privateLinkServiceId	string	ID do recurso para o qual o ponto de extremidade privado é criado.
status	string	Status dessa conexão de ponto de extremidade privado.

StorageKeyType

Tipo de chave de armazenamento.

Nome	Tipo	Description
SharedAccessKey	string
StorageAccessKey	string

Servers - Import Database

Parâmetros de URI

Corpo da solicitação

Respostas

Exemplos

Imports to a new database, using private link for the SQL server and storage account.

Sample Request

Sample Response

Imports to a new database.

Sample Request

Sample Response

Definições

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Recursos adicionais