Databases - Import

Referenz

Service:: SQL Database

API Version:: 2021-11-01

Importiert einen Bacpac in eine neue Datenbank.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	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.
networkIsolation		NetworkIsolationSettings	Optionale Ressourceninformationen zum Aktivieren der Netzwerkisolation für die Anforderung.

Antworten

Name	Typ	Beschreibung
200 OK	ImportExportOperationResult	Die Datenbank wurde erfolgreich importiert.
202 Accepted		Der Import der Datenbank wird ausgeführt.
Other Status Codes		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 nach "StorageAccessKey" angegeben werden. 400 DatabaseExtensionsMissingStorageUri: Speicher-URI darf nicht leer sein. 400 InvalidSku: Der Benutzer hat eine ungültige SKU angegeben. 400 InvalidTierSkuCombination: Die angegebene Ebene unterstützt die angegebene SKU nicht. 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 InvalidMaxSizeTierCombination: Die angegebene Ebene unterstützt die angegebene maximale Datenbankgröße nicht. 400 FeatureDisabledOnSelectedEdition: Der Benutzer hat versucht, ein Feature zu verwenden, das in der aktuellen Datenbankedition deaktiviert ist. 400 InvalidImportExportParameter: Fehler bei der Import/Export-Anforderung aufgrund eines ungültigen Eingabeparameters. 400 InvalidTier: Der Benutzer hat eine ungültige Ebene angegeben. 400 InvalidOperationType: Geben Sie einen gültigen Vorgangstyp an. 400 ImportExportJobError: Fehler beim ImportExport-Vorgang. 400 BlockedByOutboundFirewall: Die ausgehenden Firewallregeln blockierten die Anforderung. 404 ResourceNotFound: Ungültige Anforderung, die eine nicht vorhandene Ressource angibt. 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 ImportExportOperationIdNotFound: Die Vorgangs-ID für den Import oder Export wurde nicht gefunden. 404 ServerNotInSubscription: Der angegebene Server ist im angegebenen Abonnement nicht vorhanden. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 409 ImportExportOperationInProgress: Für die Datenbank wird ein Import- oder Exportvorgang ausgeführt. 409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 500 OperationTimedOut: Der Vorgang ist timeout und wird automatisch zurückgesetzt. Wiederholen Sie den Vorgang. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

Name

Typ

Beschreibung

200 OK

ImportExportOperationResult

Die Datenbank wurde erfolgreich importiert.

202 Accepted

Der Import der Datenbank wird ausgeführt.

Other Status Codes

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 nach "StorageAccessKey" angegeben werden.
400 DatabaseExtensionsMissingStorageUri: Speicher-URI darf nicht leer sein.
400 InvalidSku: Der Benutzer hat eine ungültige SKU angegeben.
400 InvalidTierSkuCombination: Die angegebene Ebene unterstützt die angegebene SKU nicht.
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 InvalidMaxSizeTierCombination: Die angegebene Ebene unterstützt die angegebene maximale Datenbankgröße nicht.
400 FeatureDisabledOnSelectedEdition: Der Benutzer hat versucht, ein Feature zu verwenden, das in der aktuellen Datenbankedition deaktiviert ist.
400 InvalidImportExportParameter: Fehler bei der Import/Export-Anforderung aufgrund eines ungültigen Eingabeparameters.
400 InvalidTier: Der Benutzer hat eine ungültige Ebene angegeben.
400 InvalidOperationType: Geben Sie einen gültigen Vorgangstyp an.
400 ImportExportJobError: Fehler beim ImportExport-Vorgang.
400 BlockedByOutboundFirewall: Die ausgehenden Firewallregeln blockierten die Anforderung.
404 ResourceNotFound: Ungültige Anforderung, die eine nicht vorhandene Ressource angibt.
404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.
404 ImportExportOperationIdNotFound: Die Vorgangs-ID für den Import oder Export wurde nicht gefunden.
404 ServerNotInSubscription: Der angegebene Server ist im angegebenen Abonnement nicht vorhanden.
404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden.
409 ImportExportOperationInProgress: Für die Datenbank wird ein Import- oder Exportvorgang ausgeführt.
409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen.
409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde.
429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.
429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.
500 OperationTimedOut: Der Vorgang ist timeout und wird automatisch zurückgesetzt. Wiederholen Sie den Vorgang.
503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

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.core.util.Context;
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")),
                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 an existing empty 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/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.core.util.Context;
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"),
            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

Definitionen

Name	Beschreibung
ImportExistingDatabaseDefinition	Enthält die Informationen, die zum Ausführen des Importvorgangs für eine vorhandene Datenbank erforderlich sind.
ImportExportOperationResult	Eine ImportExport-Vorgangsergebnisressource.
NetworkIsolationSettings	Enthält die ARM-Ressourcen, für die eine private Endpunktverbindung erstellt werden soll.
PrivateEndpointConnectionRequestStatus	Enthält die Verbindungsanforderungen des privaten Endpunkts status.
StorageKeyType	Speicherschlüsseltyp.

ImportExistingDatabaseDefinition

Enthält die Informationen, die zum Ausführen des Importvorgangs für eine vorhandene Datenbank erforderlich sind.

Name	Typ	Beschreibung
administratorLogin	string	Administratoranmeldungsname.
administratorLoginPassword	string	Administratoranmeldungskennwort.
authenticationType	string	Authentifizierungstyp.
networkIsolation	NetworkIsolationSettings	Optionale Ressourceninformationen zum Aktivieren der Netzwerkisolation für die Anforderung.
storageKey	string	Speicherschlüssel.
storageKeyType	StorageKeyType	Speicherschlüsseltyp.
storageUri	string	Speicher-URI.

ImportExportOperationResult

Eine ImportExport-Vorgangsergebnisressource.

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

NetworkIsolationSettings

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

Name	Typ	Beschreibung
sqlServerResourceId	string	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	Die Ressourcen-ID für das Speicherkonto, das zum Speichern der BACPAC-Datei verwendet wird. Wenn festgelegt, wird eine private Endpunktverbindung für das Speicherkonto erstellt. Muss mit dem Speicherkonto übereinstimmen, das für den StorageUri-Parameter verwendet wird.

PrivateEndpointConnectionRequestStatus

Enthält die Verbindungsanforderungen des privaten Endpunkts status.

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 verbindung mit dem privaten Endpunkt.

StorageKeyType

Speicherschlüsseltyp.

Name	Typ	Beschreibung
SharedAccessKey	string
StorageAccessKey	string

Freigeben über

Databases - Import

URI-Parameter

Anforderungstext

Antworten

Beispiele

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

Sample Request

Sample Response

Imports to an existing empty database.

Sample Request

Sample Response

Definitionen

ImportExistingDatabaseDefinition

ImportExportOperationResult

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Zusätzliche Ressourcen