Databases - Import

Importa un bacpac en una nueva base de datos.

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 de identificador URI

Name In Required Type Description
databaseName
path True
  • string

El nombre de la base de datos.

resourceGroupName
path True
  • string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.

serverName
path True
  • string

El nombre del servidor.

subscriptionId
path True
  • string

El id. de suscripción que identifica una suscripción de Azure.

api-version
query True
  • string

La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Name Required Type Description
administratorLogin True
  • string

Nombre de inicio de sesión del administrador.

administratorLoginPassword True
  • string

Contraseña de inicio de sesión del administrador.

storageKey True
  • string

Storage clave.

storageKeyType True

Storage tipo de clave.

storageUri True
  • string

Storage URI.

authenticationType
  • string

Tipo de autenticación.

networkIsolation

Información de recursos opcional para habilitar el aislamiento de red para la solicitud.

Respuestas

Name Type Description
200 OK

Importó correctamente la base de datos.

202 Accepted

La importación de la base de datos está en curso.

Other Status Codes

Respuestas de error: ***

  • 400 MissingImportExportInputParameters: faltan parámetros de entrada ImportExport.

  • 400 InvalidImportExportInputParameter: error en la solicitud import/export debido a un parámetro de entrada no válido.

  • 400 PolybaseImportAuthenticationTypeNotSupported: el parámetro de tipo de autenticación no es compatible con la operación PolybaseImport.

  • 400 DatabaseExtensionsInvalidOperationMode: parámetro operationMode no válido para la extensión de base de datos.

  • 400 DatabaseExtensionsInvalidStorageKeyType: el tipo de clave de almacenamiento debe ser "StorageAccessKey".

  • 400 DatabaseExtensionsMissingStorageUri: Storage URI no puede estar vacío.

  • 400 InvalidMaxSizeTierCombination: el nivel especificado no admite el tamaño máximo de la base de datos especificada.

  • 400 FeatureDisabledOnSelectedEdition: el usuario intentó usar una característica que está deshabilitada en la edición actual de la base de datos.

  • 400 InvalidOperationType: proporcione un tipo de operación válido.

  • 400 ImportExportJobError: error en la operación ImportExport.

  • 400 BlockedByOutboundFirewall: las reglas de firewall de salida bloquean la solicitud.

  • 404 ResourceNotFound: solicitud no válida que especifica un recurso inexistente.

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 404 ImportExportOperationIdNotFound: no se encuentra el identificador de operación para la importación o exportación.

  • 404 ServerNotInSubscription: el servidor especificado no existe en la suscripción especificada.

  • 409 ImportExportOperationInProgress: hay una operación de importación o exportación en curso en la base de datos.

Ejemplos

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

Definiciones

ImportExistingDatabaseDefinition

Contiene la información necesaria para realizar la operación de importación de la base de datos existente.

ImportExportOperationResult

Un recurso de resultado de la operación ImportExport.

NetworkIsolationSettings

Contiene los recursos de ARM para los que se va a crear una conexión de punto de conexión privado.

PrivateEndpointConnectionRequestStatus

Contiene el estado de las solicitudes de conexión de punto de conexión privado.

StorageKeyType

Storage tipo de clave.

ImportExistingDatabaseDefinition

Contiene la información necesaria para realizar la operación de importación de la base de datos existente.

Name Type Description
administratorLogin
  • string

Nombre de inicio de sesión del administrador.

administratorLoginPassword
  • string

Contraseña de inicio de sesión del administrador.

authenticationType
  • string

Tipo de autenticación.

networkIsolation

Información de recursos opcional para habilitar el aislamiento de red para la solicitud.

storageKey
  • string

Storage clave.

storageKeyType

Storage tipo de clave.

storageUri
  • string

Storage URI.

ImportExportOperationResult

Un recurso de resultado de la operación ImportExport.

Name Type Description
id
  • string

Identificador del recurso.

name
  • string

Nombre del recurso.

properties.blobUri
  • string

Uri de blob.

properties.databaseName
  • string

nombre de base de datos.

properties.errorMessage
  • string

Mensaje de error.

properties.lastModifiedTime
  • string

Hora de la última modificación.

properties.privateEndpointConnections

Obtiene el estado de los puntos de conexión privados asociados a esta solicitud.

properties.queuedTime
  • string

Tiempo en cola.

properties.requestId
  • string

Id. de solicitud.

properties.requestType
  • string

Tipo de solicitud.

properties.serverName
  • string

Nombre de servidor.

properties.status
  • string

Estado de la operación.

type
  • string

Tipo de recurso.

NetworkIsolationSettings

Contiene los recursos de ARM para los que se va a crear una conexión de punto de conexión privado.

Name Type Description
sqlServerResourceId
  • string

Identificador de recurso del servidor SQL que es el destino de esta solicitud. Si se establece, se creará una conexión de punto de conexión privado para el servidor SQL. Debe coincidir con el servidor que es el destino de la operación.

storageAccountResourceId
  • string

Identificador de recurso de la cuenta de almacenamiento usada para almacenar el archivo BACPAC. Si se establece, se creará una conexión de punto de conexión privado para la cuenta de almacenamiento. Debe coincidir con la cuenta de almacenamiento usada para el parámetro StorageUri.

PrivateEndpointConnectionRequestStatus

Contiene el estado de las solicitudes de conexión de punto de conexión privado.

Name Type Description
privateEndpointConnectionName
  • string

Nombre de conexión del punto de conexión privado.

privateLinkServiceId
  • string

Identificador de recurso para el que se crea el punto de conexión privado.

status
  • string

Estado de esta conexión de punto de conexión privado.

StorageKeyType

Storage tipo de clave.

Name Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string