Servers - Import Database

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-08-01-preview

Parâmetros do URI

Name In Required Type Description
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.

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

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

serviceObjectiveName
  • string

Nome objetivo de nível de serviço da base de dados de importação.

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 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 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 a new database, using private link for the SQL server and storage account.
Imports to a new database.

Sample Request

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

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

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 a new database.

Sample Request

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

{
  "databaseName": "testdb",
  "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

ImportExportOperationResult

Um recurso de resultado de operação ImportExport.

ImportNewDatabaseDefinition

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

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.

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.

ImportNewDatabaseDefinition

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

Name Type Description
administratorLogin
  • string

Nome de login do administrador.

administratorLoginPassword
  • string

Senha de login do 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

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

serviceObjectiveName
  • string

Nome objetivo de nível de serviço da base de dados de importação.

storageKey
  • string

Armazenamento chave.

storageKeyType

Armazenamento tipo de chave.

storageUri
  • string

Armazenamento Uri.

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