Databases - Import

Referencia

Servicio:: SQL Database

Versión de la API:: 2021-11-01

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

Parámetros de identificador URI

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

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.
networkIsolation		NetworkIsolationSettings	Información de recursos opcional para habilitar el aislamiento de red para la solicitud.

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.
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: el URI de almacenamiento no puede estar vacío. 400 InvalidSku: el usuario especificó una SKU no válida. 400 InvalidTierSkuCombination: el nivel especificado no admite la SKU especificada. 400 DatabaseInvalidSkuPropertyCombination: las propiedades de la SKU solicitada son incoherentes. Compruebe que se especifica una combinación válida. Para obtener más información, consulte https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability. 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 InvalidImportExportParameter: error en la solicitud Import/Export debido a un parámetro de entrada no válido. 400 InvalidTier: el usuario especificó un nivel no válido. 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. 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 OperationCancelled: el usuario ha cancelado la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso. 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 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 y, 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

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.

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: el URI de almacenamiento no puede estar vacío.
400 InvalidSku: el usuario especificó una SKU no válida.
400 InvalidTierSkuCombination: el nivel especificado no admite la SKU especificada.
400 DatabaseInvalidSkuPropertyCombination: las propiedades de la SKU solicitada son incoherentes. Compruebe que se especifica una combinación válida. Para obtener más información, consulte https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.
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 InvalidImportExportParameter: error en la solicitud Import/Export debido a un parámetro de entrada no válido.
400 InvalidTier: el usuario especificó un nivel no válido.
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.
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 OperationCancelled: el usuario ha cancelado la operación.
409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso.
429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.
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 y,
503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

Ejemplos

Imports to an existing empty database, using private link to communicate with SQL server and storage account.

Imports to an existing empty database.

Imports to an existing empty database, using private link to communicate with SQL server and storage account.

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

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


import com.azure.resourcemanager.sql.models.ImportExistingDatabaseDefinition;
import com.azure.resourcemanager.sql.models.NetworkIsolationSettings;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/**
 * Samples for Databases ImportMethod.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportDatabaseWithNetworkIsolation.
     * json
     */
    /**
     * Sample code: Imports to an existing empty database, using private link to communicate with SQL server and storage
     * account.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToAnExistingEmptyDatabaseUsingPrivateLinkToCommunicateWithSQLServerAndStorageAccount(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases()
            .importMethod("Default-SQL-SouthEastAsia", "testsvr", "testdb", new ImportExistingDatabaseDefinition()
                .withStorageKeyType(StorageKeyType.STORAGE_ACCESS_KEY).withStorageKey("fakeTokenPlaceholder")
                .withStorageUri("https://test.blob.core.windows.net/test.bacpac").withAdministratorLogin("login")
                .withAdministratorLoginPassword("fakeTokenPlaceholder").withAuthenticationType("Sql")
                .withNetworkIsolation(new NetworkIsolationSettings().withStorageAccountResourceId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Storage/storageAccounts/test-privatelink")
                    .withSqlServerResourceId(
                        "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr")),
                com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:: 200

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

status code:: 202

Imports to an existing empty database.

Solicitud de ejemplo

HTTP
Java

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

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


import com.azure.resourcemanager.sql.models.ImportExistingDatabaseDefinition;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/**
 * Samples for Databases ImportMethod.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportDatabase.json
     */
    /**
     * Sample code: Imports to an existing empty database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToAnExistingEmptyDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases().importMethod("Default-SQL-SouthEastAsia", "testsvr",
            "testdb",
            new ImportExistingDatabaseDefinition().withStorageKeyType(StorageKeyType.STORAGE_ACCESS_KEY)
                .withStorageKey("fakeTokenPlaceholder").withStorageUri("https://test.blob.core.windows.net/test.bacpac")
                .withAdministratorLogin("login").withAdministratorLoginPassword("fakeTokenPlaceholder")
                .withAuthenticationType("Sql"),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:: 200

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

status code:: 202

Definiciones

Nombre	Description
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	Tipo de clave de almacenamiento.

ImportExistingDatabaseDefinition

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

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.
networkIsolation	NetworkIsolationSettings	Información de recursos opcional para habilitar el aislamiento de red para la solicitud.
storageKey	string	Clave de almacenamiento.
storageKeyType	StorageKeyType	Tipo de clave de almacenamiento.
storageUri	string	Uri de almacenamiento.

ImportExportOperationResult

Un recurso de resultado de la operación ImportExport.

Nombre	Tipo	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	PrivateEndpointConnectionRequestStatus[]	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.

Nombre	Tipo	Description
sqlServerResourceId	string	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 el servidor SQL Server. 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.

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.

Nombre	Tipo	Description
SharedAccessKey	string
StorageAccessKey	string

Compartir a través de

Databases - Import

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

Imports to an existing empty database, using private link to communicate with SQL server and storage account.

Solicitud de ejemplo

Respuesta de muestra

Imports to an existing empty database.

Solicitud de ejemplo

Respuesta de muestra

Definiciones

ImportExistingDatabaseDefinition

ImportExportOperationResult

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Recursos adicionales