Udostępnij za pośrednictwem


Servers - Import Database

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.

Przykłady

Imports to a new database, using private link for the SQL server and storage account.
Imports to a new database.

Przykładowe żądanie

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"
  }
}

Przykładowa odpowiedź

{
  "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"
}

Imports to a new database.

Przykładowe żądanie

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"
}

Przykładowa odpowiedź

{
  "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"
}

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