Servers - Import Database

Riferimento

Service:: SQL Database

API Version:: 2021-11-01

Importa un bacpac in un nuovo database.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.
serverName	path	True	string	Nome del server.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
administratorLogin	True	string	Nome di accesso amministratore.
administratorLoginPassword	True	string	Password di accesso amministratore.
storageKey	True	string	Chiave di archiviazione.
storageKeyType	True	StorageKeyType	Tipo di chiave di archiviazione.
storageUri	True	string	URI di archiviazione.
authenticationType		string	Tipo di autenticazione.
databaseName		string	Nome del database di importazione.
edition		string	Edizione del database di importazione.
maxSizeBytes		string	Dimensioni massime in byte per il database di importazione.
networkIsolation		NetworkIsolationSettings	Informazioni facoltative sulle risorse per abilitare l'isolamento di rete per la richiesta.
serviceObjectiveName		string	Nome dell'obiettivo del livello di servizio del database di importazione.

Risposte

Nome	Tipo	Descrizione
200 OK	ImportExportOperationResult	Il database è stato importato correttamente.
202 Accepted		L'importazione del database è in corso.
Other Status Codes		Risposte di errore: 400 MissingImportExportInputParameters - Parametri di input ImportExport mancanti. 400 InvalidImportExportInputParameter - La richiesta di importazione/esportazione non è riuscita a causa di un parametro di input non valido. 400 PolybaseImportAuthenticationTypeNotSupported - Il parametro del tipo di autenticazione non è supportato per l'operazione PolybaseImport. 400 DatabaseExtensionsInvalidOperationMode - Parametro operationMode non valido per l'estensione del database. 400 DatabaseExtensionsInvalidStorageKeyType: il tipo di chiave di archiviazione deve essere "StorageAccessKey". 400 DatabaseExtensionsMissingStorageUri: l'URI di archiviazione non può essere vuoto. 400 InvalidSku: l'utente ha specificato uno SKU non valido. 400 InvalidTierSkuCombination: il livello specificato non supporta lo SKU specificato. 400 DatabaseInvalidSkuPropertyCombination: le proprietà dello SKU richiesto non sono coerenti. Verificare che sia specificata una combinazione valida. Per informazioni dettagliate, vedere https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability. 400 InvalidMaxSizeTierCombination: il livello specificato non supporta le dimensioni massime del database specificate. 400 FeatureDisabledOnSelectedEdition : l'utente ha tentato di usare una funzionalità disabilitata nell'edizione di database corrente. 400 InvalidImportExportParameter - Richiesta di importazione/esportazione non riuscita a causa di un parametro di input non valido. 400 InvalidTier: l'utente ha specificato un livello non valido. 400 InvalidOperationType: specificare un tipo di operazione valido. 400 ImportExportJobError: l'operazione ImportExport non è riuscita. 400 BlockedByOutboundFirewall: le regole del firewall in uscita bloccavano la richiesta. 404 ResourceNotFound - Richiesta non valida che specifica una risorsa inesistente. 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 ImportExportOperationIdNotFound- Impossibile trovare l'ID operazione per l'importazione o l'esportazione. 404 ServerNotInSubscription : il server specificato non esiste nella sottoscrizione specificata. 404 OperationIdNotFound- L'operazione con ID non esiste. 409 ImportExportOperationInProgress - È in corso un'operazione di importazione o esportazione nel database. 409 OperationCancelled - L'operazione è stata annullata dall'utente. 409 Operazione interrotta- Impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa. 429 SubscriptionTooManyCreateUpdateRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione. 503 TooManyRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Nome

Tipo

Descrizione

200 OK

ImportExportOperationResult

Il database è stato importato correttamente.

202 Accepted

L'importazione del database è in corso.

Other Status Codes

Risposte di errore:

