Databases - Export

Szolgáltatás:: SQL Database

API verzió:: 2023-08-01

Adatbázis exportálása.

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

URI paraméterek

Név	Ban	Szükséges	Típus	Leírás
databaseName	path	True	string	Az adatbázis neve.
resourceGroupName	path	True	string	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
serverName	path	True	string	A kiszolgáló neve.
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
api-version	query	True	string	A kéréshez használni kívánt API-verzió.

Kérő Testület

Név	Szükséges	Típus	Leírás
administratorLogin	True	string	Rendszergazdai bejelentkezési név.
administratorLoginPassword	True	string	Rendszergazdai bejelentkezési jelszó.
storageKey	True	string	Tárkulcs.
storageKeyType	True	StorageKeyType	Tárkulcs típusa.
storageUri	True	string	Storage Uri.
authenticationType		string	Hitelesítési típus.
networkIsolation		NetworkIsolationSettings	Nem kötelező erőforrás-információk a kérések hálózati elkülönítésének engedélyezéséhez.

Válaszok

Név	Típus	Leírás
200 OK	ImportExportOperationResult	Sikeresen exportálta az adatbázist.
202 Accepted		Az adatbázis exportálása folyamatban van. Fejlécek Location: string
Other Status Codes	ErrorResponse	Hibaválaszok: *** 400 MissingImportExportInputParameters – Hiányzó ImportExport bemeneti paraméterek. 400 InvalidImportExportInputParameter – Az importálási/exportálási kérelem érvénytelen bemeneti paraméter miatt meghiúsult. 400 PolybaseImportAuthenticationTypeNotSupported – A hitelesítési típus paramétere nem támogatott a PolybaseImport művelethez. 400 DatabaseExtensionsInvalidOperationMode – Érvénytelen operationMode paraméter az adatbázis-bővítményhez. 400 DatabaseExtensionsInvalidStorageKeyType – A tárkulcs típusának a "StorageAccessKey" paraméternek kell lennie. 400 DatabaseExtensionsMissingStorageUri – A storage URI nem lehet üres. 400 SQLPasswordSpecifiedWithManagedIdentity – administratorLoginPassword nem adható meg, ha az authenticationType managedIdentity. 400 InvalidSqlAuthType – Az ImportExport művelet nem sikerült, mert az SQL-hitelesítés típusa érvénytelen 400 BlobAlreadyExist – Az ImportExport művelet nem sikerült, mert a tárblob már létezik 400 InvalidImportExportOperationResourceLocks – Az importálási/exportálási kérelem érvénytelen a Private Link-erőforrások zárolása miatt. 400 DatabaseInvalidSkuPropertyCombination – A kért termékváltozat tulajdonságai inkonzisztensek. Ellenőrizze, hogy érvényes kombináció van-e megadva. További részletekért lásd a https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability. 400 ImportExportJobError – Az ImportExport művelet meghiúsult. 400 BlockedByOutboundFirewall – A kimenő tűzfalszabályok blokkolták a kérést. 400 InvalidOperationType – Adjon meg érvényes művelettípust. 400 InvalidMaxSizeTierCombination – A megadott szint nem támogatja a megadott adatbázis maximális méretét. 400 InvalidTier – A felhasználó érvénytelen szintet adott meg. 400 CannotUseReservedDatabaseName – Ebben a műveletben nem használható fenntartott adatbázisnév. 400 InvalidImportExportParameter – Az importálási/exportálási kérelem érvénytelen bemeneti paraméter miatt meghiúsult. 400 InvalidSku – A felhasználó érvénytelen termékváltozatot adott meg. 400 InvalidTierSkuCombination – A megadott szint nem támogatja a megadott termékváltozatot. 400 InvalidImportExportStorageCredentials – Az importálási/exportálási művelet érvénytelen tárolási hitelesítő adatok miatt meghiúsult 400 InvalidImportExportStorageAuthType – Az importálási/exportálási művelet érvénytelen tárolási hitelesítési típus miatt meghiúsult 400 InvalidImportExportStorageKeyFormat – Az importálási/exportálási művelet érvénytelen tárkulcsformátum miatt meghiúsult 400 LongImportExportStorageUri – Az importálási/exportálási művelet a hosszú tárterület URI-ja miatt meghiúsult 400 LargeExportDatabaseSize – Az exportálási művelet meghiúsult, mert az adatbázis nagyobb a maximális támogatott méretnél 400 FeatureDisabledOnSelectedEdition – A felhasználó olyan funkciót próbált használni, amely le van tiltva az aktuális adatbázis-kiadásban. 400 Nem támogatottImportExportEdition – Az ImportExport művelet nem sikerült, mert érvénytelen kiadást céloz meg 400 InvalidImportExportStorageURI – Az ImportExport művelet nem sikerült, mert a tárolási URI érvénytelen 404 DatabaseDoesNotExist – A felhasználó olyan adatbázisnevet adott meg, amely nem létezik ezen a kiszolgálópéldányon. 404 ServerNotInSubscription – A megadott kiszolgáló nem létezik a megadott előfizetésben. 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és -előfizetésben. 404 ResourceNotFound – Érvénytelen kérés nem létező erőforrás megadására. 404 ImportExportOperationIdNotFound – Az importálás vagy exportálás műveletazonosítója nem található. 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik. 409 ImportExportOperationInProgress – Folyamatban van egy importálási vagy exportálási művelet az adatbázisban. 409 CannotCancelOperation – A felügyeleti művelet olyan állapotban van, amely nem törölhető. 409 OperationCancelled – A felhasználó megszakította a műveletet. 409 OperationInterrupted – Az erőforráson lévő művelet nem hajtható végre, mert egy másik művelet megszakította ugyanazon az erőforráson. 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések. 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható kérelmek maximálisnál több kérése. 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Próbálkozzon újra a művelettel. 503 TooManyRequests – A rendelkezésre álló erőforrások által feldolgozható maximális kérelmeken túli kérések.

