Items - Get Sql Endpoint Metadata Sync Migration Status

获取指定 SQL 分析终结点的元数据同步迁移状态。

注意

元数据同步迁移目前为预览版(了解详细信息)。

返回当前同步体系结构版本、正在进行的任何迁移的方向,以及最近完成的迁移尝试的结果。

Permissions

调用方必须具有 SQL 分析终结点项的 读取 权限。

所需的委派范围

Item.Read.All 或 Item.ReadWrite.All 或 SQLEndpoint.Read.All 或 SQLEndpoint.ReadWrite.All

Microsoft Entra 支持的标识

此 API 支持本节中列出的Microsoft 标识。

Identity 支持
User Yes
服务主体 和 托管标识 Yes

Interface

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlEndpoints/{itemId}/metadataSyncMigrationStatus

URI 参数

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

string (uuid)

SQL 分析终结点 ID。

workspaceId
path True

string (uuid)

工作区标识符。

响应

名称 类型 说明
200 OK

MetadataSyncMigrationStatus

请求成功完成。

429 Too Many Requests

ErrorResponse

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

标头

Retry-After: integer

Other Status Codes

ErrorResponse

常见错误代码:

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

示例

Get metadata sync migration status example

示例请求

GET https://api.fabric.microsoft.com/v1/workspaces/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/sqlEndpoints/9b1e77c2-6a4e-4f0b-bd3a-1f2c0d4e5a6b/metadataSyncMigrationStatus

示例响应

{
  "syncArchitectureVersion": "V2",
  "itemMigrationDirection": "MigratingToV2",
  "tableFailures": [
    {
      "schema": "dbo",
      "tableName": "OrderDetails",
      "error": {
        "errorCode": "DeltaTableNotFound",
        "message": "Delta table 'Tables\\OrderDetails\\_delta_log' was not found."
      }
    }
  ],
  "lastMigrationAttempt": {
    "sourceSyncArchitectureVersion": "V1",
    "targetSyncArchitectureVersion": "V2",
    "itemMigrationStatus": "PartiallySucceeded",
    "completedDateTime": "2026-06-09T14:31:25Z"
  }
}

定义

名称 说明
ErrorParameter

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

ErrorRelatedResource

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

ErrorResponse

错误响应。

ErrorResponseDetails

错误响应详细信息。

ItemMigrationDirection

活动元数据同步迁移的方向。 可能会随着时间的推移添加其他 ItemMigrationDirection 类型。

ItemMigrationStatus

元数据同步迁移的总体结果。 可能会随着时间的推移添加其他 ItemMigrationStatus 类型。

MetadataSyncMigrationAttempt

已完成的元数据同步迁移尝试的摘要。

MetadataSyncMigrationStatus

SQL 分析终结点的元数据同步迁移状态。

MetadataSyncTableFailure

在已完成的元数据同步迁移尝试中失败的表。

SyncArchitectureVersion

同步体系结构版本。 可能会随着时间的推移添加其他 SyncArchitectureVersion 类型。

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

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

ItemMigrationDirection

活动元数据同步迁移的方向。 可能会随着时间的推移添加其他 ItemMigrationDirection 类型。

值 说明
MigratingToV2

正在从 v1 常规表体系结构迁移到 v2 外部表体系结构。

MigratingToV1

正在从 v2 外部表体系结构迁移到 v1 常规表体系结构。

ItemMigrationStatus

元数据同步迁移的总体结果。 可能会随着时间的推移添加其他 ItemMigrationStatus 类型。

值 说明
Succeeded

迁移已完成,没有表无法转换。

PartiallySucceeded

至少有一个表达到了目标体系结构,至少一个表无法转换。

Failed

需要转换的每个表都失败,终结点仍保留在其以前的体系结构中。

MetadataSyncMigrationAttempt

已完成的元数据同步迁移尝试的摘要。

名称 类型 说明
completedDateTime

string (date-time)

使用 YYYY-MM-DDTHH:mm:ssZ 格式完成迁移尝试的日期和时间。

itemMigrationStatus

ItemMigrationStatus

迁移尝试的总体结果。

sourceSyncArchitectureVersion

SyncArchitectureVersion

从中迁移尝试的同步体系结构版本。

targetSyncArchitectureVersion

SyncArchitectureVersion

尝试迁移到的同步体系结构版本。

MetadataSyncMigrationStatus

SQL 分析终结点的元数据同步迁移状态。

名称 类型 说明
itemMigrationDirection

ItemMigrationDirection

终结点当前迁移的方向。 如果未进行迁移,则会省略此属性。

lastMigrationAttempt

MetadataSyncMigrationAttempt

最近完成的迁移尝试的摘要。 如果未尝试迁移,则会省略此属性。

syncArchitectureVersion

SyncArchitectureVersion

终结点的当前同步体系结构版本。 迁移正在进行时,此属性将保留在源版本,并且仅在迁移达到终端状态时才更改为目标版本。

tableFailures

MetadataSyncTableFailure[]

在最近完成的迁移尝试中失败的表。

MetadataSyncTableFailure

在已完成的元数据同步迁移尝试中失败的表。

名称 类型 说明
error

ErrorResponseDetails

导致表迁移失败的错误。

schema

string

失败表的架构名称。

tableName

string

失败表的非限定名称。

SyncArchitectureVersion

同步体系结构版本。 可能会随着时间的推移添加其他 SyncArchitectureVersion 类型。

值 说明
V1

v1 常规表同步体系结构。

V2

v2 外部表同步体系结构。