Servers - Import Database

Odwołanie

Service:: SQL Database

API Version:: 2021-11-01

Importuje plik bacpac do nowej bazy danych.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Wymagane	Typ	Opis
administratorLogin	True	string	Nazwa logowania administratora.
administratorLoginPassword	True	string	Hasło logowania administratora.
storageKey	True	string	Klucz magazynu.
storageKeyType	True	StorageKeyType	Typ klucza magazynu.
storageUri	True	string	Identyfikator URI magazynu.
authenticationType		string	Typ uwierzytelniania.
databaseName		string	Nazwa importowej bazy danych.
edition		string	Wydanie importowej bazy danych.
maxSizeBytes		string	Maksymalny rozmiar w bajtach dla importowej bazy danych.
networkIsolation		NetworkIsolationSettings	Opcjonalne informacje o zasobach umożliwiające izolację sieci dla żądania.
serviceObjectiveName		string	Nazwa celu poziomu usługi dla importowej bazy danych.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ImportExportOperationResult	Pomyślnie zaimportowaliśmy bazę danych.
202 Accepted		Trwa importowanie bazy danych.
Other Status Codes		Odpowiedzi na błędy: *** 400 MissingImportExportInputParameters — brak parametrów wejściowych ImportExport. 400 InvalidImportExportInputParameter — żądanie importu/eksportu nie powiodło się z powodu nieprawidłowego parametru wejściowego. 400 PolybaseImportAuthenticationTypeNotSupported — parametr typu uwierzytelniania nie jest obsługiwany dla operacji PolybaseImport. 400 DatabaseExtensionsInvalidOperationMode — nieprawidłowy parametr operationMode dla rozszerzenia bazy danych. 400 DatabaseExtensionsInvalidStorageKeyType — typ klucza magazynu musi mieć wartość "StorageAccessKey". 400 DatabaseExtensionsMissingStorageUri — identyfikator URI magazynu nie może być pusty. 400 InvalidSku — użytkownik określił nieprawidłową jednostkę SKU. 400 InvalidTierSkuCombination — określona warstwa nie obsługuje określonej jednostki SKU. 400 DatabaseInvalidSkuPropertyCombination — właściwości żądanej jednostki SKU są niespójne. Sprawdź, czy określono prawidłową kombinację. Zobacz https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability , aby uzyskać więcej informacji. 400 InvalidMaxSizeTierCombination — określona warstwa nie obsługuje określonego maksymalnego rozmiaru bazy danych. 400 FeatureDisabledOnSelectedEdition — użytkownik próbował użyć funkcji wyłączonej w bieżącej wersji bazy danych. 400 InvalidImportExportParameter — żądanie importu/eksportu nie powiodło się z powodu nieprawidłowego parametru wejściowego. 400 InvalidTier — użytkownik określił nieprawidłową warstwę. 400 InvalidOperationType — podaj prawidłowy typ operacji. 400 ImportExportJobError — operacja ImportExport nie powiodła się. 400 BlockedByOutboundFirewall — reguły zapory ruchu wychodzącego zablokowały żądanie. 404 ResourceNotFound — nieprawidłowe żądanie określające nieistniejący zasób. 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji. 404 ImportExportOperationIdNotFound — nie można odnaleźć identyfikatora operacji importowania lub eksportu. 404 ServerNotInSubscription — określony serwer nie istnieje w określonej subskrypcji. 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 409 ImportExportOperationInProgress — trwa operacja importowania lub eksportowania w bazie danych. 409 OperationCancelled — operacja została anulowana przez użytkownika. 409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Nazwa

Typ

Opis

200 OK

ImportExportOperationResult

Pomyślnie zaimportowaliśmy bazę danych.

202 Accepted

Trwa importowanie bazy danych.

Other Status Codes

Odpowiedzi na błędy: ***