400 MissingImportExportInputParameters - Parametri di input ImportExport mancanti.
400 InvalidImportExportInputParameter - La richiesta di importazione/esportazione non è riuscita a causa di un parametro di input non valido.
400 PolybaseImportAuthenticationTypeNotSupported - Il parametro del tipo di autenticazione non è supportato per l'operazione PolybaseImport.
400 DatabaseExtensionsInvalidOperationMode - Parametro operationMode non valido per l'estensione del database.
400 DatabaseExtensionsInvalidStorageKeyType: il tipo di chiave di archiviazione deve essere "StorageAccessKey".
400 DatabaseExtensionsMissingStorageUri: l'URI di archiviazione non può essere vuoto.
400 InvalidSku: l'utente ha specificato uno SKU non valido.
400 InvalidTierSkuCombination: il livello specificato non supporta lo SKU specificato.
400 DatabaseInvalidSkuPropertyCombination: le proprietà dello SKU richiesto non sono coerenti. Verificare che sia specificata una combinazione valida. Per informazioni dettagliate, vedere https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.
400 InvalidMaxSizeTierCombination: il livello specificato non supporta le dimensioni massime del database specificate.
400 FeatureDisabledOnSelectedEdition : l'utente ha tentato di usare una funzionalità disabilitata nell'edizione di database corrente.
400 InvalidImportExportParameter - Richiesta di importazione/esportazione non riuscita a causa di un parametro di input non valido.
400 InvalidTier: l'utente ha specificato un livello non valido.
400 InvalidOperationType: specificare un tipo di operazione valido.
400 ImportExportJobError: l'operazione ImportExport non è riuscita.
400 BlockedByOutboundFirewall: le regole del firewall in uscita bloccavano la richiesta.
404 ResourceNotFound - Richiesta non valida che specifica una risorsa inesistente.
404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.
404 ImportExportOperationIdNotFound- Impossibile trovare l'ID operazione per l'importazione o l'esportazione.
404 ServerNotInSubscription : il server specificato non esiste nella sottoscrizione specificata.
404 OperationIdNotFound- L'operazione con ID non esiste.
409 ImportExportOperationInProgress - È in corso un'operazione di importazione o esportazione nel database.
409 OperationCancelled - L'operazione è stata annullata dall'utente.
409 Operazione interrotta- Impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa.
429 SubscriptionTooManyCreateUpdateRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione.
503 TooManyRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

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

Definizioni

Nome	Descrizione
ImportExportOperationResult	Risorsa risultato dell'operazione ImportExport.
ImportNewDatabaseDefinition	Contiene le informazioni necessarie per eseguire l'operazione di importazione per il nuovo database.
NetworkIsolationSettings	Contiene le risorse arm per cui creare una connessione all'endpoint privato.
PrivateEndpointConnectionRequestStatus	Contiene lo stato delle richieste di connessione dell'endpoint privato.
StorageKeyType	Tipo di chiave di archiviazione.

ImportExportOperationResult

Risorsa risultato dell'operazione ImportExport.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.blobUri	string	URI BLOB.
properties.databaseName	string	nome del database.
properties.errorMessage	string	Messaggio di errore.
properties.lastModifiedTime	string	Ora dell'ultima modifica.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Ottiene lo stato degli endpoint privati associati a questa richiesta.
properties.queuedTime	string	Ora in coda.
properties.requestId	string	ID richiesta.
properties.requestType	string	Tipo di richiesta.
properties.serverName	string	Nome del server.
properties.status	string	Stato dell'operazione.
type	string	Tipo di risorsa.

ImportNewDatabaseDefinition

Contiene le informazioni necessarie per eseguire l'operazione di importazione per il nuovo database.

Nome	Tipo	Descrizione
administratorLogin	string	Nome di accesso amministratore.
administratorLoginPassword	string	Password di accesso amministratore.
authenticationType	string	Tipo di autenticazione.
databaseName	string	Nome del database di importazione.
edition	string	Edizione del database di importazione.
maxSizeBytes	string	Dimensioni massime in byte per il database di importazione.
networkIsolation	NetworkIsolationSettings	Informazioni facoltative sulle risorse per abilitare l'isolamento di rete per la richiesta.
serviceObjectiveName	string	Nome dell'obiettivo del livello di servizio del database di importazione.
storageKey	string	Chiave di archiviazione.
storageKeyType	StorageKeyType	Tipo di chiave di archiviazione.
storageUri	string	URI di archiviazione.

NetworkIsolationSettings

Contiene le risorse arm per cui creare una connessione all'endpoint privato.

Nome	Tipo	Descrizione
sqlServerResourceId	string	ID risorsa per SQL Server che è la destinazione di questa richiesta. Se impostato, verrà creata la connessione all'endpoint privato per SQL Server. Deve corrispondere al server di destinazione dell'operazione.
storageAccountResourceId	string	ID risorsa per l'account di archiviazione usato per archiviare il file BACPAC. Se impostato, verrà creata la connessione dell'endpoint privato per l'account di archiviazione. Deve corrispondere all'account di archiviazione usato per il parametro StorageUri.

PrivateEndpointConnectionRequestStatus

Contiene lo stato delle richieste di connessione dell'endpoint privato.

Nome	Tipo	Descrizione
privateEndpointConnectionName	string	Nome della connessione per l'endpoint privato.
privateLinkServiceId	string	ID risorsa per cui viene creato l'endpoint privato.
status	string	Stato della connessione all'endpoint privato.

StorageKeyType

Tipo di chiave di archiviazione.

Nome	Tipo	Descrizione
SharedAccessKey	string
StorageAccessKey	string

Servers - Import Database

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

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

Definizioni

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Risorse aggiuntive