Compartilhar via


Servers - Import Database

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.

Exemplos

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

Solicitação de exemplo

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

Resposta de exemplo

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

Imports to a new database.

Solicitação de exemplo

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

Resposta de exemplo

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

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