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 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
item
|
path | True |
string (uuid) |
SQL 分析终结点 ID。 |
|
workspace
|
path | True |
string (uuid) |
工作区标识符。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
请求成功完成。 |
|
| 429 Too Many Requests |
超出服务速率限制。 服务器返回一个 标头 Retry-After: integer |
|
| Other Status Codes |
常见错误代码:
|
示例
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"
}
}
定义
| 名称 | 说明 |
|---|---|
|
Error |
一个结构化参数,提供有关错误的附加计算机可读上下文。 |
|
Error |
与错误相关的资源详细信息对象。 |
|
Error |
错误响应。 |
|
Error |
错误响应详细信息。 |
|
Item |
活动元数据同步迁移的方向。 可能会随着时间的推移添加其他 ItemMigrationDirection 类型。 |
|
Item |
元数据同步迁移的总体结果。 可能会随着时间的推移添加其他 ItemMigrationStatus 类型。 |
|
Metadata |
已完成的元数据同步迁移尝试的摘要。 |
|
Metadata |
SQL 分析终结点的元数据同步迁移状态。 |
|
Metadata |
在已完成的元数据同步迁移尝试中失败的表。 |
|
Sync |
同步体系结构版本。 可能会随着时间的推移添加其他 SyncArchitectureVersion 类型。 |
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 |
与错误相关的资源详细信息。 |
ItemMigrationDirection
活动元数据同步迁移的方向。 可能会随着时间的推移添加其他 ItemMigrationDirection 类型。
| 值 | 说明 |
|---|---|
| MigratingToV2 |
正在从 v1 常规表体系结构迁移到 v2 外部表体系结构。 |
| MigratingToV1 |
正在从 v2 外部表体系结构迁移到 v1 常规表体系结构。 |
ItemMigrationStatus
元数据同步迁移的总体结果。 可能会随着时间的推移添加其他 ItemMigrationStatus 类型。
| 值 | 说明 |
|---|---|
| Succeeded |
迁移已完成,没有表无法转换。 |
| PartiallySucceeded |
至少有一个表达到了目标体系结构,至少一个表无法转换。 |
| Failed |
需要转换的每个表都失败,终结点仍保留在其以前的体系结构中。 |
MetadataSyncMigrationAttempt
已完成的元数据同步迁移尝试的摘要。
| 名称 | 类型 | 说明 |
|---|---|---|
| completedDateTime |
string (date-time) |
使用 YYYY-MM-DDTHH:mm:ssZ 格式完成迁移尝试的日期和时间。 |
| itemMigrationStatus |
迁移尝试的总体结果。 |
|
| sourceSyncArchitectureVersion |
从中迁移尝试的同步体系结构版本。 |
|
| targetSyncArchitectureVersion |
尝试迁移到的同步体系结构版本。 |
MetadataSyncMigrationStatus
SQL 分析终结点的元数据同步迁移状态。
| 名称 | 类型 | 说明 |
|---|---|---|
| itemMigrationDirection |
终结点当前迁移的方向。 如果未进行迁移,则会省略此属性。 |
|
| lastMigrationAttempt |
最近完成的迁移尝试的摘要。 如果未尝试迁移,则会省略此属性。 |
|
| syncArchitectureVersion |
终结点的当前同步体系结构版本。 迁移正在进行时,此属性将保留在源版本,并且仅在迁移达到终端状态时才更改为目标版本。 |
|
| tableFailures |
在最近完成的迁移尝试中失败的表。 |
MetadataSyncTableFailure
在已完成的元数据同步迁移尝试中失败的表。
| 名称 | 类型 | 说明 |
|---|---|---|
| error |
导致表迁移失败的错误。 |
|
| schema |
string |
失败表的架构名称。 |
| tableName |
string |
失败表的非限定名称。 |
SyncArchitectureVersion
同步体系结构版本。 可能会随着时间的推移添加其他 SyncArchitectureVersion 类型。
| 值 | 说明 |
|---|---|
| V1 |
v1 常规表同步体系结构。 |
| V2 |
v2 外部表同步体系结构。 |