通过

Mirroring - Get Tables Mirroring Status

服务:
MirroredDatabase
API 版本:
v1

获取表的镜像状态。
此 API 支持 分页。

权限

调用方必须具有镜像数据库的 读取 权限。

所需的委派范围

MirroredDatabase.Read.All 或 MirroredDatabase.ReadWrite.All 或 Item.Read.All 或 Item.ReadWrite.All

Microsoft Entra 支持的标识

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

身份 支持
用户 是的
服务主体 和 托管标识 是的

接口

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mirroredDatabases/{mirroredDatabaseId}/getTablesMirroringStatus
具有可选参数: 
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mirroredDatabases/{mirroredDatabaseId}/getTablesMirroringStatus?continuationToken={continuationToken}

URI 参数

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

string (uuid)

镜像数据库 ID。
workspaceId
 path True

string (uuid)

工作区 ID。
continuationToken
 query

string

用于检索下一页结果的令牌。

响应

名称 类型 说明
200 OK

TablesMirroringStatusResponse

请求成功完成。
Other Status Codes

ErrorResponse

常见错误代码：

  • UnknownError - 发生错误。

示例

Get tables mirroring status example

示例请求

POST https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/mirroredDatabases/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2/getTablesMirroringStatus

示例响应

状态代码:
200 
{
  "data": [
    {
      "sourceObjectType": "Table",
      "sourceSchemaName": "dbo",
      "sourceTableName": "test",
      "status": "Replicating",
      "metrics": {
        "processedBytes": 1247,
        "processedRows": 6,
        "lastSyncDateTime": "2024-10-08T05:07:11.0663362Z",
        "lastSyncLatencyInSeconds": 15
      }
    }
  ]
}

定义

名称 说明
ErrorRelatedResource

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

错误响应。
ErrorResponseDetails

错误响应详细信息。
TableMirroringMetrics

表镜像指标。
TableMirroringStatus

表镜像状态类型。 可能会随着时间的推移添加其他 TableMirroringStatus 类型。
TableMirroringStatusResponse

表镜像状态响应。
TablesMirroringStatusResponse

表镜像状态的分页列表。
TableSourceObjectType

表源对象类型。 可能会随着时间的推移添加其他 TableSourceObjectType 类型。

ErrorRelatedResource

Object

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

名称 类型 说明
resourceId

string

错误中涉及的资源 ID。
resourceType

string

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

ErrorResponse

Object

错误响应。

名称 类型 说明
errorCode

string

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

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string

与错误关联的请求的 ID。

ErrorResponseDetails

Object

错误响应详细信息。

名称 类型 说明
errorCode

string

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

string

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

ErrorRelatedResource

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

TableMirroringMetrics

Object

表镜像指标。

名称 类型 说明
lastSyncDateTime

string (date-time)

使用 YYYY-MM-DDTHH：mm：ssZ 格式的表的上次处理时间（以 UTC 为单位）。
lastSyncLatencyInSeconds

integer (int32)

源提交时间和上次处理更改的目标提交时间之间的延迟（以秒为单位）。 对于源提交时间不可用的源，不会返回此值。
processedBytes

integer (int64)

已处理此表的字节数。
processedRows

integer (int64)

此表的已处理行计数。

TableMirroringStatus

枚举

表镜像状态类型。 可能会随着时间的推移添加其他 TableMirroringStatus 类型。

值 说明
Initialized

表的 Mirroing 已初始化。
Snapshotting

表正在快照。
Replicating

表正在复制。
Reseeding

该表正在重新分配。
Stopped

表的镜像已停止。
Failed

表的 Mirroing 失败并出现错误。

TableMirroringStatusResponse

Object

表镜像状态响应。

名称 类型 说明
error

ErrorResponse

如果此表的镜像中发生错误，则设置表级别错误
metrics

TableMirroringMetrics

表的镜像指标。
sourceObjectType

TableSourceObjectType

源对象类型。
sourceSchemaName

string

源表架构名称。
sourceTableName

string

源表名称。
status

TableMirroringStatus

表的镜像状态类型。

TablesMirroringStatusResponse

Object

表镜像状态的分页列表。

名称 类型 说明
continuationToken

string

下一个结果集批处理的令牌。 如果没有更多记录，则会从响应中删除该记录。
continuationUri

string

下一个结果集批处理的 URI。 如果没有更多记录，则会从响应中删除该记录。
data

TableMirroringStatusResponse[]

表镜像状态的列表。

TableSourceObjectType

枚举

表源对象类型。 可能会随着时间的推移添加其他 TableSourceObjectType 类型。

值 说明
Table

表类型
View

视图类型