Név

Típus

Leírás

200 OK

ImportExportOperationResult

Sikeresen exportálta az adatbázist.

202 Accepted

Az adatbázis exportálása folyamatban van.

Fejlécek

Location: string

Other Status Codes

ErrorResponse

Hibaválaszok: ***

400 MissingImportExportInputParameters – Hiányzó ImportExport bemeneti paraméterek.
400 InvalidImportExportInputParameter – Az importálási/exportálási kérelem érvénytelen bemeneti paraméter miatt meghiúsult.
400 PolybaseImportAuthenticationTypeNotSupported – A hitelesítési típus paramétere nem támogatott a PolybaseImport művelethez.
400 DatabaseExtensionsInvalidOperationMode – Érvénytelen operationMode paraméter az adatbázis-bővítményhez.
400 DatabaseExtensionsInvalidStorageKeyType – A tárkulcs típusának a "StorageAccessKey" paraméternek kell lennie.
400 DatabaseExtensionsMissingStorageUri – A storage URI nem lehet üres.
400 SQLPasswordSpecifiedWithManagedIdentity – administratorLoginPassword nem adható meg, ha az authenticationType managedIdentity.
400 InvalidSqlAuthType – Az ImportExport művelet nem sikerült, mert az SQL-hitelesítés típusa érvénytelen
400 BlobAlreadyExist – Az ImportExport művelet nem sikerült, mert a tárblob már létezik
400 InvalidImportExportOperationResourceLocks – Az importálási/exportálási kérelem érvénytelen a Private Link-erőforrások zárolása miatt.
400 DatabaseInvalidSkuPropertyCombination – A kért termékváltozat tulajdonságai inkonzisztensek. Ellenőrizze, hogy érvényes kombináció van-e megadva. További részletekért lásd a https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.
400 ImportExportJobError – Az ImportExport művelet meghiúsult.
400 BlockedByOutboundFirewall – A kimenő tűzfalszabályok blokkolták a kérést.
400 InvalidOperationType – Adjon meg érvényes művelettípust.
400 InvalidMaxSizeTierCombination – A megadott szint nem támogatja a megadott adatbázis maximális méretét.
400 InvalidTier – A felhasználó érvénytelen szintet adott meg.
400 CannotUseReservedDatabaseName – Ebben a műveletben nem használható fenntartott adatbázisnév.
400 InvalidImportExportParameter – Az importálási/exportálási kérelem érvénytelen bemeneti paraméter miatt meghiúsult.
400 InvalidSku – A felhasználó érvénytelen termékváltozatot adott meg.
400 InvalidTierSkuCombination – A megadott szint nem támogatja a megadott termékváltozatot.
400 InvalidImportExportStorageCredentials – Az importálási/exportálási művelet érvénytelen tárolási hitelesítő adatok miatt meghiúsult
400 InvalidImportExportStorageAuthType – Az importálási/exportálási művelet érvénytelen tárolási hitelesítési típus miatt meghiúsult
400 InvalidImportExportStorageKeyFormat – Az importálási/exportálási művelet érvénytelen tárkulcsformátum miatt meghiúsult
400 LongImportExportStorageUri – Az importálási/exportálási művelet a hosszú tárterület URI-ja miatt meghiúsult
400 LargeExportDatabaseSize – Az exportálási művelet meghiúsult, mert az adatbázis nagyobb a maximális támogatott méretnél
400 FeatureDisabledOnSelectedEdition – A felhasználó olyan funkciót próbált használni, amely le van tiltva az aktuális adatbázis-kiadásban.
400 Nem támogatottImportExportEdition – Az ImportExport művelet nem sikerült, mert érvénytelen kiadást céloz meg
400 InvalidImportExportStorageURI – Az ImportExport művelet nem sikerült, mert a tárolási URI érvénytelen
404 DatabaseDoesNotExist – A felhasználó olyan adatbázisnevet adott meg, amely nem létezik ezen a kiszolgálópéldányon.
404 ServerNotInSubscription – A megadott kiszolgáló nem létezik a megadott előfizetésben.
404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és -előfizetésben.
404 ResourceNotFound – Érvénytelen kérés nem létező erőforrás megadására.
404 ImportExportOperationIdNotFound – Az importálás vagy exportálás műveletazonosítója nem található.
404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik.
409 ImportExportOperationInProgress – Folyamatban van egy importálási vagy exportálási művelet az adatbázisban.
409 CannotCancelOperation – A felügyeleti művelet olyan állapotban van, amely nem törölhető.
409 OperationCancelled – A felhasználó megszakította a műveletet.
409 OperationInterrupted – Az erőforráson lévő művelet nem hajtható végre, mert egy másik művelet megszakította ugyanazon az erőforráson.
429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.
429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható kérelmek maximálisnál több kérése.
500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Próbálkozzon újra a művelettel.
503 TooManyRequests – A rendelkezésre álló erőforrások által feldolgozható maximális kérelmeken túli kérések.

