Databases - Import

Importa um bacpac para uma nova base de dados.

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

Parâmetros do URI

Name In Required Type 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 do Azure Resource Manager API ou do portal.

serverName
path True
  • string

O nome do servidor.

subscriptionId
path True
  • string

O ID de subscrição que identifica uma subscrição do Azure.

api-version
query True
  • string

A versão API a utilizar para o pedido.

Corpo do Pedido

Name Required Type Description
administratorLogin True
  • string

Nome de login do administrador.

administratorLoginPassword True
  • string

Senha de login do administrador.

storageKey True
  • string

Armazenamento chave.

storageKeyType True

Armazenamento tipo de chave.

storageUri True
  • string

Armazenamento Uri.

authenticationType
  • string

Tipo de autenticação.

networkIsolation

Informação de recursos opcionais para permitir o isolamento da rede para pedido.

Respostas

Name Type Description
200 OK

Importou com sucesso a base de dados.

202 Accepted

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

Other Status Codes

Respostas de erro: ***

  • 400 MissingImportExportInputParameters - Parâmetros de entrada Desaparecidos ImportExport.

  • 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 é suporte para o funcionamento do PolybaseImport.

  • 400 Base de BaseExtensionsInvalidOperationMode - Parâmetro de funcionamento inválidoMode para extensão de base de dados.

  • 400 DatabaseExtensionsInvalidStorageKeyType - O tipo de chave de armazenamento deve ser por 'StorageAccessKey'.

  • 400 DatabaseExtensionsMissingStorageUri - Armazenamento URI não pode estar vazio.

  • 400 InvalidMaxSizeTierCombination - O nível especificado não suporta o tamanho máximo da base de dados especificado.

  • 400 FeatureDisabledOnSelectedEdition - O utilizador tentou utilizar uma funcionalidade que está desativada na edição atual da base de dados.

  • 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 o pedido.

  • 404 ResourceNotFound - Pedido inválido especificando um recurso inexistente.

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos especificado e na subscrição.

  • 404 ImportExportOperationIdNotFound - A operação Id para importação ou exportação não pode ser encontrada.

  • 404 ServerNotInSubscription - O servidor especificado não existe na subscrição especificada.

  • 409 ImportExportOperationInProgress - Está em curso uma operação de importação ou exportação na base de dados.

Exemplos

Imports to an existing empty database, using private link to communicate with SQL server and storage account.
Imports to an existing empty database.

Sample Request

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

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

Sample Response

{
  "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 an existing empty database.

Sample Request

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

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

Sample Response

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

ImportExistingDatabaseDefinition

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

ImportExportOperationResult

Um recurso de resultado de operação ImportExport.

NetworkIsolationSettings

Contém os recursos ARM para a criação de ligação privada ao ponto final.

PrivateEndpointConnectionRequestStatus

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

StorageKeyType

Armazenamento tipo de chave.

ImportExistingDatabaseDefinition

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

Name Type Description
administratorLogin
  • string

Nome de login do administrador.

administratorLoginPassword
  • string

Senha de login do administrador.

authenticationType
  • string

Tipo de autenticação.

networkIsolation

Informação de recursos opcionais para permitir o isolamento da rede para pedido.

storageKey
  • string

Armazenamento chave.

storageKeyType

Armazenamento tipo de chave.

storageUri
  • string

Armazenamento Uri.

ImportExportOperationResult

Um recurso de resultado de operação ImportExport.

Name Type Description
id
  • string

Identificação de recursos.

name
  • string

Nome de recurso.

properties.blobUri
  • string

Blob Uri.

properties.databaseName
  • string

Nome da base de dados.

properties.errorMessage
  • string

Mensagem de erro.

properties.lastModifiedTime
  • string

Última hora modificada.

properties.privateEndpointConnections

Obtém o estatuto dos pontos finais privados associados a este pedido.

properties.queuedTime
  • string

Hora da fila.

properties.requestId
  • string

Pedir identificação.

properties.requestType
  • string

Tipo de pedido.

properties.serverName
  • string

Nome do servidor.

properties.status
  • string

Estado da operação.

type
  • string

Tipo de recurso.

NetworkIsolationSettings

Contém os recursos ARM para a criação de ligação privada ao ponto final.

Name Type Description
sqlServerResourceId
  • string

O id de recursos para o servidor SQL que é o alvo deste pedido. Se for definida, será criada uma ligação de ponto final privado para o servidor SQL. Deve coincidir com o servidor que é o alvo da operação.

storageAccountResourceId
  • string

O id de recursos para a conta de armazenamento usado para armazenar ficheiro BACPAC. Se for definida, será criada uma ligação privada ao ponto final para a conta de armazenamento. Deve coincidir com a conta de armazenamento utilizada para o parâmetro StorageUri.

PrivateEndpointConnectionRequestStatus

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

Name Type Description
privateEndpointConnectionName
  • string

O nome de ligação para o ponto final privado.

privateLinkServiceId
  • string

Id de recursos para os quais o ponto final privado é criado.

status
  • string

Estado desta ligação privada de ponto final.

StorageKeyType

Armazenamento tipo de chave.

Name Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string