Servers - Import Database

Referência

Service:: SQL Database

API Version:: 2021-11-01

Importa um bacpac para uma nova base de dados.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
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.

Corpo do Pedido

Name	Necessário	Tipo	Description
administratorLogin	True	string	Nome de início de sessão do administrador.
administratorLoginPassword	True	string	Palavra-passe de início de sessão de 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 da base de dados de importação.
edition		string	Edição da base de dados de importação.
maxSizeBytes		string	Tamanho máximo em bytes para a base de dados de importação.
networkIsolation		NetworkIsolationSettings	Informações de recursos opcionais para ativar o isolamento de rede para o pedido.
serviceObjectiveName		string	Nome do objetivo de nível de serviço da base de dados de importação.

Respostas

Name	Tipo	Description
200 OK	ImportExportOperationResult	A base de dados foi importada com êxito.
202 Accepted		A importação da base de dados está em curso.
Other Status Codes		Respostas de Erro: *** 400 MissingImportExportInputParameters – Parâmetros de entrada ImportExport em falta. 400 InvalidImportExportInputParameter – O pedido de importação/exportação falhou devido a um parâmetro de entrada inválido. 400 PolybaseImportAuthenticationTypeNotSupported - O parâmetro do tipo de autenticação não é suportado para a operação PolybaseImport. 400 DatabaseExtensionsInvalidOperationMode – parâmetro operationMode inválido para a extensão da base de dados. 400 DatabaseExtensionsInvalidStorageKeyType – o tipo de chave de armazenamento tem de ser "StorageAccessKey". 400 DatabaseExtensionsMissingStorageUri – o URI de Armazenamento não pode estar vazio. 400 InvalidSku - O utilizador especificou um SKU inválido. 400 InvalidTierSkuCombination – o escalão especificado não suporta o SKU especificado. 400 DatabaseInvalidSkuPropertyCombination – as propriedades do SKU pedido são inconsistentes. Verifique se foi especificada uma combinação válida. Veja https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability para obter mais detalhes. 400 InvalidMaxSizeTierCombination – o escalão especificado não suporta o tamanho máximo da base de dados especificada. 400 FeatureDisabledOnSelectedEdition – o utilizador tentou utilizar uma funcionalidade que está desativada na edição atual da base de dados. 400 InvalidImportExportParameter – O pedido de Importação/Exportação falhou devido a um parâmetro de entrada inválido. 400 InvalidTier – o utilizador especificou um escalão inválido. 400 InvalidOperationType - Forneça um tipo de operação válido. 400 ImportExportJobError – A operação ImportExport falhou. 400 BlockedByOutboundFirewall – as regras da firewall de saída bloquearam o pedido. 404 ResourceNotFound - Pedido inválido que especifica um recurso inexistente. 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados. 404 ImportExportOperationIdNotFound – não é possível localizar o ID da operação para importação ou exportação. 404 ServerNotInSubscription - O servidor especificado não existe na subscrição especificada. 404 OperationIdNotFound – a operação com o ID não existe. 409 ImportExportOperationInProgress – existe uma operação de importação ou exportação em curso na base de dados. 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

Name

Tipo

Description

200 OK

ImportExportOperationResult

A base de dados foi importada com êxito.

202 Accepted

A importação da base de dados está em curso.

Other Status Codes

Respostas de Erro: ***

