Databases - Export

Referentie

Service:: SQL Database

API Version:: 2021-11-01

Hiermee exporteert u een database.

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

URI-parameters

Name	In	Vereist	Type	Description
databaseName	path	True	string	De naam van de database.
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	Wachtwoord voor beheerdersaanmelding.
storageKey	True	string	Opslagsleutel.
storageKeyType	True	StorageKeyType	Type opslagsleutel.
storageUri	True	string	Opslag-URI.
authenticationType		string	Verificatietype.
networkIsolation		NetworkIsolationSettings	Optionele resourcegegevens voor het inschakelen van netwerkisolatie voor aanvragen.

Antwoorden

Name	Type	Description
200 OK	ImportExportOperationResult	De database is geëxporteerd.
202 Accepted		De database wordt geëxporteerd.
Other Status Codes		Foutreacties: *** 400 MissingImportExportInputParameters - Ontbrekende invoerparameters ImportExport. 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 in 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 importexportbewerking is mislukt. 400 BlockedByOutboundFirewall: de uitgaande firewallregels hebben de aanvraag geblokkeerd. 404 ResourceNotFound - Ongeldige aanvraag die een niet-bestaande resource opgeeft. 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 maximum aantal 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ëxporteerd.

202 Accepted

De database wordt geëxporteerd.

Other Status Codes

Foutreacties: ***

400 MissingImportExportInputParameters - Ontbrekende invoerparameters ImportExport.
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 in 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 importexportbewerking is mislukt.
400 BlockedByOutboundFirewall: de uitgaande firewallregels hebben de aanvraag geblokkeerd.
404 ResourceNotFound - Ongeldige aanvraag die een niet-bestaande resource opgeeft.
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 maximum aantal 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

Exports a database, using private link to communicate with SQL server and storage account.

Exports a database.

Exports a 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/export?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.ExportDatabaseDefinition;
import com.azure.resourcemanager.sql.models.NetworkIsolationSettings;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/** Samples for Databases Export. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ExportDatabaseWithNetworkIsolation.
     * json
     */
    /**
     * Sample code: Exports a 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 exportsADatabaseUsingPrivateLinkToCommunicateWithSQLServerAndStorageAccount(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases()
            .export("Default-SQL-SouthEastAsia", "testsvr", "testdb", new ExportDatabaseDefinition()
                .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": "Export",
    "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

Exports a 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/export?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.ExportDatabaseDefinition;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/** Samples for Databases Export. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ExportDatabase.json
     */
    /**
     * Sample code: Exports a database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void exportsADatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases().export("Default-SQL-SouthEastAsia", "testsvr",
            "testdb",
            new ExportDatabaseDefinition().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": "Export",
    "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
ExportDatabaseDefinition	Bevat de informatie die nodig is om de exportdatabasebewerking uit te voeren.
ImportExportOperationResult	Een resource met het resultaat van de importexportbewerking.
NetworkIsolationSettings	Bevat de ARM-resources waarvoor een privé-eindpuntverbinding moet worden gemaakt.
PrivateEndpointConnectionRequestStatus	Bevat de status van de verbindingsaanvragen voor het privé-eindpunt.
StorageKeyType	Type opslagsleutel.

ExportDatabaseDefinition

Bevat de informatie die nodig is om de exportdatabasebewerking uit te voeren.

Name	Type	Description
administratorLogin	string	Aanmeldingsnaam van beheerder.
administratorLoginPassword	string	Wachtwoord voor beheerdersaanmelding.
authenticationType	string	Verificatietype.
networkIsolation	NetworkIsolationSettings	Optionele resourcegegevens voor het inschakelen van netwerkisolatie voor aanvragen.
storageKey	string	Opslagsleutel.
storageKeyType	StorageKeyType	Type opslagsleutel.
storageUri	string	Opslag-URI.

ImportExportOperationResult

Een resource met het resultaat van de importexportbewerking.

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 wachtrij.
properties.requestId	string	Aanvraag-id.
properties.requestType	string	Aanvraagtype.
properties.serverName	string	Servernaam.
properties.status	string	Bewerkingsstatus.
type	string	Resourcetype.

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 voor 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

Delen via

Databases - Export

URI-parameters

Aanvraagbody

Antwoorden

Voorbeelden

Exports a database, using private link to communicate with SQL server and storage account.

Sample Request

Sample Response

Exports a database.

Sample Request

Sample Response

Definities

ExportDatabaseDefinition

ImportExportOperationResult

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Aanvullende resources