Servers - Import Database

Reference

Service:: SQL Database

API Version:: 2021-11-01

Importuje soubor bacpac do nové databáze.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Vyžadováno	Typ	Description
administratorLogin	True	string	Přihlašovací jméno správce.
administratorLoginPassword	True	string	Přihlašovací heslo správce.
storageKey	True	string	Klíč úložiště.
storageKeyType	True	StorageKeyType	Typ klíče úložiště.
storageUri	True	string	Identifikátor URI úložiště.
authenticationType		string	Typ ověřování.
databaseName		string	Název importní databáze.
edition		string	Edice importované databáze.
maxSizeBytes		string	Maximální velikost databáze importu v bajtech
networkIsolation		NetworkIsolationSettings	Volitelné informace o prostředcích pro povolení izolace sítě pro požadavek
serviceObjectiveName		string	Název cíle na úrovni služby databáze importu.

Odpovědi

Name	Typ	Description
200 OK	ImportExportOperationResult	Databáze se úspěšně naimportuje.
202 Accepted		Probíhá import databáze.
Other Status Codes		Chybové odpovědi: *** 400 MissingImportExportInputParameters – chybějící vstupní parametry ImportExport. 400 InvalidImportExportInputParameter – požadavek na import/export selhal kvůli neplatnému vstupnímu parametru. 400 PolybaseImportAuthenticationTypeNotSupported – parametr typu ověřování není pro operaci PolybaseImport podporován. 400 DatabaseExtensionsInvalidOperationMode – neplatný parametr operationMode pro rozšíření databáze. 400 DatabaseExtensionsInvalidStorageKeyType – typ klíče úložiště musí obsahovat StorageAccessKey. 400 DatabaseExtensionsMissingStorageUri – identifikátor URI úložiště nemůže být prázdný. 400 InvalidSku – uživatel zadal neplatnou skladovou položku. 400 InvalidTierSkuCombination – zadaná úroveň nepodporuje zadanou skladovou položku. 400 DatabaseInvalidSkuPropertyCombination – vlastnosti požadované skladové položky jsou nekonzistentní. Zkontrolujte, zda je zadána platná kombinace. Další podrobnosti najdete https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability v tématu. 400 InvalidMaxSizeTierCombination – zadaná úroveň nepodporuje zadanou maximální velikost databáze. 400 FeatureDisabledOnSelectedEdition – uživatel se pokusil použít funkci, která je v aktuální edici databáze zakázaná. 400 InvalidImportExportParameter – Požadavek importu/exportu selhal kvůli neplatnému vstupnímu parametru. 400 InvalidTier – uživatel zadal neplatnou úroveň. 400 InvalidOperationType – zadejte platný typ operace. 400 ImportExportJobError – operace ImportExport selhala. 400 BlockedByOutboundFirewall – odchozí pravidla brány firewall zablokovala požadavek. 404 ResourceNotFound – neplatný požadavek určující neexistující prostředek. 404 ServerNotInSubscriptionResourceGroup – zadaný server neexistuje v zadané skupině prostředků a předplatném. 404 ImportExportOperationIdNotFound – ID operace pro import nebo export nelze najít. 404 ServerNotInSubscription – zadaný server v zadaném předplatném neexistuje. 404 OperationIdNotFound – operace s ID neexistuje. 409 ImportExportOperationInProgress – v databázi probíhá operace importu nebo exportu. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Name

Typ

Description

200 OK

ImportExportOperationResult

Databáze se úspěšně naimportuje.

202 Accepted

Probíhá import databáze.

Other Status Codes

Chybové odpovědi: ***

