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=2022-02-01-preview

Parametry identyfikatora URI

Name In Required Type Description
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

Name Required Type Description
administratorLogin True
  • string

Nazwa logowania administratora.

administratorLoginPassword True
  • string

Hasło logowania administratora.

storageKey True
  • string

Klucz magazynu.

storageKeyType True

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

Opcjonalne informacje o zasobach umożliwiające izolację sieci dla żądania.

serviceObjectiveName
  • string

Nazwa celu poziomu usługi dla importowej bazy danych.

Odpowiedzi

Name Type Description
200 OK

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.

  • 409 ImportExportOperationInProgress — trwa operacja importowania lub eksportowania w bazie danych.

Przykłady

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

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2022-02-01-preview

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

Sample Response

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

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2022-02-01-preview

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

Sample Response

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

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.

Name Type Description
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

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.

Name Type Description
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

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

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.

Name Type Description
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.

Name Type Description
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.

Name Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string