Servers - Import Database

Referenz

Service:: SQL Database

API Version:: 2020-11-01-preview

Importiert eine Bacpac-Datei in eine neue Datenbank.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
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	Administratoranmeldekennwort.
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	Der Dienstebenenzielname der Importdatenbank.

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 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: Der Speicher-URI darf nicht leer sein. 400 FeatureDisabledOnSelectedEdition: Der Benutzer hat versucht, ein Feature zu verwenden, das in der aktuellen Datenbankedition deaktiviert ist. 400 InvalidOperationType: Geben Sie einen gültigen Vorgangstyp an. 400 ImportExportJobError: Fehler beim ImportExport-Vorgang. 400 BlockedByOutboundFirewall: Die Firewallregeln für ausgehenden Datenverkehr 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. 409 ImportExportOperationInProgress: Es wird ein Import- oder Exportvorgang für die Datenbank ausgeführt.

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 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: Der Speicher-URI darf nicht leer sein.
400 FeatureDisabledOnSelectedEdition: Der Benutzer hat versucht, ein Feature zu verwenden, das in der aktuellen Datenbankedition deaktiviert ist.
400 InvalidOperationType: Geben Sie einen gültigen Vorgangstyp an.
400 ImportExportJobError: Fehler beim ImportExport-Vorgang.
400 BlockedByOutboundFirewall: Die Firewallregeln für ausgehenden Datenverkehr 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.
409 ImportExportOperationInProgress: Es wird ein Import- oder Exportvorgang für die Datenbank ausgeführt.

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.

Sample Request

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2020-11-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

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 a new database.

Sample Request

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2020-11-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

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
ImportExportOperationResult	Eine ImportExport-Vorgangsergebnisressource.
ImportNewDatabaseDefinition	Enthält die Informationen, die zum Ausführen des Importvorgangs für eine neue Datenbank erforderlich sind.
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.

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 der privaten 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 eine neue Datenbank erforderlich sind.

Name	Typ	Beschreibung
administratorLogin	string	Administratoranmeldungsname.
administratorLoginPassword	string	Administratoranmeldekennwort.
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	Der Dienstebenenzielname der Importdatenbank.
storageKey	string	Speicherschlüssel.
storageKeyType	StorageKeyType	Speicherschlüsseltyp.
storageUri	string	Speicher-URI.

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 Privaten Endpunktverbindung.

StorageKeyType

Speicherschlüsseltyp.

Name	Typ	Beschreibung
SharedAccessKey	string
StorageAccessKey	string

Servers - Import Database

URI-Parameter

Anforderungstext

Antworten

Beispiele

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

Sample Request

Sample Response

Imports to a new database.

Sample Request

Sample Response

Definitionen

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Zusätzliche Ressourcen