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=2022-02-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 do logon do administrador.

administratorLoginPassword True
  • string

Senha de logon do administrador.

storageKey True
  • string

Chave de armazenamento.

storageKeyType True

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

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 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 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. 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 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 – Falha na operação ImportExport.

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

  • 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=2022-02-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=2022-02-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

Tipo de chave de armazenamento.

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

Obtém o status de 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 do 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

Chave de armazenamento.

storageKeyType

Tipo de chave de armazenamento.

storageUri
  • string

Uri de armazenamento.

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 do 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 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 de recurso para a qual o ponto de extremidade privado é criado.

status
  • string

Status dessa conexão de ponto de extremidade privado.

StorageKeyType

Tipo de chave de armazenamento.

Name Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string