Servers - Import Database

Служба:

SQL Database

Версия API:

2023-08-01

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

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string	Имя группы ресурсов, содержащей ресурс. Это значение можно получить из API Azure Resource Manager или портала.
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	Тип проверки подлинности.
databaseName		string	Имя базы данных импорта.
edition		string	Выпуск базы данных импорта.
maxSizeBytes		string	Максимальный размер в байтах для базы данных импорта.
networkIsolation		NetworkIsolationSettings	Необязательные сведения о ресурсах для включения сетевой изоляции для запроса.
serviceObjectiveName		string	Имя целевой цели уровня обслуживания базы данных импорта.

Ответы

Имя	Тип	Описание
200 OK	ImportExportOperationResult	Успешно импортирована база данных.
202 Accepted		Импорт базы данных выполняется. Заголовки Location: string
Other Status Codes	ErrorResponse	Ответы на ошибки: *** 400 MissingImportExportInputParameters — отсутствующие входные параметры ImportExport. 400 InvalidImportExportInputParameter— запрос на импорт и экспорт завершился ошибкой из-за недопустимого входного параметра. 400 PolybaseImportAuthenticationTypeNotSupported. Параметр типа проверки подлинности не поддерживает операцию PolybaseImport. 400 DatabaseExtensionsInvalidOperationMode — недопустимый параметр operationMode для расширения базы данных. 400 DatabaseExtensionsInvalidStorageKeyType — тип ключа хранилища должен быть от "StorageAccessKey". 400 DatabaseExtensionsMissingStorageUri — URI хранилища не может быть пустым. 400 SQLPasswordSpecifiedWithManagedIdentity — administratorLoginPassword не следует указывать, если authenticationType является ManagedIdentity. 400 InvalidSqlAuthType — операция ImportExport завершилась ошибкой, так как тип проверки подлинности SQL недопустим 400 BLOBAlreadyExist — операция ImportExport завершилась сбоем, так как большой двоичный объект хранилища уже существует 400 InvalidImportExportOperationResourceLocks — недопустимый запрос импорта и экспорта из-за блокировки ресурсов приватного канала. 400 DatabaseInvalidSkuPropertyCombination — свойства запрошенного номера SKU несогласованы. Убедитесь, что указана допустимая комбинация. Дополнительные сведения см. в https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability. 400 ImportExportJobError — операция ImportExport завершилась ошибкой. 400 BlockedByOutboundFirewall — правила исходящего брандмауэра блокировали запрос. 400 InvalidOperationType — укажите допустимый тип операции. 400 InvalidMaxSizeTierCombination — указанный уровень не поддерживает указанный максимальный размер базы данных. 400 InvalidTier — пользователь указал недопустимый уровень. 400 CannotUseReservedDatabaseName— не удается использовать зарезервированное имя базы данных в этой операции. 400 InvalidImportExportParameter — сбой запроса импорта и экспорта из-за недопустимого входного параметра. 400 InvalidSku — пользователь указал недопустимый номер SKU. 400 InvalidTierSkuCombination — указанный уровень не поддерживает указанный номер SKU. 400 InvalidImportExportStorageCredentials — сбой операции импорта и экспорта из-за недопустимых учетных данных хранения 400 InvalidImportExportStorageAuthType — сбой операции импорта и экспорта из-за недопустимого типа проверки подлинности хранилища 400 InvalidImportExportStorageKeyFormat — сбой операции импорта и экспорта из-за недопустимого формата ключа хранилища 400 LongImportExportStorageUri — операция импорта и экспорта завершилась ошибкой из-за длительного URI хранилища 400 LargeExportDatabaseSize — сбой операции экспорта, так как база данных превышает максимальный поддерживаемый размер 400 FeatureDisabledOnSelectedEdition — пользователь попытался использовать функцию, которая отключена в текущем выпуске базы данных. 400 UnSupportedImportExportEdition — операция ImportExport завершилась ошибкой, так как она предназначена для недопустимого выпуска 400 InvalidImportExportStorageURI — операция ImportExport завершилась ошибкой, так как URI хранилища недопустим 404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует на этом экземпляре сервера. 404 ServerNotInSubscription — указанный сервер не существует в указанной подписке. 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 ResourceNotFound — недопустимый запрос, указывающий несуществующий ресурс. 404 ImportExportOperationIdNotFound — не удается найти идентификатор операции импорта или экспорта. 404 OperationIdNotFound — операция с идентификатором не существует. 409 ImportExportOperationInProgresss — выполняется операция импорта или экспорта в базе данных. 409 CannotCancelOperation — операция управления находится в состоянии, которое не может быть отменено. 409 OperationCancelled — операция отменена пользователем. 409 Operation Прервана — операция с ресурсом не удалось завершить, так как она была прервана другой операцией в том же ресурсе. 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 500 OperationTimedOut — время ожидания операции истекло и автоматически откатился. Повторите операцию. 503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.

Примеры

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.

Образец запроса

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2023-08-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"
  }
}

Пример ответа

Код состояния:

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

Код состояния:

202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Imports to a new database.

Образец запроса

HTTP

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

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

Пример ответа

Код состояния:

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

Код состояния:

202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Определения

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

ErrorAdditionalInfo

Object

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Object

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Object

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

ImportExportOperationResult

Object

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

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

ImportNewDatabaseDefinition

Object

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

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

NetworkIsolationSettings

Object

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

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

PrivateEndpointConnectionRequestStatus

Object

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

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

StorageKeyType

Перечисление

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

Значение	Описание
SharedAccessKey
StorageAccessKey