Servers - Import Database

Referenz

Dienst:: 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}/import?api-version=2021-11-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.
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 von 'StorageAccessKey' sein. 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 Datenbank max. Größ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-/Exportanforderung 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 für das angegebene Abonnement nicht vorhanden. 404 OperationIdNotFound – Der Vorgang mit der ID ist nicht vorhanden. 409 ImportExportOperationInProgress – Es wird ein Import- oder Exportvorgang in der Datenbank ausgeführt. 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.

Name

Typ

Beschreibung

200 OK

ImportExportOperationResult

Die Datenbank wurde erfolgreich importiert.

202 Accepted

Das Importieren 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 von 'StorageAccessKey' sein.
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 Datenbank max. Größ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-/Exportanforderung 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 für das angegebene Abonnement nicht vorhanden.
404 OperationIdNotFound – Der Vorgang mit der ID ist nicht vorhanden.
409 ImportExportOperationInProgress – Es wird ein Import- oder Exportvorgang in der Datenbank ausgeführt.
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.

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.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")),
            com.azure.core.util.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

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

Imports to a new database.

Beispielanforderung

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.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"),
            com.azure.core.util.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

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

Definitionen

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

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

Freigeben über

Servers - Import Database

URI-Parameter

Anforderungstext

Antworten

Beispiele

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

Beispielanforderung

Beispiel für eine Antwort

Imports to a new database.

Beispielanforderung

Beispiel für eine Antwort

Definitionen

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Zusätzliche Ressourcen