Databases - Import

Ссылка

Service:: SQL Database

API Version:: 2021-11-01

Импортирует BACPAC-файл в новую базу данных.

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

Параметры 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 InvalidSku — пользователь указал недопустимый номер SKU. 400 InvalidTierSkuCombination — указанный уровень не поддерживает указанный номер SKU. 400 DatabaseInvalidSkuPropertyCombination — свойства запрошенного номера SKU несогласованы. Пожалуйста, проверка, что указано допустимое сочетание. Дополнительные сведения см. в статье https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability. 400 InvalidMaxSizeTierCombination — указанный уровень не поддерживает указанный максимальный размер базы данных. 400 FeatureDisabledOnSelectedEdition — пользователь попытался использовать функцию, которая отключена в текущем выпуске базы данных. 400 InvalidImportExportParameter — сбой запроса импорта и экспорта из-за недопустимого входного параметра. 400 InvalidTier — пользователь указал недопустимый уровень. 400 InvalidOperationType — укажите допустимый тип операции. 400 ImportExportJobError — сбой операции ImportExport. 400 BlockedByOutboundFirewall — правила брандмауэра для исходящего трафика заблокировали запрос. 404 ResourceNotFound — недопустимый запрос, указывающий несуществующий ресурс. 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 ImportExportOperationIdNotFound — не удается найти идентификатор операции для импорта или экспорта. 404 ServerNotInSubscription — указанный сервер не существует в указанной подписке. 404 OperationIdNotFound — операция с идентификатором не существует. 409 ImportExportOperationInProgress — в базе данных выполняется операция импорта или экспорта. 409 OperationCancelled — операция была отменена пользователем. 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом. 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 500 OperationTimedOut — время ожидания операции истекло и автоматически откатывается. Повторите операцию. 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами.

Имя

Тип

Описание

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 InvalidSku — пользователь указал недопустимый номер SKU.
400 InvalidTierSkuCombination — указанный уровень не поддерживает указанный номер SKU.
400 DatabaseInvalidSkuPropertyCombination — свойства запрошенного номера SKU несогласованы. Пожалуйста, проверка, что указано допустимое сочетание. Дополнительные сведения см. в статье https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.
400 InvalidMaxSizeTierCombination — указанный уровень не поддерживает указанный максимальный размер базы данных.
400 FeatureDisabledOnSelectedEdition — пользователь попытался использовать функцию, которая отключена в текущем выпуске базы данных.
400 InvalidImportExportParameter — сбой запроса импорта и экспорта из-за недопустимого входного параметра.
400 InvalidTier — пользователь указал недопустимый уровень.
400 InvalidOperationType — укажите допустимый тип операции.
400 ImportExportJobError — сбой операции ImportExport.
400 BlockedByOutboundFirewall — правила брандмауэра для исходящего трафика заблокировали запрос.
404 ResourceNotFound — недопустимый запрос, указывающий несуществующий ресурс.
404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.
404 ImportExportOperationIdNotFound — не удается найти идентификатор операции для импорта или экспорта.
404 ServerNotInSubscription — указанный сервер не существует в указанной подписке.
404 OperationIdNotFound — операция с идентификатором не существует.
409 ImportExportOperationInProgress — в базе данных выполняется операция импорта или экспорта.
409 OperationCancelled — операция была отменена пользователем.
409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом.
429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами.
429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами.
500 OperationTimedOut — время ожидания операции истекло и автоматически откатывается. Повторите операцию.
503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами.

Примеры

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.

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-11-01

{
  "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.ImportExistingDatabaseDefinition;
import com.azure.resourcemanager.sql.models.NetworkIsolationSettings;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/** Samples for Databases ImportMethod. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportDatabaseWithNetworkIsolation.
     * json
     */
    /**
     * Sample code: Imports to an existing empty database, using private link to communicate with SQL server and storage
     * account.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToAnExistingEmptyDatabaseUsingPrivateLinkToCommunicateWithSQLServerAndStorageAccount(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases()
            .importMethod("Default-SQL-SouthEastAsia", "testsvr", "testdb", new ImportExistingDatabaseDefinition()
                .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 an existing empty 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/databases/testdb/import?api-version=2021-11-01

{
  "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.ImportExistingDatabaseDefinition;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/** Samples for Databases ImportMethod. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportDatabase.json
     */
    /**
     * Sample code: Imports to an existing empty database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToAnExistingEmptyDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases().importMethod("Default-SQL-SouthEastAsia", "testsvr",
            "testdb",
            new ImportExistingDatabaseDefinition().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

Определения

Имя	Описание
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

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