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=2023-08-01
URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
database
|
path | True |
string |
数据库的名称。 |
|
extension
|
path | True |
string |
|
|
resource
|
path | True |
string |
包含资源的资源组的名称。 可以从 Azure 资源管理器 API 或门户获取此值。 |
|
server
|
path | True |
string |
服务器的名称。 |
|
subscription
|
path | True |
string |
标识 Azure 订阅的订阅 ID。 |
|
api-version
|
query | True |
string |
要用于请求的 API 版本。 |
请求正文
| 名称 | 必需 | 类型 | 说明 |
|---|---|---|---|
| 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 |
导入作时新建的数据库的数据库服务级别目标。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
成功完成导入/导出作。 |
|
| 202 Accepted |
导入/导出作正在进行中。 标头 Location: string |
|
| Other Status Codes |
错误响应: ***
|
示例
| Create or Update database extensions. |
| Export database using database extension. |
| Import database using database extension. |
Create or Update database extensions.
示例请求
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=2023-08-01
{
"properties": {
"operationMode": "PolybaseImport",
"storageKeyType": "StorageAccessKey",
"storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml"
}
}
示例响应
{
"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.
示例请求
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=2023-08-01
{
"properties": {
"operationMode": "Export",
"storageKeyType": "StorageAccessKey",
"storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml",
"administratorLogin": "login",
"administratorLoginPassword": "password",
"authenticationType": "Sql"
}
}
示例响应
{
"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.
示例请求
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=2023-08-01
{
"properties": {
"operationMode": "Import",
"storageKeyType": "StorageAccessKey",
"storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml",
"administratorLogin": "login",
"administratorLoginPassword": "password",
"authenticationType": "Sql"
}
}
示例响应
{
"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"
}
定义
| 名称 | 说明 |
|---|---|
|
Database |
导入、导出或 PolybaseImport 资源。 |
|
Error |
资源管理错误附加信息。 |
|
Error |
错误详细信息。 |
|
Error |
错误响应 |
|
Import |
扩展作结果资源。 |
|
Network |
包含要为其创建专用终结点连接的 ARM 资源。 |
|
Operation |
作的作模式:导入、导出或 PolybaseImport。 |
|
Private |
包含专用终结点连接请求状态。 |
|
Storage |
存储密钥类型:StorageAccessKey 或 SharedAccessKey。 |
DatabaseExtensions
导入、导出或 PolybaseImport 资源。
| 名称 | 类型 | 说明 |
|---|---|---|
| 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 |
资源类型。 |
ErrorAdditionalInfo
资源管理错误附加信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| info |
object |
其他信息。 |
| type |
string |
其他信息类型。 |
ErrorDetail
错误详细信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| additionalInfo |
错误附加信息。 |
|
| code |
string |
错误代码。 |
| details |
错误详细信息。 |
|
| message |
string |
错误消息。 |
| target |
string |
错误目标。 |
ErrorResponse
错误响应
| 名称 | 类型 | 说明 |
|---|---|---|
| error |
错误对象。 |
ImportExportExtensionsOperationResult
扩展作结果资源。
| 名称 | 类型 | 说明 |
|---|---|---|
| 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 (uuid) |
请求 ID。 |
| properties.requestType |
string |
请求类型。 |
| properties.serverName |
string |
服务器名称。 |
| properties.status |
string |
作状态。 |
| type |
string |
资源类型。 |
NetworkIsolationSettings
包含要为其创建专用终结点连接的 ARM 资源。
| 名称 | 类型 | 说明 |
|---|---|---|
| sqlServerResourceId |
string (arm-id) |
SQL Server 的资源 ID,这是此请求的目标。 如果设置,将为 SQL Server 创建专用终结点连接。 必须与作的目标服务器匹配。 |
| storageAccountResourceId |
string (arm-id) |
用于存储 BACPAC 文件的存储帐户的资源 ID。 如果设置,将为存储帐户创建专用终结点连接。 必须与用于 StorageUri 参数的存储帐户匹配。 |
OperationMode
作的作模式:导入、导出或 PolybaseImport。
| 值 | 说明 |
|---|---|
| PolybaseImport | |
| Import | |
| Export |
PrivateEndpointConnectionRequestStatus
包含专用终结点连接请求状态。
| 名称 | 类型 | 说明 |
|---|---|---|
| privateEndpointConnectionName |
string |
专用终结点的连接名称。 |
| privateLinkServiceId |
string |
为其创建专用终结点的资源 ID。 |
| status |
string |
此专用终结点连接的状态。 |
StorageKeyType
存储密钥类型:StorageAccessKey 或 SharedAccessKey。
| 值 | 说明 |
|---|---|
| SharedAccessKey | |
| StorageAccessKey |