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=2020-11-01-preview

Parâmetros de URI

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

Name Required Type Description
administratorLogin True
  • string

Nome de logon do administrador.

administratorLoginPassword True
  • string

Senha de logon 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 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

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

Name Type Description
200 OK

Importou com êxito o banco de dados.

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 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 extensão de banco de dados.

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

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

  • 400 FeatureDisabledOnSelectedEdition – O usuário tentou usar um recurso que está desabilitado na edição atual do banco de dados.

  • 400 InvalidOperationType – Forneça um tipo de operação válido.

  • 400 ImportExportJobError – Falha na operação ImportExport.

  • 400 BlockedByOutboundFirewall – As regras de firewall de saída bloquearam a solicitação.

  • 404 ResourceNotFound - Solicitação inválida especificando 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.

  • 409 ImportExportOperationInProgress – Há uma operação de importação ou exportação em andamento no banco 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=2020-11-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=2020-11-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 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 conexão de ponto de extremidade privado.

PrivateEndpointConnectionRequestStatus

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

StorageKeyType

Armazenamento tipo de chave.

ImportExportOperationResult

Um recurso de resultado da operação ImportExport.

Name Type Description
id
  • string

ID do recurso.

name
  • string

Nome do recurso.

properties.blobUri
  • string

Uri de 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

Obtém o status dos pontos de extremidade privados associados a essa solicitação.

properties.queuedTime
  • string

Tempo enfileirado.

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.

Name Type 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

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

Armazenamento chave.

storageKeyType

Armazenamento tipo de chave.

storageUri
  • string

Armazenamento Uri.

NetworkIsolationSettings

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

Name Type Description
sqlServerResourceId
  • string

A ID do recurso para o servidor SQL que é o destino dessa solicitação. Se definido, a conexão de ponto de extremidade privado será criada para o servidor SQL. 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 o status de solicitações de conexão de ponto de extremidade privado.

Name Type 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

Armazenamento tipo de chave.

Name Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string