400 MissingImportExportInputParameters – chybějící vstupní parametry ImportExport.
400 InvalidImportExportInputParameter – požadavek na import/export selhal kvůli neplatnému vstupnímu parametru.
400 PolybaseImportAuthenticationTypeNotSupported – parametr typu ověřování není pro operaci PolybaseImport podporován.
400 DatabaseExtensionsInvalidOperationMode – neplatný parametr operationMode pro rozšíření databáze.
400 DatabaseExtensionsInvalidStorageKeyType – typ klíče úložiště musí obsahovat StorageAccessKey.
400 DatabaseExtensionsMissingStorageUri – identifikátor URI úložiště nemůže být prázdný.
400 InvalidSku – uživatel zadal neplatnou skladovou položku.
400 InvalidTierSkuCombination – zadaná úroveň nepodporuje zadanou skladovou položku.
400 DatabaseInvalidSkuPropertyCombination – vlastnosti požadované skladové položky jsou nekonzistentní. Zkontrolujte, zda je zadána platná kombinace. Další podrobnosti najdete https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability v tématu.
400 InvalidMaxSizeTierCombination – zadaná úroveň nepodporuje zadanou maximální velikost databáze.
400 FeatureDisabledOnSelectedEdition – uživatel se pokusil použít funkci, která je v aktuální edici databáze zakázaná.
400 InvalidImportExportParameter – Požadavek importu/exportu selhal kvůli neplatnému vstupnímu parametru.
400 InvalidTier – uživatel zadal neplatnou úroveň.
400 InvalidOperationType – zadejte platný typ operace.
400 ImportExportJobError – operace ImportExport selhala.
400 BlockedByOutboundFirewall – odchozí pravidla brány firewall zablokovala požadavek.
404 ResourceNotFound – neplatný požadavek určující neexistující prostředek.
404 ServerNotInSubscriptionResourceGroup – zadaný server neexistuje v zadané skupině prostředků a předplatném.
404 ImportExportOperationIdNotFound – ID operace pro import nebo export nelze najít.
404 ServerNotInSubscription – zadaný server v zadaném předplatném neexistuje.
404 OperationIdNotFound – operace s ID neexistuje.
409 ImportExportOperationInProgress – v databázi probíhá operace importu nebo exportu.
409 OperationCancelled – operace byla zrušena uživatelem.
409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem.
429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.
429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.
500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci.
503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

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

Definice

Name	Description
ImportExportOperationResult	Prostředek výsledku operace ImportExport.
ImportNewDatabaseDefinition	Obsahuje informace potřebné k provedení operace importu nové databáze.
NetworkIsolationSettings	Obsahuje prostředky ARM, pro které se má vytvořit připojení privátního koncového bodu.
PrivateEndpointConnectionRequestStatus	Obsahuje stav požadavků na připojení privátního koncového bodu.
StorageKeyType	Typ klíče úložiště.

ImportExportOperationResult

Prostředek výsledku operace ImportExport.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.blobUri	string	Identifikátor URI objektu blob.
properties.databaseName	string	Název databáze.
properties.errorMessage	string	Chybová zpráva.
properties.lastModifiedTime	string	Čas poslední změny.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Získá stav privátních koncových bodů přidružených k tomuto požadavku.
properties.queuedTime	string	Čas ve frontě.
properties.requestId	string	ID požadavku.
properties.requestType	string	Typ požadavku.
properties.serverName	string	Název serveru
properties.status	string	Stav operace.
type	string	Typ prostředku.

ImportNewDatabaseDefinition

Obsahuje informace potřebné k provedení operace importu nové databáze.

Name	Typ	Description
administratorLogin	string	Přihlašovací jméno správce.
administratorLoginPassword	string	Přihlašovací heslo správce.
authenticationType	string	Typ ověřování.
databaseName	string	Název importní databáze.
edition	string	Edice importované databáze.
maxSizeBytes	string	Maximální velikost databáze importu v bajtech
networkIsolation	NetworkIsolationSettings	Volitelné informace o prostředcích pro povolení izolace sítě pro požadavek
serviceObjectiveName	string	Název cíle na úrovni služby databáze importu.
storageKey	string	Klíč úložiště.
storageKeyType	StorageKeyType	Typ klíče úložiště.
storageUri	string	Identifikátor URI úložiště.

NetworkIsolationSettings

Obsahuje prostředky ARM, pro které se má vytvořit připojení privátního koncového bodu.

Name	Typ	Description
sqlServerResourceId	string	ID prostředku pro SQL Server, který je cílem tohoto požadavku. Pokud je tato možnost nastavená, vytvoří se pro SQL Server připojení privátního koncového bodu. Musí odpovídat serveru, který je cílem operace.
storageAccountResourceId	string	ID prostředku pro účet úložiště, který se používá k uložení souboru BACPAC. Pokud je tato možnost nastavená, vytvoří se pro účet úložiště připojení privátního koncového bodu. Musí odpovídat účtu úložiště použitému pro parametr StorageUri.

PrivateEndpointConnectionRequestStatus

Obsahuje stav požadavků na připojení privátního koncového bodu.

Name	Typ	Description
privateEndpointConnectionName	string	Název připojení pro privátní koncový bod.
privateLinkServiceId	string	ID prostředku, pro který se vytvoří privátní koncový bod.
status	string	Stav tohoto připojení privátního koncového bodu

StorageKeyType

Typ klíče úložiště.

Name	Typ	Description
SharedAccessKey	string
StorageAccessKey	string

Servers - Import Database

Parametry identifikátoru URI

Text požadavku

Odpovědi

Příklady

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

Definice

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Další materiály