共用方式為

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

範例要求

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

定義

名稱 Description
ErrorRelatedResource

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

錯誤回應。
ErrorResponseDetails

錯誤回應詳細數據。
TableMirroringMetrics

數據表鏡像計量。
TableMirroringStatus

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

數據表鏡像狀態回應。
TablesMirroringStatusResponse

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

數據表來源物件類型。 可能會隨著時間新增其他 TableSourceObjectType 類型。

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 格式。
lastSyncLatencyInSeconds

integer (int32)

來源認可時間與上次處理變更的目標認可時間之間的延遲 （以秒為單位）。 對於來源確定時間無法使用的來源，不會傳回此值。
processedBytes

integer (int64)

已處理此數據表的位元組。
processedRows

integer (int64)

此數據表已處理的數據列計數。

TableMirroringStatus

列舉型別

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

值 Description
Initialized

數據表的Mirroing 已初始化。
Snapshotting

數據表正在建立快照集。
Replicating

數據表正在復寫。
Reseeding

數據表正在重新配置。
Stopped

數據表的鏡像已停止。
Failed

數據表的Mirroing 失敗，發生錯誤。

TableMirroringStatusResponse

Object

數據表鏡像狀態回應。

名稱 類型 Description
error

ErrorResponse

如果此數據表的鏡像發生錯誤，則會設定數據表層級錯誤
metrics

TableMirroringMetrics

數據表的鏡像計量。
sourceObjectType

TableSourceObjectType

來源物件類型。
sourceSchemaName

string

源數據表架構名稱。
sourceTableName

string

源數據表名稱。
status

TableMirroringStatus

數據表的鏡像狀態類型。

TablesMirroringStatusResponse

Object

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

名稱 類型 Description
continuationToken

string

下一個結果集批次的令牌。 如果沒有其他記錄，則會從回應中移除。
continuationUri

string

下一個結果集批次的 URI。 如果沒有其他記錄，則會從回應中移除。
data

TableMirroringStatusResponse[]

數據表鏡像狀態的清單。

TableSourceObjectType

列舉型別

數據表來源物件類型。 可能會隨著時間新增其他 TableSourceObjectType 類型。

值 Description
Table

數據表類型
View

檢視類型