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 參數

名稱	位於	必要	類型	Description
mirroredDatabaseId	path	True	string uuid	鏡像資料庫標識碼。
workspaceId	path	True	string uuid	工作區標識碼。
continuationToken	query		string	用來擷取下一頁結果的令牌。

回應

名稱	類型	Description
200 OK	TablesMirroringStatusResponse	要求成功完成。
Other Status Codes	ErrorResponse	常見的錯誤碼： UnknownError - 發生錯誤。

範例

Get tables mirroring status example

範例要求

HTTP

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

範例回覆

狀態碼:

200

{
  "data": [
    {
      "sourceSchemaName": "dbo",
      "sourceTableName": "test",
      "status": "Replicating",
      "metrics": {
        "processedBytes": 1247,
        "processedRows": 6,
        "lastSyncDateTime": "2024-10-08T05:07:11.0663362Z"
      }
    }
  ]
}

定義

名稱	Description
ErrorRelatedResource	錯誤相關的資源詳細資料物件。
ErrorResponse	錯誤回應。
ErrorResponseDetails	錯誤回應詳細數據。
TableMirroringMetrics	數據表鏡像計量。
TableMirroringStatus	數據表鏡像狀態類型。 可能會隨著時間新增其他 TableMirroringStatus 類型。
TableMirroringStatusResponse	數據表鏡像狀態回應。
TablesMirroringStatusResponse	數據表鏡像狀態的編頁清單。

ErrorRelatedResource

Object

錯誤相關的資源詳細資料物件。

名稱	類型	Description
resourceId	string	發生錯誤的資源識別碼。
resourceType	string	發生錯誤的資源類型。

ErrorResponse

Object

錯誤回應。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
moreDetails	ErrorResponseDetails[]	其他錯誤詳細數據的清單。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。
requestId	string	與錯誤相關聯的要求標識碼。

ErrorResponseDetails

Object

錯誤回應詳細數據。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。

TableMirroringMetrics

Object

數據表鏡像計量。

名稱	類型	Description
lastSyncDateTime	string date-time	上次以 UTC 格式處理資料表的時間，使用 YYYY-MM-DDTHH：mm：ssZ 格式。
processedBytes	integer int64	已處理此數據表的位元組。
processedRows	integer int64	此數據表已處理的數據列計數。

TableMirroringStatus

Enumeration

數據表鏡像狀態類型。 可能會隨著時間新增其他 TableMirroringStatus 類型。

值	Description
Failed	數據表的Mirroing 失敗，發生錯誤。
Initialized	數據表的Mirroing 已初始化。
Replicating	數據表正在復寫。
Reseeding	數據表正在重新配置。
Snapshotting	數據表正在建立快照集。
Stopped	數據表的鏡像已停止。

TableMirroringStatusResponse

Object

數據表鏡像狀態回應。

名稱	類型	Description
error	ErrorResponse	如果此數據表的鏡像發生錯誤，則會設定數據表層級錯誤
metrics	TableMirroringMetrics	數據表的鏡像計量。
sourceSchemaName	string	源數據表架構名稱。
sourceTableName	string	源數據表名稱。
status	TableMirroringStatus	數據表的鏡像狀態類型。

TablesMirroringStatusResponse

Object

數據表鏡像狀態的編頁清單。

名稱	類型	Description
continuationToken	string	下一個結果集批次的令牌。 如果沒有其他記錄，則會從回應中移除。
continuationUri	string	下一個結果集批次的 URI。 如果沒有其他記錄，則會從回應中移除。
data	TableMirroringStatusResponse[]	數據表鏡像狀態的清單。