Servers - Import Database

Referentie

Service:: SQL Database

API Version:: 2021-11-01

Hiermee importeert u een bacpac in een nieuwe database.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name	Vereist	Type	Description
administratorLogin	True	string	Aanmeldingsnaam van beheerder.
administratorLoginPassword	True	string	Aanmeldingswachtwoord voor beheerder.
storageKey	True	string	Opslagsleutel.
storageKeyType	True	StorageKeyType	Type opslagsleutel.
storageUri	True	string	Opslag-URI.
authenticationType		string	Verificatietype.
databaseName		string	Naam van de importdatabase.
edition		string	Editie van de importdatabase.
maxSizeBytes		string	Maximale grootte in bytes voor de importdatabase.
networkIsolation		NetworkIsolationSettings	Optionele resourcegegevens voor het inschakelen van netwerkisolatie voor aanvragen.
serviceObjectiveName		string	De naam van de serviceniveaudoelstelling van de importdatabase.

Antwoorden

Name	Type	Description
200 OK	ImportExportOperationResult	De database is geïmporteerd.
202 Accepted		Het importeren van de database wordt uitgevoerd.
Other Status Codes		Foutreacties: *** 400 MissingImportExportInputParameters - Ontbrekende ImportExport invoerparameters. 400 InvalidImportExportInputParameter: de import-/exportaanvraag is mislukt vanwege een ongeldige invoerparameter. 400 PolybaseImportAuthenticationTypeNotSupported - Parameter verificatietype wordt niet ondersteund voor PolybaseImport bewerking. 400 DatabaseExtensionsInvalidOperationMode - Ongeldige operationMode-parameter voor database-extensie. 400 DatabaseExtensionsInvalidStorageKeyType - Het opslagsleuteltype moet op 'StorageAccessKey' worden uitgevoerd. 400 DatabaseExtensionsMissingStorageUri - Opslag-URI mag niet leeg zijn. 400 InvalidSku: de gebruiker heeft een ongeldige SKU opgegeven. 400 InvalidTierSkuCombination : de opgegeven laag biedt geen ondersteuning voor de opgegeven SKU. 400 DatabaseInvalidSkuPropertyCombination : de eigenschappen van de aangevraagde SKU zijn inconsistent. Controleer of er een geldige combinatie is opgegeven. Zie https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability voor meer informatie. 400 InvalidMaxSizeTierCombination - De opgegeven laag biedt geen ondersteuning voor de opgegeven maximale grootte van de database. 400 FeatureDisabledOnSelectedEdition - Gebruiker heeft geprobeerd een functie te gebruiken die is uitgeschakeld voor de huidige database-editie. 400 InvalidImportExportParameter: de import-/exportaanvraag is mislukt vanwege een ongeldige invoerparameter. 400 InvalidTier : de gebruiker heeft een ongeldige laag opgegeven. 400 InvalidOperationType - Geef een geldig bewerkingstype op. 400 ImportExportJobError : de bewerking ImportExport is mislukt. 400 BlockedByOutboundFirewall: de uitgaande firewallregels hebben de aanvraag geblokkeerd. 404 ResourceNotFound - Ongeldige aanvraag die een niet-bestaande resource aangeeft. 404 ServerNotInSubscriptionResourceGroup : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 ImportExportOperationIdNotFound : de bewerkings-id voor importeren of exporteren kan niet worden gevonden. 404 ServerNotInSubscription : de opgegeven server bestaat niet in het opgegeven abonnement. 404 OperationIdNotFound - De bewerking met id bestaat niet. 409 ImportExportOperationInProgress : er wordt een import- of exportbewerking uitgevoerd op de database. 409 OperationCancelled : de bewerking is geannuleerd door de gebruiker. 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren. 503 TooManyRequests: aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Name

Type

Description

200 OK

ImportExportOperationResult

De database is geïmporteerd.

202 Accepted

Het importeren van de database wordt uitgevoerd.

Other Status Codes

Foutreacties: ***

