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

Database Extensions - Create Or Update

执行数据库扩展操作,例如数据库导入、数据库导出或 polybase 导入

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/extensions/{extensionName}?api-version=2021-08-01-preview

URI 参数

Name In Required Type Description
databaseName
path True
  • string

数据库的名称。

extensionName
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 版本。

请求正文

Name Required Type Description
properties.operationMode True

操作的操作模式:导入、导出或 PolybaseImport。

properties.storageKey True
  • string

存储帐户的存储密钥。

properties.storageKeyType True

存储密钥类型:StorageAccessKey 或 SharedAccessKey。

properties.storageUri True
  • string

存储帐户的存储 URI。

properties.administratorLogin
  • string

管理员登录名。

properties.administratorLoginPassword
  • string

管理员登录密码。

properties.authenticationType
  • string

身份验证类型:SQL 身份验证或 AD 密码。

properties.databaseEdition
  • string

导入操作时新创建的数据库的数据库版本。

properties.maxSizeBytes
  • string

导入操作时新创建的数据库的数据库最大大小(以字节为单位)。

properties.networkIsolation

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

properties.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 - 数据库中正在进行导入或导出操作。

示例

Create or Update database extensions.
Export database using database extension.
Import database using database extension.

Create or Update database extensions.

Sample Request

PUT https://management.azure.com/subscriptions/a1c0814d-3c18-4e1e-a247-c128c12b1677/resourceGroups/rg_20cbe0f0-c2d9-4522-9177-5469aad53029/providers/Microsoft.Sql/servers/srv_1ffd1cf8-9951-47fb-807d-a9c384763849/databases/878e303f-1ea0-4f17-aa3d-a22ac5e9da08/extensions/polybaseimport?api-version=2021-08-01-preview

{
  "properties": {
    "operationMode": "PolybaseImport",
    "storageKeyType": "StorageAccessKey",
    "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml"
  }
}

Sample Response

{
  "properties": {
    "requestId": "10000000-0000-0000-0000-000000000002",
    "requestType": "PolybaseImport",
    "lastModifiedTime": "lastModifiedTime",
    "serverName": "srv_1ffd1cf8-9951-47fb-807d-a9c384763849",
    "databaseName": "878e303f-1ea0-4f17-aa3d-a22ac5e9da08",
    "status": "succeeded"
  },
  "id": "10000000-0000-0000-0000-000000000002",
  "name": "10000000-0000-0000-0000-000000000002",
  "type": "Microsoft.Sql/servers/databases/extensions"
}

Export database using database extension.

Sample Request

PUT https://management.azure.com/subscriptions/0ca8cd24-0b47-4ad5-bc7e-d70e35c44adf/resourceGroups/rg_d1ef9eae-044d-4710-ba59-b82e84ad3157/providers/Microsoft.Sql/servers/srv_9243d320-ac4e-4f97-8e06-b1167dae5f4c/databases/db_7fe424c8-23cf-4ac3-bdc3-e21f424bdb68/extensions/Export?api-version=2021-08-01-preview

{
  "properties": {
    "operationMode": "Export",
    "storageKeyType": "StorageAccessKey",
    "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml",
    "administratorLogin": "login",
    "administratorLoginPassword": "password",
    "authenticationType": "Sql"
  }
}

Sample Response

{
  "properties": {
    "requestId": "10000000-0000-0000-0000-000000000002",
    "requestType": "Export",
    "lastModifiedTime": "lastModifiedTime",
    "serverName": "srv_9243d320-ac4e-4f97-8e06-b1167dae5f4c",
    "databaseName": "db_7fe424c8-23cf-4ac3-bdc3-e21f424bdb68",
    "status": "Completed",
    "queuedTime": "09/10/2021 18:35:10",
    "blobUri": "https://teststorage.blob.core.windows.net/testcontainer/samplebacpac.bacpac",
    "privateEndpointConnections": []
  },
  "id": "10000000-0000-0000-0000-000000000002",
  "name": "10000000-0000-0000-0000-000000000002",
  "type": "Microsoft.Sql/servers/databases/extensions"
}

Import database using database extension.

Sample Request

PUT https://management.azure.com/subscriptions/17ca4d13-bf7d-4c33-a60e-b87a2820a325/resourceGroups/rg_062866bf-c4f4-41f9-abf0-b59132ca7924/providers/Microsoft.Sql/servers/srv_2d6be2d2-26c8-4930-8fb6-82a5e95e0e82/databases/db_2a47e946-e414-4c00-94ac-ed886bb78302/extensions/Import?api-version=2021-08-01-preview

{
  "properties": {
    "operationMode": "Import",
    "storageKeyType": "StorageAccessKey",
    "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml",
    "administratorLogin": "login",
    "administratorLoginPassword": "password",
    "authenticationType": "Sql"
  }
}

Sample Response

{
  "properties": {
    "requestId": "10000000-0000-0000-0000-000000000002",
    "requestType": "Import",
    "lastModifiedTime": "lastModifiedTime",
    "serverName": "srv_2d6be2d2-26c8-4930-8fb6-82a5e95e0e82",
    "databaseName": "db_2a47e946-e414-4c00-94ac-ed886bb78302",
    "status": "Completed",
    "queuedTime": "09/10/2021 18:35:10",
    "blobUri": "https://teststorage.blob.core.windows.net/testcontainer/samplebacpac.bacpac",
    "privateEndpointConnections": []
  },
  "id": "10000000-0000-0000-0000-000000000002",
  "name": "10000000-0000-0000-0000-000000000002",
  "type": "Microsoft.Sql/servers/databases/extensions"
}

定义

DatabaseExtensions

导入、导出或 PolybaseImport 资源。

ImportExportExtensionsOperationResult

扩展操作结果资源。

NetworkIsolationSettings

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

OperationMode

操作的操作模式:导入、导出或 PolybaseImport。

PrivateEndpointConnectionRequestStatus

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

StorageKeyType

存储密钥类型:StorageAccessKey 或 SharedAccessKey。

DatabaseExtensions

导入、导出或 PolybaseImport 资源。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.administratorLogin
  • string

管理员登录名。

properties.administratorLoginPassword
  • string

管理员登录密码。

properties.authenticationType
  • string

身份验证类型:SQL 身份验证或 AD 密码。

properties.databaseEdition
  • string

导入操作时新创建的数据库的数据库版本。

properties.maxSizeBytes
  • string

导入操作时新创建的数据库的数据库最大大小(以字节为单位)。

properties.networkIsolation

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

properties.operationMode

操作的操作模式:导入、导出或 PolybaseImport。

properties.serviceObjectiveName
  • string

导入操作时新创建的数据库的数据库服务级别目标。

properties.storageKey
  • string

存储帐户的存储密钥。

properties.storageKeyType

存储密钥类型:StorageAccessKey 或 SharedAccessKey。

properties.storageUri
  • string

存储帐户的存储 URI。

type
  • string

资源类型。

ImportExportExtensionsOperationResult

扩展操作结果资源。

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

资源类型。

NetworkIsolationSettings

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

Name Type Description
sqlServerResourceId
  • string

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

storageAccountResourceId
  • string

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

OperationMode

操作的操作模式:导入、导出或 PolybaseImport。

Name Type Description
Export
  • string
Import
  • string
PolybaseImport
  • string

PrivateEndpointConnectionRequestStatus

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

Name Type Description
privateEndpointConnectionName
  • string

专用终结点的连接名称。

privateLinkServiceId
  • string

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

status
  • string

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

StorageKeyType

存储密钥类型:StorageAccessKey 或 SharedAccessKey。

Name Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string