Servers - Import Database

Ссылка

Служба:: SQL Database

Версия API:: 2021-11-01

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

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

Параметры URI

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

Ответы

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

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


import com.azure.resourcemanager.sql.models.ImportNewDatabaseDefinition;
import com.azure.resourcemanager.sql.models.NetworkIsolationSettings;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/**
 * Samples for Servers ImportDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportNewDatabaseWithNetworkIsolation
     * .json
     */
    /**
     * Sample code: Imports to a new database, using private link for the SQL server and storage account.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToANewDatabaseUsingPrivateLinkForTheSQLServerAndStorageAccount(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().importDatabase("Default-SQL-SouthEastAsia", "testsvr",
            new ImportNewDatabaseDefinition().withDatabaseName("testdb")
                .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")),
            com.azure.core.util.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

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

Код состояния:: 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

Imports to a new database.

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

HTTP
Java

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


import com.azure.resourcemanager.sql.models.ImportNewDatabaseDefinition;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/**
 * Samples for Servers ImportDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportNewDatabase.json
     */
    /**
     * Sample code: Imports to a new database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToANewDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().importDatabase("Default-SQL-SouthEastAsia", "testsvr",
            new ImportNewDatabaseDefinition().withDatabaseName("testdb")
                .withStorageKeyType(StorageKeyType.STORAGE_ACCESS_KEY).withStorageKey("fakeTokenPlaceholder")
                .withStorageUri("https://test.blob.core.windows.net/test.bacpac").withAdministratorLogin("login")
                .withAdministratorLoginPassword("fakeTokenPlaceholder").withAuthenticationType("Sql"),
            com.azure.core.util.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

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

Код состояния:: 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

Определения

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

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	Тип ресурса.

ImportNewDatabaseDefinition

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

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

NetworkIsolationSettings

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

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

PrivateEndpointConnectionRequestStatus

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

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

StorageKeyType

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

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

Поделиться через

Servers - Import Database

Параметры URI

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

Ответы

Примеры

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

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

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

Imports to a new database.

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

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

Определения

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

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