Partilhar 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=2023-08-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. Você pode obter esse valor da API do Azure Resource Manager ou 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 do Pedido

Name Necessário Tipo Description
administratorLogin True

string

Nome de login do administrador.

administratorLoginPassword True

string

Senha de login 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 da base 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 recursos 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 Tipo Description
200 OK

ImportExportOperationResult

Importou com êxito o banco de dados.

202 Accepted

A importação do banco de dados está em andamento.

Cabeçalhos

Location: string

Other Status Codes

ErrorResponse

Respostas de erro: ***

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

  • 400 InvalidImportExportInputParameter - A solicitação de importação/exportação falhou devido a um parâmetro de entrada inválido.

  • 400 PolybaseImportAuthenticationTypeNotSupported - O parâmetro de tipo de autenticação não é suportado para 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 - O URI de armazenamento não pode estar vazio.

  • 400 SQLPasswordSpecifiedWithManagedIdentity - administratorLoginPassword não deve ser especificado se authenticationType for ManagedIdentity.

  • 400 InvalidSqlAuthType - A operação ImportExport falhou porque o tipo de autenticação sql é inválido

  • 400 BlobAlreadyExist - A operação ImportExport falhou porque o blob de armazenamento já existe

  • 400 InvalidImportExportOperationResourceLocks - A solicitação de Importação/Exportação é inválida devido a bloqueios nos recursos de Link Privado.

  • 400 DatabaseInvalidSkuPropertyCombination - As propriedades do sku solicitado são inconsistentes. Verifique se uma combinação válida está especificada. Consulte https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability para obter mais detalhes.

  • 400 ImportExportJobError - A operação ImportExport falhou.

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

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

  • 400 InvalidMaxSizeTierCombination - A camada especificada não suporta o tamanho máximo do banco de dados especificado.

  • 400 InvalidTier - O usuário especificou uma camada inválida.

  • 400 CannotUseReservedDatabaseName - Não é possível usar o nome do banco de dados reservado nesta operação.

  • 400 InvalidImportExportParameter - A solicitação de importação/exportação falhou devido a um parâmetro de entrada inválido.

  • 400 InvalidSku - O usuário especificou um sku inválido.

  • 400 InvalidTierSkuCombination - A camada especificada não suporta a sku especificada.

  • 400 InvalidImportExportStorageCredentials - Falha na operação de importação/exportação devido a credenciais de armazenamento inválidas

  • 400 InvalidImportExportStorageAuthType - Falha na operação de importação/exportação devido a um tipo de autenticação de armazenamento inválido

  • 400 InvalidImportExportStorageKeyFormat - Falha na operação de importação/exportação devido a um formato de chave de armazenamento inválido

  • 400 LongImportExportStorageUri - Falha na operação de importação/exportação devido a URI de armazenamento longo

  • 400 LargeExportDatabaseSize - Falha na operação de exportação porque o banco de dados é maior do que o tamanho máximo suportado

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

  • 400 UnSupportedImportExportEdition - Falha na operação ImportExport porque está direcionada a uma edição inválida

  • 400 InvalidImportExportStorageURI - A operação ImportExport falhou porque o URI de armazenamento é inválido

  • 404 DatabaseDoesNotExist - O usuário especificou um nome de banco de dados que não existe nesta instância do servidor.

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

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

  • 404 ResourceNotFound - Solicitação inválida especificando um recurso inexistente.

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

  • 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 CannotCancelOperation - A operação de gerenciamento está em um estado que não pode ser cancelado.

  • 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 pelos recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Por favor, tente novamente a operação.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

Exemplos

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

Pedido de amostra

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2023-08-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 da amostra

{
  "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"
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Imports to a new database.

Pedido de amostra

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

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

Resposta da amostra

{
  "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"
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Definições

Name Description
ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

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 ARM para os quais criar conexão de ponto de extremidade privado.

PrivateEndpointConnectionRequestStatus

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

StorageKeyType

Tipo de chave de armazenamento.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

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

Blob Uri.

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 em fila.

properties.requestId

string (uuid)

Id da solicitação.

properties.requestType

string

Tipo de solicitação.

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 para o novo banco de dados.

Name Tipo Description
administratorLogin

string

Nome de login do administrador.

administratorLoginPassword

string

Senha de login do administrador.

authenticationType

string

Tipo de autenticação.

databaseName

string

Nome do banco de dados de importação.

edition

string

Edição da base 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 recursos 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 ARM para os quais criar conexão de ponto de extremidade privado.

Name Tipo Description
sqlServerResourceId

string (arm-id)

A id do recurso para o servidor SQL que é o destino dessa solicitação. Se definida, 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 (arm-id)

A ID do recurso para a conta de armazenamento usada para armazenar o arquivo BACPAC. Se definida, a conexão de ponto de extremidade privada será criada para a conta de armazenamento. Deve corresponder à conta de armazenamento usada para o parâmetro StorageUri.

PrivateEndpointConnectionRequestStatus

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

Name 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 privada.

StorageKeyType

Tipo de chave de armazenamento.

Valor Description
SharedAccessKey
StorageAccessKey