Példák

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.

Mintakérés

HTTP

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=2023-08-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"
  }
}

Mintaválasz

Állapotkód:: 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"
}

Állapotkód:: 202

Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000

Exports a database.

Mintakérés

HTTP

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=2023-08-01

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

Mintaválasz

Állapotkód:: 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"
}

Állapotkód:: 202

Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000

Meghatározások

Név	Leírás
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
ExportDatabaseDefinition	Az adatbázis-exportálási művelet végrehajtásához szükséges információkat tartalmazza.
ImportExportOperationResult	Egy ImportExport művelet eredményerőforrása.
NetworkIsolationSettings	Azokat az ARM-erőforrásokat tartalmazza, amelyekhez privát végpontkapcsolatot kíván létrehozni.
PrivateEndpointConnectionRequestStatus	A privát végpont kapcsolatkéréseinek állapotát tartalmazza.
StorageKeyType	Tárkulcs típusa.

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Név	Típus	Leírás
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Név	Típus	Leírás
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Tárgy

Hibaválasz

Név	Típus	Leírás
error	ErrorDetail	A hibaobjektum.

ExportDatabaseDefinition

Tárgy

Az adatbázis-exportálási művelet végrehajtásához szükséges információkat tartalmazza.

Név	Típus	Leírás
administratorLogin	string	Rendszergazdai bejelentkezési név.
administratorLoginPassword	string	Rendszergazdai bejelentkezési jelszó.
authenticationType	string	Hitelesítési típus.
networkIsolation	NetworkIsolationSettings	Nem kötelező erőforrás-információk a kérések hálózati elkülönítésének engedélyezéséhez.
storageKey	string	Tárkulcs.
storageKeyType	StorageKeyType	Tárkulcs típusa.
storageUri	string	Storage Uri.

ImportExportOperationResult

Tárgy

Egy ImportExport művelet eredményerőforrása.

Név	Típus	Leírás
id	string	Erőforrás-azonosító.
name	string	Erőforrás neve.
properties.blobUri	string	Blob Uri.
properties.databaseName	string	Adatbázis neve.
properties.errorMessage	string	Hibaüzenet.
properties.lastModifiedTime	string	Utolsó módosítás időpontja.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Lekéri a kéréshez társított privát végpontok állapotát.
properties.queuedTime	string	Várakozási idő.
properties.requestId	string (uuid)	Kérelem azonosítója.
properties.requestType	string	Kérelem típusa.
properties.serverName	string	Kiszolgáló neve.
properties.status	string	Művelet állapota.
type	string	Erőforrás típusa.

NetworkIsolationSettings

Tárgy

Azokat az ARM-erőforrásokat tartalmazza, amelyekhez privát végpontkapcsolatot kíván létrehozni.

Név	Típus	Leírás
sqlServerResourceId	string (arm-id)	Az SQL Server erőforrás-azonosítója, amely a kérés célja. Ha be van állítva, a rendszer privát végpontkapcsolatot hoz létre az SQL Serverhez. Meg kell egyeznie a művelet célkiszolgálójának.
storageAccountResourceId	string (arm-id)	A BACPAC-fájl tárolásához használt tárfiók erőforrás-azonosítója. Ha be van állítva, privát végpontkapcsolat jön létre a tárfiókhoz. Meg kell egyeznie a StorageUri paraméterhez használt tárfióknak.

PrivateEndpointConnectionRequestStatus

Tárgy

A privát végpont kapcsolatkéréseinek állapotát tartalmazza.

Név	Típus	Leírás
privateEndpointConnectionName	string	A privát végpont kapcsolatneve.
privateLinkServiceId	string	Erőforrás-azonosító, amelyhez a privát végpont létrejön.
status	string	Ennek a privát végpontkapcsolatnak az állapota.

StorageKeyType

Felsorolás

Tárkulcs típusa.

Érték	Leírás
SharedAccessKey
StorageAccessKey

Megosztás a következőn keresztül:

Databases - Export

URI paraméterek

Kérő Testület

Válaszok

Példák

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

Mintakérés

Mintaválasz

Exports a database.

Mintakérés

Mintaválasz

Meghatározások

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExportDatabaseDefinition

ImportExportOperationResult

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType