Servers - Import Database

Servizio:

SQL Database

Versione API:

2023-08-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=2023-08-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager 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 dell'amministratore.
administratorLoginPassword	True	string	Password di accesso dell'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 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. Intestazioni Location: string
Other Status Codes	ErrorResponse	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 SQLPasswordSpecifiedWithManagedIdentity - administratorLoginPassword non deve essere specificato se authenticationType è ManagedIdentity. 400 InvalidSqlAuthType - Operazione ImportExport non riuscita perché il tipo di autenticazione sql non è valido 400 BlobAlreadyExist - Operazione ImportExport non riuscita perché il BLOB di archiviazione esiste già 400 InvalidImportExportOperationResourceLocks- La richiesta di importazione/esportazione non è valida a causa di blocchi sulle risorse collegamento privato. 400 DatabaseInvalidSkuPropertyCombination: le proprietà dello SKU richiesto non sono coerenti. Verificare che sia specificata una combinazione valida. Per altri dettagli, vedere https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability. 400 ImportExportJobError - L'operazione ImportExport non è riuscita. 400 BlockedByOutboundFirewall: le regole del firewall in uscita bloccavano la richiesta. 400 InvalidOperationType: specificare un tipo di operazione valido. 400 InvalidMaxSizeTierCombination: il livello specificato non supporta le dimensioni massime del database specificate. 400 InvalidTier: l'utente ha specificato un livello non valido. 400 CannotUseReservedDatabaseName: impossibile utilizzare il nome del database riservato in questa operazione. 400 InvalidImportExportParameter - La richiesta di importazione/esportazione non è riuscita a causa di un parametro di input non valido. 400 InvalidSku: l'utente ha specificato uno SKU non valido. 400 InvalidTierSkuCombination: il livello specificato non supporta lo SKU specificato. 400 InvalidImportExportStorageCredentials - Operazione di importazione/esportazione non riuscita a causa di credenziali di archiviazione non valide 400 InvalidImportExportStorageAuthType - Operazione di importazione/esportazione non riuscita a causa di un tipo di autenticazione di archiviazione non valido 400 InvalidImportExportStorageKeyFormat - Operazione di importazione/esportazione non riuscita a causa di un formato di chiave di archiviazione non valido 400 LongImportExportStorageUri - Operazione di importazione/esportazione non riuscita a causa di un URI di archiviazione lungo 400 LargeExportDatabaseSize - Operazione di esportazione non riuscita perché il database è maggiore delle dimensioni massime supportate 400 FeatureDisabledOnSelectedEdition : l'utente ha tentato di usare una funzionalità disabilitata nell'edizione del database corrente. 400 UnSupportedImportExportEdition - Operazione ImportExport non riuscita perché è destinata a un'edizione non valida 400 InvalidImportExportStorageURI - Operazione ImportExport non riuscita perché l'URI di archiviazione non è valido 404 DatabaseDoesNotExist: l'utente ha specificato un nome di database che non esiste in questa istanza del server. 404 ServerNotInSubscription - Il server specificato non esiste nella sottoscrizione specificata. 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 ResourceNotFound - Richiesta non valida che specifica una risorsa inesistente. 404 ImportExportOperationIdNotFound - Impossibile trovare l'ID operazione per l'importazione o l'esportazione. 404 OperationIdNotFound - L'operazione con ID non esiste. 409 ImportExportOperationInProgress- È in corso un'operazione di importazione o esportazione nel database. 409 CannotCancelOperation: l'operazione di gestione si trova in uno stato che non può essere annullato. 409 OperationCancelled - L'operazione è stata annullata dall'utente. 409 OperationInterrupted - 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.

Esempio di richiesta

HTTP

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ImportNewDatabaseWithNetworkIsolation.json
// this example is just showing the usage of "Servers_ImportDatabase" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlServerResource created on azure
// for more information of creating SqlServerResource, please refer to the document of SqlServerResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default-SQL-SouthEastAsia";
string serverName = "testsvr";
ResourceIdentifier sqlServerResourceId = SqlServerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName);
SqlServerResource sqlServer = client.GetSqlServerResource(sqlServerResourceId);

// invoke the operation
DatabaseImportDefinition databaseImportDefinition = new DatabaseImportDefinition(StorageKeyType.StorageAccessKey, "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==", new Uri("https://test.blob.core.windows.net/test.bacpac"), "login", "password")
{
    DatabaseName = "testdb",
    AuthenticationType = "Sql",
    NetworkIsolation = new NetworkIsolationSettings
    {
        StorageAccountResourceId = new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Storage/storageAccounts/test-privatelink"),
        SqlServerResourceId = new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr"),
    },
};
ArmOperation<ImportExportOperationResult> lro = await sqlServer.ImportDatabaseAsync(WaitUntil.Completed, databaseImportDefinition);
ImportExportOperationResult result = lro.Value;

Console.WriteLine($"Succeeded: {result}");

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

202

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.

Esempio di richiesta

HTTP

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ImportNewDatabase.json
// this example is just showing the usage of "Servers_ImportDatabase" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlServerResource created on azure
// for more information of creating SqlServerResource, please refer to the document of SqlServerResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default-SQL-SouthEastAsia";
string serverName = "testsvr";
ResourceIdentifier sqlServerResourceId = SqlServerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName);
SqlServerResource sqlServer = client.GetSqlServerResource(sqlServerResourceId);

// invoke the operation
DatabaseImportDefinition databaseImportDefinition = new DatabaseImportDefinition(StorageKeyType.StorageAccessKey, "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==", new Uri("https://test.blob.core.windows.net/test.bacpac"), "login", "password")
{
    DatabaseName = "testdb",
    AuthenticationType = "Sql",
};
ArmOperation<ImportExportOperationResult> lro = await sqlServer.ImportDatabaseAsync(WaitUntil.Completed, databaseImportDefinition);
ImportExportOperationResult result = lro.Value;

Console.WriteLine($"Succeeded: {result}");

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

202

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

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
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 le quali creare una connessione all'endpoint privato.
PrivateEndpointConnectionRequestStatus	Contiene lo stato delle richieste di connessione dell'endpoint privato.
StorageKeyType	Tipo di chiave di archiviazione.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ImportExportOperationResult

Object

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 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	Tempo in coda.
properties.requestId	string (uuid)	ID richiesta.
properties.requestType	string	Tipo di richiesta.
properties.serverName	string	Nome server.
properties.status	string	Stato dell'operazione.
type	string	Tipo di risorsa.

ImportNewDatabaseDefinition

Object

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

Nome	Tipo	Descrizione
administratorLogin	string	Nome di accesso dell'amministratore.
administratorLoginPassword	string	Password di accesso dell'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 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

Object

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

Nome	Tipo	Descrizione
sqlServerResourceId	string (arm-id)	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 (arm-id)	ID risorsa per l'account di archiviazione usato per archiviare il file BACPAC. Se impostato, verrà creata la connessione all'endpoint privato per l'account di archiviazione. Deve corrispondere all'account di archiviazione usato per il parametro StorageUri.

PrivateEndpointConnectionRequestStatus

Object

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 di questa connessione endpoint privato.

StorageKeyType

Enumerazione

Tipo di chiave di archiviazione.

Valore	Descrizione
SharedAccessKey
StorageAccessKey