Servers - Import Database

Referencia

Service:: SQL Database

API Version:: 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}/import?api-version=2021-11-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 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.
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.
Other Status Codes		Respuestas de error: *** 400 MissingImportExportInputParameters: faltan parámetros de entrada ImportExport. 400 InvalidImportExportInputParameter: se produjo un 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 especificado. 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 canceló 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 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles. 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles. 500 OperationTimedOut: se agota el tiempo de espera de la operación y se revierte automáticamente. Vuelva a intentar la operación y, 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles.

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: se produjo un 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 especificado.
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 canceló 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 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.
429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles.
500 OperationTimedOut: se agota el tiempo de espera de la operación y se revierte automáticamente. Vuelva a intentar la operación y,
503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles.

Ejemplos

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

Imports to a new database.

Imports to a new database, using private link for the 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/import?api-version=2021-11-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"
  }
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.ImportNewDatabaseDefinition;
import com.azure.resourcemanager.sql.models.NetworkIsolationSettings;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/** Samples for Servers ImportDatabase. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportNewDatabaseWithNetworkIsolation
     * .json
     */
    /**
     * Sample code: Imports to a new database, using private link for the SQL server and storage account.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToANewDatabaseUsingPrivateLinkForTheSQLServerAndStorageAccount(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().importDatabase("Default-SQL-SouthEastAsia", "testsvr",
            new ImportNewDatabaseDefinition().withDatabaseName("testdb")
                .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")),
            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

Sample Response

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 a new database.

Sample Request

HTTP
Java

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

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


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.ImportNewDatabaseDefinition;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/** Samples for Servers ImportDatabase. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportNewDatabase.json
     */
    /**
     * Sample code: Imports to a new database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToANewDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().importDatabase("Default-SQL-SouthEastAsia", "testsvr",
            new ImportNewDatabaseDefinition().withDatabaseName("testdb")
                .withStorageKeyType(StorageKeyType.STORAGE_ACCESS_KEY).withStorageKey("fakeTokenPlaceholder")
                .withStorageUri("https://test.blob.core.windows.net/test.bacpac").withAdministratorLogin("login")
                .withAdministratorLoginPassword("fakeTokenPlaceholder").withAuthenticationType("Sql"),
            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

Sample Response

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

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.

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

Nombre	Tipo	Description
SharedAccessKey	string
StorageAccessKey	string

Servers - Import Database

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

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

Sample Request

Sample Response

Imports to a new database.

Sample Request

Sample Response

Definiciones

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Recursos adicionales