Servers - Import Database

Importiert ein Bacpac in eine neue Datenbank.

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

URI-Parameter

Name In Required Type Description
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 Required Type Description
administratorLogin True
  • string

Administratoranmeldungsname.

administratorLoginPassword True
  • string

Administratoranmeldungskennwort.

storageKey True
  • string

Speicherschlüssel.

storageKeyType True

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 Bytes für die Importdatenbank.

networkIsolation

Optionale Ressourceninformationen zum Aktivieren der Netzwerkisolation für die Anforderung.

serviceObjectiveName
  • string

Zielname der Dienstebene der Importdatenbank.

Antworten

Name Type Description
200 OK

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 – 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" verwendet werden.

  • 400 DatabaseExtensionsMissingStorageUri – Speicher-URI kann 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 – Benutzer haben 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 kann nicht gefunden werden.

  • 404 ServerNotInSubscription – Der angegebene Server ist für das angegebene Abonnement nicht vorhanden.

  • 409 ImportExportOperationInProgress – Es gibt einen Import- oder Exportvorgang, der in der Datenbank ausgeführt wird.

Beispiele

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

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2022-02-01-preview

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

Sample Response

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

Imports to a new database.

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2022-02-01-preview

{
  "databaseName": "testdb",
  "storageKeyType": "StorageAccessKey",
  "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac",
  "administratorLogin": "login",
  "administratorLoginPassword": "password",
  "authenticationType": "Sql"
}

Sample Response

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

Definitionen

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

Eine Ergebnisressource des ImportExport-Vorgangs.

Name Type Description
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

Letzte Änderungszeit.

properties.privateEndpointConnections

Ruft den 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.

ImportNewDatabaseDefinition

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

Name Type Description
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 Bytes für die Importdatenbank.

networkIsolation

Optionale Ressourceninformationen zum Aktivieren der Netzwerkisolation für die Anforderung.

serviceObjectiveName
  • string

Zielname der Dienstebene der Importdatenbank.

storageKey
  • string

Speicherschlüssel.

storageKeyType

Speicherschlüsseltyp.

storageUri
  • string

Speicher-URI.

NetworkIsolationSettings

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

Name Type Description
sqlServerResourceId
  • string

Die Ressourcen-ID für den SQL-Server, der das Ziel dieser Anforderung ist. Wenn festgelegt, wird die private Endpunktverbindung für den SQL-Server erstellt. Muss mit dem Server übereinstimmen, der ziel des Vorgangs ist.

storageAccountResourceId
  • string

Die Ressourcen-ID für das Speicherkonto, das zum Speichern der BACPAC-Datei verwendet wird. Wenn festgelegt, wird die private Endpunktverbindung für das Speicherkonto erstellt. Muss mit dem Speicherkonto übereinstimmen, das für den StorageUri-Parameter verwendet wird.

PrivateEndpointConnectionRequestStatus

Enthält den Status der privaten Endpunktverbindungsanforderungen.

Name Type Description
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

Speicherschlüsseltyp.

Name Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string