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 参数

名称 在 必需 类型 说明
itemId
path True

string (uuid)

SQL 分析终结点 ID。

workspaceId
path True

string (uuid)

工作区标识符。

响应

名称 类型 说明
200 OK

MetadataSyncMigrationPreflightResult

请求成功完成。

202 Accepted

请求接受的元数据同步升级评估正在进行中。


标头:

位置string - 操作状态的 URL,可用于跟踪操作状态。

x-ms-operation-idstring (uuid) - 可用于长时间运行的操作(LRO)API 的操作 ID,用于跟踪操作状态并获取结果。

Retry-Afterinteger - 重试请求之前等待的秒数。

标头

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
429 Too Many Requests

ErrorResponse

超出服务速率限制。 服务器返回一个 Retry-After 标头,指示客户端在发送其他请求之前必须等待的时间(以秒为单位)。

标头

Retry-After: integer

Other Status Codes

ErrorResponse

常见错误代码:

  • ItemNotFound - 找不到请求的项目。

  • LockConflict - SQL 分析终结点正忙于另一个锁定操作。

示例

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."
    }
  ]
}

定义

名称 说明
ErrorParameter

一个结构化参数,提供有关错误的附加计算机可读上下文。

ErrorRelatedResource

与错误相关的资源详细信息对象。

ErrorResponse

错误响应。

ErrorResponseDetails

错误响应详细信息。

MetadataSyncMigrationBlocker

阻止表迁移的问题。

MetadataSyncMigrationPreflightResult

元数据同步迁移预检评估的结果。

ErrorParameter

一个结构化参数,提供有关错误的附加计算机可读上下文。

名称 类型 说明
message

string

参数含义的可读说明。

name

string

参数标识符。

value

string

参数值。

ErrorRelatedResource

与错误相关的资源详细信息对象。

名称 类型 说明
resourceId

string

错误中涉及的资源 ID。

resourceType

string

错误中涉及的资源的类型。

ErrorResponse

错误响应。

名称 类型 说明
errorCode

string

提供有关错误条件的信息的特定标识符,允许服务与其用户之间的标准化通信。

isRetriable

boolean

如果为 true,可以重试请求。 Retry-After使用响应标头确定延迟(如果可用)。

message

string

错误的人工可读表示形式。

moreDetails

ErrorResponseDetails[]

其他错误详细信息的列表。

parameters

ErrorParameter[]

提供有关错误的其他计算机可读上下文的结构化参数。

relatedResource

ErrorRelatedResource

与错误相关的资源详细信息。

requestId

string (uuid)

与错误关联的请求的 ID。

ErrorResponseDetails

错误响应详细信息。

名称 类型 说明
errorCode

string

提供有关错误条件的信息的特定标识符,允许服务与其用户之间的标准化通信。

message

string

错误的人工可读表示形式。

parameters

ErrorParameter[]

提供有关错误的其他计算机可读上下文的结构化参数。

relatedResource

ErrorRelatedResource

与错误相关的资源详细信息。

MetadataSyncMigrationBlocker

阻止表迁移的问题。

名称 类型 说明
correctiveAction

string

调用方可以采取的纠正措施来取消阻止表。

schema

string

受影响的表的架构名称。

tableName

string

受影响的表的名称。

MetadataSyncMigrationPreflightResult

元数据同步迁移预检评估的结果。

名称 类型 说明
blockers

MetadataSyncMigrationBlocker[]

评估期间发现的阻止问题。

eligibleTableCount

integer (int32)

符合迁移条件的表数。

evaluatedTableCount

integer (int32)

计算的表数。