你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Databases - Import

参考

服务:: SQL Database

API 版本:: 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	包含该资源的资源组名称。可以从 Azure 资源管理器 API 或门户获取此值。
serverName	path	True	string	服务器的名称。
subscriptionId	path	True	string	用于标识 Azure 订阅的订阅 ID。
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 - 找不到导入或导出的操作 ID。 404 ServerNotInSubscription - 指定的服务器不存在于指定的订阅中。 404 OperationIdNotFound - ID 为的操作不存在。 409 ImportExportOperationInProgress - 正在对数据库执行导入或导出操作。 409 OperationCancelled - 用户已取消操作。 409 操作中断 - 无法完成对资源的操作，因为同一资源上的另一个操作中断了该操作。 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 - 找不到导入或导出的操作 ID。
404 ServerNotInSubscription - 指定的服务器不存在于指定的订阅中。
404 OperationIdNotFound - ID 为的操作不存在。
409 ImportExportOperationInProgress - 正在对数据库执行导入或导出操作。
409 OperationCancelled - 用户已取消操作。
409 操作中断 - 无法完成对资源的操作，因为同一资源上的另一个操作中断了该操作。
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.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")),
                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 an existing empty database.

示例请求

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.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"),
            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

定义

名称	说明
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	资源 ID。
name	string	资源名称。
properties.blobUri	string	Blob URI。
properties.databaseName	string	数据库名称。
properties.errorMessage	string	错误消息。
properties.lastModifiedTime	string	上次修改时间。
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	获取与此请求关联的专用终结点的状态。
properties.queuedTime	string	排队时间。
properties.requestId	string	请求 ID。
properties.requestType	string	请求类型。
properties.serverName	string	服务器名称。
properties.status	string	操作状态。
type	string	资源类型。

NetworkIsolationSettings

包含要为其创建专用终结点连接的 ARM 资源。

名称	类型	说明
sqlServerResourceId	string	此请求的目标 SQL Server 的资源 ID。如果设置，将为 SQL Server 创建专用终结点连接。必须与操作的目标服务器匹配。
storageAccountResourceId	string	用于存储 BACPAC 文件的存储帐户的资源 ID。如果设置，将为存储帐户创建专用终结点连接。必须与用于 StorageUri 参数的存储帐户匹配。

PrivateEndpointConnectionRequestStatus

包含专用终结点连接请求状态。

名称	类型	说明
privateEndpointConnectionName	string	专用终结点的连接名称。
privateLinkServiceId	string	为其创建专用终结点的资源 ID。
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.

示例请求

示例响应

Imports to an existing empty database.

示例请求

示例响应

定义

ImportExistingDatabaseDefinition

ImportExportOperationResult

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

其他资源