Servers - Import Database

Dienst:

SQL Database

API-Version:

2023-08-01

Importiert einen Bacpac in eine neue Datenbank.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
serverName	path	True	string	Der Name des Servers.
subscriptionId	path	True	string	Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version	query	True	string	Die API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
administratorLogin	True	string	Administratoranmeldungsname.
administratorLoginPassword	True	string	Administratoranmeldungskennwort.
storageKey	True	string	Speicherschlüssel.
storageKeyType	True	StorageKeyType	Speicherschlüsseltyp.
storageUri	True	string	Speicher-URI.
authenticationType		string	Authentifizierungstyp.
databaseName		string	Name der Importdatenbank.
edition		string	Edition der Importdatenbank.
maxSizeBytes		string	Maximale Größe in Byte für die Importdatenbank.
networkIsolation		NetworkIsolationSettings	Optionale Ressourceninformationen zum Aktivieren der Netzwerkisolation für die Anforderung.
serviceObjectiveName		string	Zielname der Dienstebene der Importdatenbank.

Antworten

Name	Typ	Beschreibung
200 OK	ImportExportOperationResult	Die Datenbank wurde erfolgreich importiert.
202 Accepted		Das Importieren der Datenbank wird ausgeführt. Header Location: string
Other Status Codes	ErrorResponse	Fehlerantworten: *** 400 MissingImportExportInputParameters – Fehlende ImportExport-Eingabeparameter. 400 InvalidImportExportInputParameter – Fehler bei der Import-/Exportanforderung aufgrund eines ungültigen Eingabeparameters. 400 PolybaseImportAuthenticationTypeNotSupported – Der Authentifizierungstypparameter wird für den PolybaseImport-Vorgang nicht unterstützt. 400 DatabaseExtensionsInvalidOperationMode – Ungültiger operationMode-Parameter für die Datenbankerweiterung. 400 DatabaseExtensionsInvalidStorageKeyType – Der Speicherschlüsseltyp muss von 'StorageAccessKey' sein. 400 DatabaseExtensionsMissingStorageUri – Speicher-URI darf nicht leer sein. 400 SQLPasswordSpecifiedWithManagedIdentity – administratorLoginPassword sollte nicht angegeben werden, wenn authenticationType managedIdentity ist. 400 InvalidSqlAuthType – ImportExport-Vorgang fehlgeschlagen, da der SQL-Authentifizierungstyp ungültig ist. 400 BlobAlreadyExist – ImportExport-Vorgang fehlgeschlagen, da das Speicher-Blob bereits vorhanden ist 400 InvalidImportExportOperationResourceLocks – Die Import/Export-Anforderung ist aufgrund von Sperren der Ressourcen für private Verknüpfungen ungültig. 400 DatabaseInvalidSkuPropertyCombination – Die Eigenschaften der angeforderten Sku sind inkonsistent. Überprüfen Sie, ob eine gültige Kombination angegeben ist. Weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability. 400 ImportExportJobError – Fehler beim ImportExport-Vorgang. 400 BlockedByOutboundFirewall – Die ausgehenden Firewallregeln blockierten die Anforderung. 400 InvalidOperationType – Geben Sie einen gültigen Vorgangstyp an. 400 InvalidMaxSizeTierCombination – Die angegebene Ebene unterstützt die angegebene Datenbank max. Größe nicht. 400 InvalidTier – Der Benutzer hat eine ungültige Ebene angegeben. 400 CannotUseReservedDatabaseName – In diesem Vorgang kann kein reservierter Datenbankname verwendet werden. 400 InvalidImportExportParameter – Fehler bei der Import-/Exportanforderung aufgrund eines ungültigen Eingabeparameters. 400 InvalidSku – Der Benutzer hat eine ungültige Sku angegeben. 400 InvalidTierSkuCombination – Die angegebene Ebene unterstützt die angegebene SKU nicht. 400 InvalidImportExportStorageCredentials – Import/Export-Vorgang aufgrund ungültiger Speicheranmeldeinformationen fehlgeschlagen 400 InvalidImportExportStorageAuthType – Import/Export-Vorgang aufgrund eines ungültigen Speicherauthentifizierungstyps fehlgeschlagen 400 InvalidImportExportStorageKeyFormat – Import/Export-Vorgang aufgrund eines ungültigen Speicherschlüsselformats fehlgeschlagen 400 LongImportExportStorageUri – Import/Export-Vorgang aufgrund eines langen Speicher-URI fehlgeschlagen 400 LargeExportDatabaseSize – Exportvorgang fehlgeschlagen, da die Datenbank größer als die maximal unterstützte Größe ist. 400 FeatureDisabledOnSelectedEdition – Der Benutzer hat versucht, ein Feature zu verwenden, das in der aktuellen Datenbankedition deaktiviert ist. 400 UnSupportedImportExportEdition – ImportExport-Vorgang fehlgeschlagen, weil er auf eine ungültige Edition ausgerichtet ist 400 InvalidImportExportStorageURI – ImportExport-Vorgang fehlgeschlagen, da der Speicher-URI ungültig ist. 404 DatabaseDoesNotExist – Der Benutzer hat einen Datenbanknamen angegeben, der in dieser Serverinstanz nicht vorhanden ist. 404 ServerNotInSubscription – Der angegebene Server ist für das angegebene Abonnement nicht vorhanden. 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 ResourceNotFound – Ungültige Anforderung, die eine nicht vorhandene Ressource angibt. 404 ImportExportOperationIdNotFound – Die Vorgangs-ID für den Import oder Export wurde nicht gefunden. 404 OperationIdNotFound – Der Vorgang mit der ID ist nicht vorhanden. 409 ImportExportOperationInProgress – Es wird ein Import- oder Exportvorgang in der Datenbank ausgeführt. 409 CannotCancelOperation – Der Verwaltungsvorgang befindet sich in einem Zustand, der nicht abgebrochen werden kann. 409 OperationCancelled – Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted – Der Vorgang für die Ressource konnte nicht abgeschlossen werden, weil er durch einen anderen Vorgang in derselben Ressource unterbrochen wurde. 429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 500 OperationTimedOut – Timeout des Vorgangs und automatisches Zurücksetzen. Versuchen Sie den Vorgang erneut. 503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

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.

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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