400 MissingImportExportInputParameters — brak parametrów wejściowych ImportExport.
400 InvalidImportExportInputParameter — żądanie importu/eksportu nie powiodło się z powodu nieprawidłowego parametru wejściowego.
400 PolybaseImportAuthenticationTypeNotSupported — parametr typu uwierzytelniania nie jest obsługiwany dla operacji PolybaseImport.
400 DatabaseExtensionsInvalidOperationMode — nieprawidłowy parametr operationMode dla rozszerzenia bazy danych.
400 DatabaseExtensionsInvalidStorageKeyType — typ klucza magazynu musi mieć wartość "StorageAccessKey".
400 DatabaseExtensionsMissingStorageUri — identyfikator URI magazynu nie może być pusty.
400 InvalidSku — użytkownik określił nieprawidłową jednostkę SKU.
400 InvalidTierSkuCombination — określona warstwa nie obsługuje określonej jednostki SKU.
400 DatabaseInvalidSkuPropertyCombination — właściwości żądanej jednostki SKU są niespójne. Sprawdź, czy określono prawidłową kombinację. Zobacz https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability , aby uzyskać więcej informacji.
400 InvalidMaxSizeTierCombination — określona warstwa nie obsługuje określonego maksymalnego rozmiaru bazy danych.
400 FeatureDisabledOnSelectedEdition — użytkownik próbował użyć funkcji wyłączonej w bieżącej wersji bazy danych.
400 InvalidImportExportParameter — żądanie importu/eksportu nie powiodło się z powodu nieprawidłowego parametru wejściowego.
400 InvalidTier — użytkownik określił nieprawidłową warstwę.
400 InvalidOperationType — podaj prawidłowy typ operacji.
400 ImportExportJobError — operacja ImportExport nie powiodła się.
400 BlockedByOutboundFirewall — reguły zapory ruchu wychodzącego zablokowały żądanie.
404 ResourceNotFound — nieprawidłowe żądanie określające nieistniejący zasób.
404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.
404 ImportExportOperationIdNotFound — nie można odnaleźć identyfikatora operacji importowania lub eksportu.
404 ServerNotInSubscription — określony serwer nie istnieje w określonej subskrypcji.
404 OperationIdNotFound — operacja o identyfikatorze nie istnieje.
409 ImportExportOperationInProgress — trwa operacja importowania lub eksportowania w bazie danych.
409 OperationCancelled — operacja została anulowana przez użytkownika.
409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie.
429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.
429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby.
500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji.
503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

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

Definicje

Nazwa	Opis
ImportExportOperationResult	Zasób wyniku operacji ImportExport.
ImportNewDatabaseDefinition	Zawiera informacje niezbędne do wykonania operacji importowania dla nowej bazy danych.
NetworkIsolationSettings	Zawiera zasoby usługi ARM, dla których ma zostać utworzone połączenie prywatnego punktu końcowego.
PrivateEndpointConnectionRequestStatus	Zawiera stan żądań połączenia prywatnego punktu końcowego.
StorageKeyType	Typ klucza magazynu.

ImportExportOperationResult

Zasób wyniku operacji ImportExport.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.blobUri	string	Identyfikator URI obiektu blob.
properties.databaseName	string	Nazwa bazy danych.
properties.errorMessage	string	Komunikat o błędzie.
properties.lastModifiedTime	string	Czas ostatniej modyfikacji.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Pobiera stan prywatnych punktów końcowych skojarzonych z tym żądaniem.
properties.queuedTime	string	Czas w kolejce.
properties.requestId	string	Identyfikator żądania.
properties.requestType	string	Typ żądania.
properties.serverName	string	Nazwa serwera.
properties.status	string	Stan operacji.
type	string	Typ zasobu.

ImportNewDatabaseDefinition

Zawiera informacje niezbędne do wykonania operacji importowania dla nowej bazy danych.

Nazwa	Typ	Opis
administratorLogin	string	Nazwa logowania administratora.
administratorLoginPassword	string	Hasło logowania administratora.
authenticationType	string	Typ uwierzytelniania.
databaseName	string	Nazwa importowej bazy danych.
edition	string	Wydanie importowej bazy danych.
maxSizeBytes	string	Maksymalny rozmiar w bajtach dla importowej bazy danych.
networkIsolation	NetworkIsolationSettings	Opcjonalne informacje o zasobach umożliwiające izolację sieci dla żądania.
serviceObjectiveName	string	Nazwa celu poziomu usługi dla importowej bazy danych.
storageKey	string	Klucz magazynu.
storageKeyType	StorageKeyType	Typ klucza magazynu.
storageUri	string	Identyfikator URI magazynu.

NetworkIsolationSettings

Zawiera zasoby usługi ARM, dla których ma zostać utworzone połączenie prywatnego punktu końcowego.

Nazwa	Typ	Opis
sqlServerResourceId	string	Identyfikator zasobu serwera SQL, który jest obiektem docelowym tego żądania. W przypadku ustawienia zostanie utworzone połączenie prywatnego punktu końcowego dla serwera SQL. Musi być zgodny z serwerem docelowym operacji.
storageAccountResourceId	string	Identyfikator zasobu konta magazynu używanego do przechowywania pliku BACPAC. W przypadku ustawienia dla konta magazynu zostanie utworzone połączenie prywatnego punktu końcowego. Musi być zgodne z kontem magazynu używanym dla parametru StorageUri.

PrivateEndpointConnectionRequestStatus

Zawiera stan żądań połączenia prywatnego punktu końcowego.

Nazwa	Typ	Opis
privateEndpointConnectionName	string	Nazwa połączenia prywatnego punktu końcowego.
privateLinkServiceId	string	Identyfikator zasobu, dla którego jest tworzony prywatny punkt końcowy.
status	string	Stan tego połączenia prywatnego punktu końcowego.

StorageKeyType

Typ klucza magazynu.

Nazwa	Typ	Opis
SharedAccessKey	string
StorageAccessKey	string

Servers - Import Database

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Przykłady

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

Definicje

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Dodatkowe zasoby