您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

Servers - Import Database

将 bacpac 导入到新数据库中。

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

URI 参数

Name In Required Type Description
resourceGroupName
path True
  • string

包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。

serverName
path True
  • string

服务器的名称。

subscriptionId
path True
  • string

用于标识 Azure 订阅的订阅 ID。

api-version
query True
  • string

要用于请求的 API 版本。

请求正文

Name Required Type Description
administratorLogin True
  • string

管理员登录名。

administratorLoginPassword True
  • string

管理员登录密码。

storageKey True
  • string

存储密钥。

storageKeyType True

存储密钥类型。

storageUri True
  • string

存储 Uri。

authenticationType
  • string

身份验证类型。

databaseName
  • string

导入数据库的名称。

edition
  • string

导入数据库的版本。

maxSizeBytes
  • string

导入数据库的最大大小(以字节为单位)。

networkIsolation

可选的资源信息,用于为请求启用网络隔离。

serviceObjectiveName
  • string

导入数据库的服务级别目标名称。

响应

Name Type Description
200 OK

已成功导入数据库。

202 Accepted

正在导入数据库。

Other Status Codes

错误响应: * * *

  • 400 MissingImportExportInputParameters-缺少 ImportExport 输入参数。

  • 400 PolybaseImportAuthenticationTypeNotSupported-身份验证类型参数不支持 PolybaseImport 操作。

  • 400 DatabaseExtensionsInvalidOperationMode-数据库扩展的 operationMode 参数无效。

  • 400 DatabaseExtensionsInvalidStorageKeyType-存储密钥类型必须是 "StorageAccessKey"。

  • 400 DatabaseExtensionsMissingStorageUri-存储 URI 不能为空。

  • 400 FeatureDisabledOnSelectedEdition-用户尝试使用在当前数据库版本上禁用的功能。

  • 400 InvalidOperationType-提供有效的操作类型。

  • 400 ImportExportJobError-ImportExport 操作失败。

  • 400 BlockedByOutboundFirewall-出站防火墙规则阻止了请求。

  • 404 ResourceNotFound-指定不存在的资源的请求无效。

  • 404 ServerNotInSubscriptionResourceGroup-指定的服务器在指定的资源组和订阅中不存在。

  • 404 ImportExportOperationIdNotFound-找不到导入或导出操作 Id。

  • 404 ServerNotInSubscription-指定的订阅中不存在指定的服务器。

  • 409 ImportExportOperationInProgress-数据库上正在执行导入或导出操作。

示例

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

Sample Request

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

Sample Response

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

Imports to a new database.

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2020-11-01-preview
{
  "databaseName": "testdb",
  "storageKeyType": "StorageAccessKey",
  "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac",
  "administratorLogin": "login",
  "administratorLoginPassword": "password",
  "authenticationType": "Sql"
}

Sample Response

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

定义

ImportExportOperationResult

ImportExport 操作结果资源。

ImportNewDatabaseDefinition

包含为新数据库执行导入操作所需的信息。

NetworkIsolationSettings

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

PrivateEndpointConnectionRequestStatus

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

StorageKeyType

存储密钥类型。

ImportExportOperationResult

ImportExport 操作结果资源。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.blobUri
  • string

Blob Uri。

properties.databaseName
  • string

数据库名称。

properties.errorMessage
  • string

错误消息。

properties.lastModifiedTime
  • string

上次修改时间。

properties.privateEndpointConnections

获取与此请求关联的专用终结点的状态。

properties.queuedTime
  • string

排队时间。

properties.requestId
  • string

请求 Id。

properties.requestType
  • string

请求类型。

properties.serverName
  • string

服务器名称。

properties.status
  • string

操作状态。

type
  • string

资源类型。

ImportNewDatabaseDefinition

包含为新数据库执行导入操作所需的信息。

Name Type Description
administratorLogin
  • string

管理员登录名。

administratorLoginPassword
  • string

管理员登录密码。

authenticationType
  • string

身份验证类型。

databaseName
  • string

导入数据库的名称。

edition
  • string

导入数据库的版本。

maxSizeBytes
  • string

导入数据库的最大大小(以字节为单位)。

networkIsolation

可选的资源信息,用于为请求启用网络隔离。

serviceObjectiveName
  • string

导入数据库的服务级别目标名称。

storageKey
  • string

存储密钥。

storageKeyType

存储密钥类型。

storageUri
  • string

存储 Uri。

NetworkIsolationSettings

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

Name Type Description
sqlServerResourceId
  • string

作为此请求的目标的 SQL server 的资源 id。 如果已设置,将为 SQL server 创建专用终结点连接。 必须匹配作为操作目标的服务器。

storageAccountResourceId
  • string

用于存储 BACPAC 文件的存储帐户的资源 id。 如果已设置,则将为存储帐户创建专用终结点连接。 必须与用于 StorageUri 参数的存储帐户匹配。

PrivateEndpointConnectionRequestStatus

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

Name Type Description
privateEndpointConnectionName
  • string

专用终结点的连接名称。

privateLinkServiceId
  • string

为其创建专用终结点的资源 id。

status
  • string

此专用终结点连接的状态。

StorageKeyType

存储密钥类型。

Name Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string