Compartir a través de


Servers - Import Database

Importa un bacpac en una nueva base de datos.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/import?api-version=2023-08-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
resourceGroupName
path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal.

serverName
path True

string

Nombre del servidor.

subscriptionId
path True

string

Identificador de suscripción que identifica una suscripción de Azure.

api-version
query True

string

Versión de la API que se va a usar para la solicitud.

Cuerpo de la solicitud

Nombre Requerido Tipo 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

Clave de almacenamiento.

storageKeyType True

StorageKeyType

Tipo de clave de almacenamiento.

storageUri True

string

Uri de almacenamiento.

authenticationType

string

Tipo de autenticación.

databaseName

string

Nombre de la base de datos de importación.

edition

string

Edición de la base de datos de importación.

maxSizeBytes

string

Tamaño máximo en bytes para la base de datos de importación.

networkIsolation

NetworkIsolationSettings

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

serviceObjectiveName

string

Nombre objetivo de nivel de servicio de la base de datos de importación.

Respuestas

Nombre Tipo Description
200 OK

ImportExportOperationResult

Importó correctamente la base de datos.

202 Accepted

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

Encabezados

Location: string

Other Status Codes

ErrorResponse

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: el URI de almacenamiento no puede estar vacío.

  • 400 SQLPasswordSpecifiedWithManagedIdentity: administratorLoginPassword no debe especificarse si authenticationType es ManagedIdentity.

  • 400 InvalidSqlAuthType: error en la operación ImportExport porque el tipo de autenticación sql no es válido

  • 400 BlobAlreadyExist: error en la operación ImportExport porque el blob de almacenamiento ya existe

  • 400 InvalidImportExportOperationResourceLocks: la solicitud Import/Export no es válida debido a bloqueos en los recursos de Private Link.

  • 400 DatabaseInvalidSkuPropertyCombination: las propiedades de la SKU solicitada son incoherentes. Compruebe que se especifica una combinación válida. Consulte https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability para obtener más detalles.

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

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

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

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

  • 400 InvalidTier: el usuario especificó un nivel no válido.

  • 400 CannotUseReservedDatabaseName: no se puede usar el nombre reservado de la base de datos en esta operación.

  • 400 InvalidImportExportParameter: error en la solicitud Import/Export debido a un parámetro de entrada no válido.

  • 400 InvalidSku: el usuario especificó una SKU no válida.

  • 400 InvalidTierSkuCombination: el nivel especificado no admite la SKU especificada.

  • 400 InvalidImportExportExportStorageCredentials: error en la operación import/Export debido a credenciales de almacenamiento no válidas

  • 400 InvalidImportExportStorageAuthType: error en la operación import/Export debido a un tipo de autenticación de almacenamiento no válido

  • 400 InvalidImportExportExportStorageKeyFormat: error en la operación import/Export debido a un formato de clave de almacenamiento no válido

  • 400 LongImportExportStorageUri: error en la operación de importación y exportación debido a un URI de almacenamiento largo

  • 400 LargeExportDatabaseSize: error en la operación de exportación porque la base de datos es mayor que el tamaño máximo admitido

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

  • 400 UnSupportedImportExportEdition: error en la operación ImportExport porque tiene como destino una edición no válida

  • 400 InvalidImportExportStorageURI: error en la operación ImportExport porque el URI de almacenamiento no es válido

  • 404 DatabaseDoesNotExist: el usuario ha especificado un nombre de base de datos que no existe en esta instancia del servidor.

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

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

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

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

  • 404 OperationIdNotFound: la operación con id. no existe.

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

  • 409 CannotCancelOperation: la operación de administración está en un estado que no se puede cancelar.

  • 409 OperationCancelled: el usuario canceló la operación.

  • 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió otra operación en el mismo recurso.

  • 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación.

  • 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

Ejemplos

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

Solicitud de ejemplo

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

Respuesta de muestra

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

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

ImportExportOperationResult

Un recurso de resultado de la operación ImportExport.

ImportNewDatabaseDefinition

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

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

Tipo de clave de almacenamiento.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

ImportExportOperationResult

Un recurso de resultado de la operación ImportExport.

Nombre Tipo Description
id

string

Identificador de recurso.

name

string

Nombre del recurso.

properties.blobUri

string

Uri de blob.

properties.databaseName

string

Nombre de la base de datos.

properties.errorMessage

string

Mensaje de error.

properties.lastModifiedTime

string

Hora de última modificación.

properties.privateEndpointConnections

PrivateEndpointConnectionRequestStatus[]

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

properties.queuedTime

string

Tiempo en cola.

properties.requestId

string (uuid)

Id. de solicitud.

properties.requestType

string

Tipo de solicitud.

properties.serverName

string

Nombre del servidor.

properties.status

string

Estado de la operación.

type

string

Tipo de recurso.

ImportNewDatabaseDefinition

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

Nombre Tipo 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.

databaseName

string

Nombre de la base de datos de importación.

edition

string

Edición de la base de datos de importación.

maxSizeBytes

string

Tamaño máximo en bytes para la base de datos de importación.

networkIsolation

NetworkIsolationSettings

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

serviceObjectiveName

string

Nombre objetivo de nivel de servicio de la base de datos de importación.

storageKey

string

Clave de almacenamiento.

storageKeyType

StorageKeyType

Tipo de clave de almacenamiento.

storageUri

string

Uri de almacenamiento.

NetworkIsolationSettings

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

Nombre Tipo Description
sqlServerResourceId

string (arm-id)

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

storageAccountResourceId

string (arm-id)

Identificador de recurso de la cuenta de almacenamiento que se usa 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.

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

Tipo de clave de almacenamiento.

Valor Description
SharedAccessKey
StorageAccessKey