Databases - Import

Ссылка

Service:: SQL Database

API Version:: 2021-08-01-preview

Импорт bacpac в новую базу данных.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
databaseName	path	True	string	Имя базы данных.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
serverName	path	True	string	Имя сервера.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.

Текст запроса

Имя	Обязательно	Тип	Описание
administratorLogin	True	string	Имя входа администратора.
administratorLoginPassword	True	string	Пароль для входа администратора.
storageKey	True	string	Ключ хранилища.
storageKeyType	True	StorageKeyType	Тип ключа хранилища.
storageUri	True	string	URI хранилища.
authenticationType		string	Тип проверки подлинности.
networkIsolation		NetworkIsolationSettings	Необязательные сведения о ресурсе для включения сетевой изоляции для запроса.

Ответы

Имя	Тип	Описание
200 OK	ImportExportOperationResult	База данных успешно импортирована.
202 Accepted		Выполняется импорт базы данных.
Other Status Codes		Ответы на ошибки: *** 400 MissingImportExportInputParameters — отсутствуют входные параметры ImportExport. 400 InvalidImportExportInputParameter — сбой запроса на импорт и экспорт из-за недопустимого входного параметра. 400 PolybaseImportAuthenticationTypeNotSupported — параметр типа проверки подлинности не поддерживается для операции PolybaseImport. 400 DatabaseExtensionsInvalidOperationMode — недопустимый параметр operationMode для расширения базы данных. 400 DatabaseExtensionsInvalidStorageKeyType — тип ключа хранилища должен иметь значение StorageAccessKey. 400 DatabaseExtensionsMissingStorageUri — URI хранилища не может быть пустым. 400 InvalidMaxSizeTierCombination — указанный уровень не поддерживает указанный максимальный размер базы данных. 400 FeatureDisabledOnSelectedEdition — пользователь попытался использовать функцию, которая отключена в текущем выпуске базы данных. 400 InvalidOperationType — укажите допустимый тип операции. 400 ImportExportJobError — сбой операции ImportExport. 400 BlockedByOutboundFirewall — правила брандмауэра для исходящего трафика заблокировали запрос. 404 ResourceNotFound — недопустимый запрос, указывающий несуществующий ресурс. 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 ImportExportOperationIdNotFound — не удается найти идентификатор операции импорта или экспорта. 404 ServerNotInSubscription — указанный сервер не существует в указанной подписке. 409 ImportExportOperationInProgress — в базе данных выполняется операция импорта или экспорта.

Имя

Тип

Описание

200 OK

ImportExportOperationResult

База данных успешно импортирована.

202 Accepted

Выполняется импорт базы данных.

Other Status Codes

Ответы на ошибки: ***

400 MissingImportExportInputParameters — отсутствуют входные параметры ImportExport.
400 InvalidImportExportInputParameter — сбой запроса на импорт и экспорт из-за недопустимого входного параметра.
400 PolybaseImportAuthenticationTypeNotSupported — параметр типа проверки подлинности не поддерживается для операции PolybaseImport.
400 DatabaseExtensionsInvalidOperationMode — недопустимый параметр operationMode для расширения базы данных.
400 DatabaseExtensionsInvalidStorageKeyType — тип ключа хранилища должен иметь значение StorageAccessKey.
400 DatabaseExtensionsMissingStorageUri — URI хранилища не может быть пустым.
400 InvalidMaxSizeTierCombination — указанный уровень не поддерживает указанный максимальный размер базы данных.
400 FeatureDisabledOnSelectedEdition — пользователь попытался использовать функцию, которая отключена в текущем выпуске базы данных.
400 InvalidOperationType — укажите допустимый тип операции.
400 ImportExportJobError — сбой операции ImportExport.
400 BlockedByOutboundFirewall — правила брандмауэра для исходящего трафика заблокировали запрос.
404 ResourceNotFound — недопустимый запрос, указывающий несуществующий ресурс.
404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.
404 ImportExportOperationIdNotFound — не удается найти идентификатор операции импорта или экспорта.
404 ServerNotInSubscription — указанный сервер не существует в указанной подписке.
409 ImportExportOperationInProgress — в базе данных выполняется операция импорта или экспорта.

Примеры

Imports to an existing empty database, using private link to communicate with SQL server and storage account.

Imports to an existing empty database.

Imports to an existing empty database, using private link to communicate with SQL server and storage account.

Sample Request

HTTP

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

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

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 an existing empty database.

Sample Request

HTTP

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

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

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

Определения

Имя	Описание
ImportExistingDatabaseDefinition	Содержит сведения, необходимые для выполнения операции импорта для существующей базы данных.
ImportExportOperationResult	Ресурс результата операции ImportExport.
NetworkIsolationSettings	Содержит ресурсы ARM, для которых необходимо создать подключение к частной конечной точке.
PrivateEndpointConnectionRequestStatus	Содержит состояние запросов на подключение к частной конечной точке.
StorageKeyType	Тип ключа хранилища.

ImportExistingDatabaseDefinition

Содержит сведения, необходимые для выполнения операции импорта для существующей базы данных.

Имя	Тип	Описание
administratorLogin	string	Имя входа администратора.
administratorLoginPassword	string	Пароль для входа администратора.
authenticationType	string	Тип проверки подлинности.
networkIsolation	NetworkIsolationSettings	Необязательные сведения о ресурсе для включения сетевой изоляции для запроса.
storageKey	string	Ключ хранилища.
storageKeyType	StorageKeyType	Тип ключа хранилища.
storageUri	string	URI хранилища.

ImportExportOperationResult

Ресурс результата операции ImportExport.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.blobUri	string	URI большого двоичного объекта.
properties.databaseName	string	имя базы данных.
properties.errorMessage	string	Сообщение об ошибке.
properties.lastModifiedTime	string	Время последнего изменения.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Возвращает состояние частных конечных точек, связанных с этим запросом.
properties.queuedTime	string	Время постановки в очередь.
properties.requestId	string	Идентификатор запроса.
properties.requestType	string	Тип запроса.
properties.serverName	string	Имя сервера.
properties.status	string	Состояние операции.
type	string	Тип ресурса.

NetworkIsolationSettings

Содержит ресурсы ARM, для которых необходимо создать подключение к частной конечной точке.

Имя	Тип	Описание
sqlServerResourceId	string	Идентификатор ресурса для сервера SQL Server, который является целевым объектом этого запроса. Если этот параметр задан, для сервера SQL Server будет создано подключение к частной конечной точке. Должен соответствовать серверу, который является целевым объектом операции.
storageAccountResourceId	string	Идентификатор ресурса для учетной записи хранения, используемой для хранения BACPAC-файла. Если этот параметр задан, для учетной записи хранения будет создано подключение к частной конечной точке. Должен соответствовать учетной записи хранения, используемой для параметра StorageUri.

PrivateEndpointConnectionRequestStatus

Содержит состояние запросов на подключение к частной конечной точке.

Имя	Тип	Описание
privateEndpointConnectionName	string	Имя подключения для частной конечной точки.
privateLinkServiceId	string	Идентификатор ресурса, для которого создается частная конечная точка.
status	string	Состояние подключения к частной конечной точке.

StorageKeyType

Тип ключа хранилища.

Имя	Тип	Описание
SharedAccessKey	string
StorageAccessKey	string

Databases - Import

Параметры URI

Текст запроса

Ответы

Примеры

Imports to an existing empty database, using private link to communicate with SQL server and storage account.

Sample Request

Sample Response

Imports to an existing empty database.

Sample Request

Sample Response

Определения

ImportExistingDatabaseDefinition

ImportExportOperationResult

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Дополнительные ресурсы