Statuscode:

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.

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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

Statuscode:

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

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
ImportExportOperationResult	Eine Ergebnisressource des ImportExport-Vorgangs.
ImportNewDatabaseDefinition	Enthält die informationen, die zum Ausführen des Importvorgangs für neue Datenbank erforderlich sind.
NetworkIsolationSettings	Enthält die ARM-Ressourcen, für die eine private Endpunktverbindung erstellt werden soll.
PrivateEndpointConnectionRequestStatus	Enthält den Status der privaten Endpunktverbindungsanforderungen.
StorageKeyType	Speicherschlüsseltyp.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ImportExportOperationResult

Objekt

Eine Ergebnisressource des ImportExport-Vorgangs.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
name	string	Ressourcenname.
properties.blobUri	string	Blob-URI.
properties.databaseName	string	Datenbankname.
properties.errorMessage	string	Fehlermeldung.
properties.lastModifiedTime	string	Zeitpunkt der letzten Änderung.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Ruft den Status privater Endpunkte ab, die dieser Anforderung zugeordnet sind.
properties.queuedTime	string	In die Warteschlange eingereihte Zeit.
properties.requestId	string (uuid)	Anforderungs-ID.
properties.requestType	string	Anforderungstyp.
properties.serverName	string	Servername.
properties.status	string	Vorgangsstatus.
type	string	Ressourcentyp.

ImportNewDatabaseDefinition

Objekt

Enthält die informationen, die zum Ausführen des Importvorgangs für neue Datenbank erforderlich sind.

Name	Typ	Beschreibung
administratorLogin	string	Administratoranmeldungsname.
administratorLoginPassword	string	Administratoranmeldungskennwort.
authenticationType	string	Authentifizierungstyp.
databaseName	string	Name der Importdatenbank.
edition	string	Edition der Importdatenbank.
maxSizeBytes	string	Maximale Größe in Byte für die Importdatenbank.
networkIsolation	NetworkIsolationSettings	Optionale Ressourceninformationen zum Aktivieren der Netzwerkisolation für die Anforderung.
serviceObjectiveName	string	Zielname der Dienstebene der Importdatenbank.
storageKey	string	Speicherschlüssel.
storageKeyType	StorageKeyType	Speicherschlüsseltyp.
storageUri	string	Speicher-URI.

NetworkIsolationSettings

Objekt

Enthält die ARM-Ressourcen, für die eine private Endpunktverbindung erstellt werden soll.

Name	Typ	Beschreibung
sqlServerResourceId	string (arm-id)	Die Ressourcen-ID für den SQL-Server, der das Ziel dieser Anforderung ist. Wenn festgelegt, wird eine private Endpunktverbindung für den SQL-Server erstellt. Muss mit dem Server übereinstimmen, der das Ziel des Vorgangs ist.
storageAccountResourceId	string (arm-id)	Die Ressourcen-ID für das Speicherkonto, das zum Speichern der BACPAC-Datei verwendet wird. Bei Festlegung wird für das Speicherkonto eine private Endpunktverbindung erstellt. Muss mit dem Speicherkonto übereinstimmen, das für den Parameter "StorageUri" verwendet wird.

PrivateEndpointConnectionRequestStatus

Objekt

Enthält den Status der privaten Endpunktverbindungsanforderungen.

Name	Typ	Beschreibung
privateEndpointConnectionName	string	Der Verbindungsname für den privaten Endpunkt.
privateLinkServiceId	string	Ressourcen-ID, für die der private Endpunkt erstellt wird.
status	string	Status dieser privaten Endpunktverbindung.

StorageKeyType

Enumeration

Speicherschlüsseltyp.

Wert	Beschreibung
SharedAccessKey
StorageAccessKey