400 MissingImportExportInputParameters - Ontbrekende ImportExport invoerparameters.
400 InvalidImportExportInputParameter: de import-/exportaanvraag is mislukt vanwege een ongeldige invoerparameter.
400 PolybaseImportAuthenticationTypeNotSupported - Parameter verificatietype wordt niet ondersteund voor PolybaseImport bewerking.
400 DatabaseExtensionsInvalidOperationMode - Ongeldige operationMode-parameter voor database-extensie.
400 DatabaseExtensionsInvalidStorageKeyType - Het opslagsleuteltype moet op 'StorageAccessKey' worden uitgevoerd.
400 DatabaseExtensionsMissingStorageUri - Opslag-URI mag niet leeg zijn.
400 InvalidSku: de gebruiker heeft een ongeldige SKU opgegeven.
400 InvalidTierSkuCombination : de opgegeven laag biedt geen ondersteuning voor de opgegeven SKU.
400 DatabaseInvalidSkuPropertyCombination : de eigenschappen van de aangevraagde SKU zijn inconsistent. Controleer of er een geldige combinatie is opgegeven. Zie https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability voor meer informatie.
400 InvalidMaxSizeTierCombination - De opgegeven laag biedt geen ondersteuning voor de opgegeven maximale grootte van de database.
400 FeatureDisabledOnSelectedEdition - Gebruiker heeft geprobeerd een functie te gebruiken die is uitgeschakeld voor de huidige database-editie.
400 InvalidImportExportParameter: de import-/exportaanvraag is mislukt vanwege een ongeldige invoerparameter.
400 InvalidTier : de gebruiker heeft een ongeldige laag opgegeven.
400 InvalidOperationType - Geef een geldig bewerkingstype op.
400 ImportExportJobError : de bewerking ImportExport is mislukt.
400 BlockedByOutboundFirewall: de uitgaande firewallregels hebben de aanvraag geblokkeerd.
404 ResourceNotFound - Ongeldige aanvraag die een niet-bestaande resource aangeeft.
404 ServerNotInSubscriptionResourceGroup : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.
404 ImportExportOperationIdNotFound : de bewerkings-id voor importeren of exporteren kan niet worden gevonden.
404 ServerNotInSubscription : de opgegeven server bestaat niet in het opgegeven abonnement.
404 OperationIdNotFound - De bewerking met id bestaat niet.
409 ImportExportOperationInProgress : er wordt een import- of exportbewerking uitgevoerd op de database.
409 OperationCancelled : de bewerking is geannuleerd door de gebruiker.
409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource.
429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.
429 SubscriptionTooManyRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.
500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren.
503 TooManyRequests: aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Voorbeelden

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.core.util.Context;
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")),
            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 a new 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/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.core.util.Context;
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"),
            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

Definities

Name	Description
ImportExportOperationResult	Een resource van het resultaat van de ImportExport-bewerking.
ImportNewDatabaseDefinition	Bevat de informatie die nodig is om de importbewerking voor een nieuwe database uit te voeren.
NetworkIsolationSettings	Bevat de ARM-resources waarvoor een privé-eindpuntverbinding moet worden gemaakt.
PrivateEndpointConnectionRequestStatus	Bevat de status van de verbindingsaanvragen van het privé-eindpunt.
StorageKeyType	Type opslagsleutel.

ImportExportOperationResult

Een resource van het resultaat van de ImportExport-bewerking.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.blobUri	string	Blob-URI.
properties.databaseName	string	Databasenaam.
properties.errorMessage	string	Foutbericht.
properties.lastModifiedTime	string	Tijdstip van laatste wijziging.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Hiermee wordt de status opgehaald van privé-eindpunten die aan deze aanvraag zijn gekoppeld.
properties.queuedTime	string	Tijd in de wachtrij.
properties.requestId	string	Aanvraag-id.
properties.requestType	string	Aanvraagtype.
properties.serverName	string	Servernaam.
properties.status	string	Bewerkingsstatus.
type	string	Resourcetype.

ImportNewDatabaseDefinition

Bevat de informatie die nodig is om de importbewerking voor een nieuwe database uit te voeren.

Name	Type	Description
administratorLogin	string	Aanmeldingsnaam van beheerder.
administratorLoginPassword	string	Aanmeldingswachtwoord voor beheerder.
authenticationType	string	Verificatietype.
databaseName	string	Naam van de importdatabase.
edition	string	Editie van de importdatabase.
maxSizeBytes	string	Maximale grootte in bytes voor de importdatabase.
networkIsolation	NetworkIsolationSettings	Optionele resourcegegevens voor het inschakelen van netwerkisolatie voor aanvragen.
serviceObjectiveName	string	De naam van de serviceniveaudoelstelling van de importdatabase.
storageKey	string	Opslagsleutel.
storageKeyType	StorageKeyType	Type opslagsleutel.
storageUri	string	Opslag-URI.

NetworkIsolationSettings

Bevat de ARM-resources waarvoor een privé-eindpuntverbinding moet worden gemaakt.

Name	Type	Description
sqlServerResourceId	string	De resource-id voor de SQL-server die het doel van deze aanvraag is. Als dit is ingesteld, wordt er een privé-eindpuntverbinding gemaakt voor de SQL-server. Moet overeenkomen met de server die het doel van de bewerking is.
storageAccountResourceId	string	De resource-id voor het opslagaccount dat wordt gebruikt om het BACPAC-bestand op te slaan. Als dit is ingesteld, wordt er een privé-eindpuntverbinding gemaakt voor het opslagaccount. Moet overeenkomen met het opslagaccount dat wordt gebruikt voor de parameter StorageUri.

PrivateEndpointConnectionRequestStatus

Bevat de status van de verbindingsaanvragen van het privé-eindpunt.

Name	Type	Description
privateEndpointConnectionName	string	De verbindingsnaam voor het privé-eindpunt.
privateLinkServiceId	string	Resource-id waarvoor het privé-eindpunt is gemaakt.
status	string	Status van deze privé-eindpuntverbinding.

StorageKeyType

Type opslagsleutel.

Name	Type	Description
SharedAccessKey	string
StorageAccessKey	string

Servers - Import Database

URI-parameters

Aanvraagbody

Antwoorden

Voorbeelden

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

Definities

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Aanvullende resources