Servers - Import Database

Referencia

Service:: SQL Database

API Version:: 2021-11-01

Bacpac importálása új adatbázisba.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
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álandó API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
administratorLogin	True	string	Rendszergazdai bejelentkezési név.
administratorLoginPassword	True	string	Rendszergazdai bejelentkezési jelszó.
storageKey	True	string	Tárkulcs.
storageKeyType	True	StorageKeyType	Tárolókulcs típusa.
storageUri	True	string	Tároló URI-ja.
authenticationType		string	Hitelesítési típus.
databaseName		string	Az importálási adatbázis neve.
edition		string	Az importálási adatbázis kiadása.
maxSizeBytes		string	Az importálási adatbázis maximális mérete bájtban.
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.
serviceObjectiveName		string	Az importálási adatbázis szolgáltatásiszint-célkitűzésének neve.

Válaszok

Name	Típus	Description
200 OK	ImportExportOperationResult	Az adatbázis importálása sikerült.
202 Accepted		Az adatbázis importálása folyamatban van.
Other Status Codes		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át a "StorageAccessKey" értéknek kell megadnia. 400 DatabaseExtensionsMissingStorageUri – A storage URI nem lehet üres. 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 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 https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability : . 400 InvalidMaxSizeTierCombination – A megadott szint nem támogatja a megadott adatbázis maximális méretét. 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 InvalidImportExportParameter – Az importálási/exportálási kérelem érvénytelen bemeneti paraméter miatt meghiúsult. 400 InvalidTier – A felhasználó érvénytelen szintet adott meg. 400 InvalidOperationType – Adjon meg érvényes művelettípust. 400 ImportExportJobError – Az ImportExport művelet sikertelen volt. 400 BlockedByOutboundFirewall – A kimenő tűzfalszabályok blokkolták a kérést. 404 ResourceNotFound – Érvénytelen kérés, amely nem létező erőforrást ad meg. 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben. 404 ImportExportOperationIdNotFound – Az importálás vagy exportálás műveletazonosítója nem található. 404 ServerNotInSubscription – A megadott kiszolgáló nem létezik a megadott előfizetésben. 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 OperationCancelled – A felhasználó megszakította a műveletet. 409 OperationInterrupted – Az erőforráson végzett 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ó maximális kéréseken túli kérések. 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Please retry the operation. 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

Name

Típus

Description

200 OK

ImportExportOperationResult

Az adatbázis importálása sikerült.

202 Accepted

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

Other Status Codes

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át a "StorageAccessKey" értéknek kell megadnia.
400 DatabaseExtensionsMissingStorageUri – A storage URI nem lehet üres.
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 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 https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability : .
400 InvalidMaxSizeTierCombination – A megadott szint nem támogatja a megadott adatbázis maximális méretét.
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 InvalidImportExportParameter – Az importálási/exportálási kérelem érvénytelen bemeneti paraméter miatt meghiúsult.
400 InvalidTier – A felhasználó érvénytelen szintet adott meg.
400 InvalidOperationType – Adjon meg érvényes művelettípust.
400 ImportExportJobError – Az ImportExport művelet sikertelen volt.
400 BlockedByOutboundFirewall – A kimenő tűzfalszabályok blokkolták a kérést.
404 ResourceNotFound – Érvénytelen kérés, amely nem létező erőforrást ad meg.
404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben.
404 ImportExportOperationIdNotFound – Az importálás vagy exportálás műveletazonosítója nem található.
404 ServerNotInSubscription – A megadott kiszolgáló nem létezik a megadott előfizetésben.
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 OperationCancelled – A felhasználó megszakította a műveletet.
409 OperationInterrupted – Az erőforráson végzett 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ó maximális kéréseken túli kérések.
500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Please retry the operation.
503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

Példák

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

Definíciók

Name	Description
ImportExportOperationResult	Egy ImportExport művelet eredményerőforrása.
ImportNewDatabaseDefinition	Az új adatbázis importálási műveletének végrehajtásához szükséges információkat tartalmazza.
NetworkIsolationSettings	Azokat az ARM-erőforrásokat tartalmazza, amelyekhez privát végponti kapcsolatot kíván létrehozni.
PrivateEndpointConnectionRequestStatus	A privát végpont kapcsolatkéréseinek állapotát tartalmazza.
StorageKeyType	Tárolókulcs típusa.

ImportExportOperationResult

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

Name	Típus	Description
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	Kérelem azonosítója.
properties.requestType	string	Kérelem típusa.
properties.serverName	string	Kiszolgálónév.
properties.status	string	Művelet állapota.
type	string	Erőforrástípus.

ImportNewDatabaseDefinition

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

Name	Típus	Description
administratorLogin	string	Rendszergazdai bejelentkezési név.
administratorLoginPassword	string	Rendszergazdai bejelentkezési jelszó.
authenticationType	string	Hitelesítési típus.
databaseName	string	Az importálási adatbázis neve.
edition	string	Az importálási adatbázis kiadása.
maxSizeBytes	string	Az importálási adatbázis maximális mérete bájtban.
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.
serviceObjectiveName	string	Az importálási adatbázis szolgáltatásiszint-célkitűzésének neve.
storageKey	string	Tárkulcs.
storageKeyType	StorageKeyType	Tárolókulcs típusa.
storageUri	string	Tároló URI-ja.

NetworkIsolationSettings

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

Name	Típus	Description
sqlServerResourceId	string	A kérés célhelyeként szolgáló SQL-kiszolgáló erőforrás-azonosítója. Ha be van állítva, a rendszer privát végponti kapcsolatot hoz létre az SQL Server számára. Meg kell egyeznie a művelet célkiszolgálójának.
storageAccountResourceId	string	A BACPAC-fájl tárolásához használt tárfiók erőforrás-azonosítója. Ha be van állítva, a rendszer privát végponti kapcsolatot hoz létre a tárfiókhoz. Meg kell egyeznie a StorageUri paraméterhez használt tárfióknak.

PrivateEndpointConnectionRequestStatus

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

Name	Típus	Description
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	A privát végponti kapcsolat állapota.

StorageKeyType

Tárolókulcs típusa.

Name	Típus	Description
SharedAccessKey	string
StorageAccessKey	string

Servers - Import Database

URI-paraméterek

Kérelem törzse

Válaszok

Példák

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

Definíciók

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

További források