400 MissingImportExportInputParameters – Parâmetros de entrada ImportExport em falta.
400 InvalidImportExportInputParameter – O pedido de importação/exportação falhou devido a um parâmetro de entrada inválido.
400 PolybaseImportAuthenticationTypeNotSupported - O parâmetro do tipo de autenticação não é suportado para a operação PolybaseImport.
400 DatabaseExtensionsInvalidOperationMode – parâmetro operationMode inválido para a extensão da base de dados.
400 DatabaseExtensionsInvalidStorageKeyType – o tipo de chave de armazenamento tem de ser "StorageAccessKey".
400 DatabaseExtensionsMissingStorageUri – o URI de Armazenamento não pode estar vazio.
400 InvalidSku - O utilizador especificou um SKU inválido.
400 InvalidTierSkuCombination – o escalão especificado não suporta o SKU especificado.
400 DatabaseInvalidSkuPropertyCombination – as propriedades do SKU pedido são inconsistentes. Verifique se foi especificada uma combinação válida. Veja https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability para obter mais detalhes.
400 InvalidMaxSizeTierCombination – o escalão especificado não suporta o tamanho máximo da base de dados especificada.
400 FeatureDisabledOnSelectedEdition – o utilizador tentou utilizar uma funcionalidade que está desativada na edição atual da base de dados.
400 InvalidImportExportParameter – O pedido de Importação/Exportação falhou devido a um parâmetro de entrada inválido.
400 InvalidTier – o utilizador especificou um escalão inválido.
400 InvalidOperationType - Forneça um tipo de operação válido.
400 ImportExportJobError – A operação ImportExport falhou.
400 BlockedByOutboundFirewall – as regras da firewall de saída bloquearam o pedido.
404 ResourceNotFound - Pedido inválido que especifica um recurso inexistente.
404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados.
404 ImportExportOperationIdNotFound – não é possível localizar o ID da operação para importação ou exportação.
404 ServerNotInSubscription - O servidor especificado não existe na subscrição especificada.
404 OperationIdNotFound – a operação com o ID não existe.
409 ImportExportOperationInProgress – existe uma operação de importação ou exportação em curso na base de dados.
409 OperationCancelled - A operação foi cancelada pelo utilizador.
409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso.
429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.
429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.
500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação.
503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados 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

Name	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 da nova base de dados.
NetworkIsolationSettings	Contém os recursos arm para os quais criar uma ligação de ponto final privado.
PrivateEndpointConnectionRequestStatus	Contém o estado dos pedidos de ligação de ponto final privado.
StorageKeyType	Tipo de chave de armazenamento.

ImportExportOperationResult

Um recurso de resultado da operação ImportExport.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.blobUri	string	Uri de Blob.
properties.databaseName	string	Nome da base de dados.
properties.errorMessage	string	Mensagem de erro.
properties.lastModifiedTime	string	Hora da última modificação.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Obtém o estado dos pontos finais privados associados a este pedido.
properties.queuedTime	string	Tempo em fila.
properties.requestId	string	ID do pedido.
properties.requestType	string	Tipo de pedido.
properties.serverName	string	Nome do servidor.
properties.status	string	Estado da operação.
type	string	Tipo de recurso.

ImportNewDatabaseDefinition

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

Name	Tipo	Description
administratorLogin	string	Nome de início de sessão do administrador.
administratorLoginPassword	string	Palavra-passe de início de sessão de administrador.
authenticationType	string	Tipo de autenticação.
databaseName	string	Nome da base de dados de importação.
edition	string	Edição da base de dados de importação.
maxSizeBytes	string	Tamanho máximo em bytes para a base de dados de importação.
networkIsolation	NetworkIsolationSettings	Informações de recursos opcionais para ativar o isolamento de rede para o pedido.
serviceObjectiveName	string	Nome do objetivo de nível de serviço da base 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 arm para os quais criar uma ligação de ponto final privado.

Name	Tipo	Description
sqlServerResourceId	string	O ID de recurso do SQL Server, que é o destino deste pedido. Se estiver definida, será criada uma ligação de ponto final privado para o SQL Server. Tem de corresponder ao servidor que é o destino da operação.
storageAccountResourceId	string	O ID de recurso da conta de armazenamento utilizada para armazenar o ficheiro BACPAC. Se estiver definida, será criada uma ligação de ponto final privado para a conta de armazenamento. Tem de corresponder à conta de armazenamento utilizada para o parâmetro StorageUri.

PrivateEndpointConnectionRequestStatus

Contém o estado dos pedidos de ligação de ponto final privado.

Name	Tipo	Description
privateEndpointConnectionName	string	O nome da ligação para o ponto final privado.
privateLinkServiceId	string	ID do recurso para o qual o ponto final privado é criado.
status	string	Estado desta ligação de ponto final privado.

StorageKeyType

Tipo de chave de armazenamento.

Name	Tipo	Description
SharedAccessKey	string
StorageAccessKey	string

Servers - Import Database

Parâmetros do URI

Corpo do Pedido

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