Items - Preflight Sql Endpoint Metadata Sync Upgrade
评估元数据同步升级的指定 SQL 分析终结点。
Note
元数据同步迁移目前为预览版(了解详细信息)。
此 API 支持 长时间运行的作(LRO)。
在不转换任何表的情况下运行就绪情况评估,并返回阻塞问题和表资格计数。
Permissions
调用方必须对 SQL 分析终结点项具有 写入 权限。
所需的委派范围
Item.ReadWrite.All 或 SQLEndpoint.ReadWrite.All
Microsoft Entra 支持的标识
此 API 支持本节中列出的Microsoft 标识。
| Identity | 支持 |
|---|---|
| User | Yes |
| 服务主体 和 托管标识 | Yes |
Interface
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlEndpoints/{itemId}/preflightMetadataSyncUpgrade
URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
item
|
path | True |
string (uuid) |
SQL 分析终结点 ID。 |
|
workspace
|
path | True |
string (uuid) |
工作区标识符。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
请求成功完成。 |
|
| 202 Accepted |
请求接受的元数据同步升级评估正在进行中。 标头:
位置
x-ms-operation-id
Retry-After 标头
|
|
| 429 Too Many Requests |
超出服务速率限制。 服务器返回一个 标头 Retry-After: integer |
|
| Other Status Codes |
常见错误代码:
|
示例
Preflight metadata sync upgrade example
示例请求
POST https://api.fabric.microsoft.com/v1/workspaces/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/sqlEndpoints/9b1e77c2-6a4e-4f0b-bd3a-1f2c0d4e5a6b/preflightMetadataSyncUpgrade
示例响应
{
"evaluatedTableCount": 1250,
"eligibleTableCount": 1248,
"blockers": [
{
"schema": "dbo",
"tableName": "LegacyAudit",
"correctiveAction": "Remove the unsupported column type before upgrading, then rerun preflight."
},
{
"schema": "sales",
"tableName": "ArchivedOrders",
"correctiveAction": "Recreate the table with a supported Delta writer version, then rerun preflight."
}
]
}
定义
| 名称 | 说明 |
|---|---|
|
Error |
一个结构化参数,提供有关错误的附加计算机可读上下文。 |
|
Error |
与错误相关的资源详细信息对象。 |
|
Error |
错误响应。 |
|
Error |
错误响应详细信息。 |
|
Metadata |
阻止表迁移的问题。 |
|
Metadata |
元数据同步迁移预检评估的结果。 |
ErrorParameter
一个结构化参数,提供有关错误的附加计算机可读上下文。
| 名称 | 类型 | 说明 |
|---|---|---|
| message |
string |
参数含义的可读说明。 |
| name |
string |
参数标识符。 |
| value |
string |
参数值。 |
ErrorRelatedResource
与错误相关的资源详细信息对象。
| 名称 | 类型 | 说明 |
|---|---|---|
| resourceId |
string |
错误中涉及的资源 ID。 |
| resourceType |
string |
错误中涉及的资源的类型。 |
ErrorResponse
错误响应。
| 名称 | 类型 | 说明 |
|---|---|---|
| errorCode |
string |
提供有关错误条件的信息的特定标识符,允许服务与其用户之间的标准化通信。 |
| isRetriable |
boolean |
如果为 true,可以重试请求。
|
| message |
string |
错误的人工可读表示形式。 |
| moreDetails |
其他错误详细信息的列表。 |
|
| parameters |
提供有关错误的其他计算机可读上下文的结构化参数。 |
|
| relatedResource |
与错误相关的资源详细信息。 |
|
| requestId |
string (uuid) |
与错误关联的请求的 ID。 |
ErrorResponseDetails
错误响应详细信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| errorCode |
string |
提供有关错误条件的信息的特定标识符,允许服务与其用户之间的标准化通信。 |
| message |
string |
错误的人工可读表示形式。 |
| parameters |
提供有关错误的其他计算机可读上下文的结构化参数。 |
|
| relatedResource |
与错误相关的资源详细信息。 |
MetadataSyncMigrationBlocker
阻止表迁移的问题。
| 名称 | 类型 | 说明 |
|---|---|---|
| correctiveAction |
string |
调用方可以采取的纠正措施来取消阻止表。 |
| schema |
string |
受影响的表的架构名称。 |
| tableName |
string |
受影响的表的名称。 |
MetadataSyncMigrationPreflightResult
元数据同步迁移预检评估的结果。
| 名称 | 类型 | 说明 |
|---|---|---|
| blockers |
评估期间发现的阻止问题。 |
|
| eligibleTableCount |
integer (int32) |
符合迁移条件的表数。 |
| evaluatedTableCount |
integer (int32) |
计算的表数。 |