Mirroring - Get Tables Mirroring Status

Služba:

MirroredDatabase

Verze rozhraní API:

v1

Získejte stav zrcadlení tabulek.
Toto rozhraní API podporuje stránkování.

Dovolení

Volající musí mít oprávnění ke čtení pro zrcadlenou databázi.

Požadované delegovaná rozsahy

MirroredDatabase.Read.All nebo MirroredDatabase.ReadWrite.All nebo Item.Read.All nebo Item.ReadWrite.All

Podporované identity Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita	Podpora
Uživatel	Ano
instančního objektu a spravované identity	Ano

Rozhraní

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mirroredDatabases/{mirroredDatabaseId}/getTablesMirroringStatus

S volitelnými parametry:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mirroredDatabases/{mirroredDatabaseId}/getTablesMirroringStatus?continuationToken={continuationToken}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
mirroredDatabaseId	path	True	string (uuid)	ID zrcadlené databáze.
workspaceId	path	True	string (uuid)	ID pracovního prostoru.
continuationToken	query		string	Token pro načtení další stránky výsledků.

Odpovědi

Name	Typ	Description
200 OK	TablesMirroringStatusResponse	Žádost byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Běžné kódy chyb: Neznámá chyba – došlo k chybě.

Příklady

Get tables mirroring status example

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

200

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

Definice

Name	Description
ErrorRelatedResource	Chyba související s objektem podrobností o prostředku.
ErrorResponse	Odpověď na chybu.
ErrorResponseDetails	Podrobnosti o odpovědi na chybu.
TableMirroringMetrics	Metriky zrcadlení tabulek
TableMirroringStatus	Typ stavu zrcadlení tabulky. V průběhu času je možné přidat další typy TableMirroringStatus.
TableMirroringStatusResponse	Odpověď na stav zrcadlení tabulky
TablesMirroringStatusResponse	Stránkovaný seznam stavů zrcadlení tabulek.
TableSourceObjectType	Typ zdrojového objektu tabulky. V průběhu času je možné přidat další typy TableSourceObjectType.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name	Typ	Description
resourceId	string	ID prostředku, které je součástí chyby.
resourceType	string	Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
moreDetails	ErrorResponseDetails[]	Seznam dalších podrobností o chybě
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou
requestId	string	ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou

TableMirroringMetrics

Objekt

Metriky zrcadlení tabulek

Name	Typ	Description
lastSyncDateTime	string (date-time)	Čas posledního zpracování tabulky v UTC pomocí formátu RRRR-MM-DDTHH:mm:ssZ.
lastSyncLatencyInSeconds	integer (int32)	Latence v sekundách mezi časem potvrzení zdroje a cílovým časem potvrzení poslední zpracované změny Pro zdroje, jejichž čas potvrzení zdroje není k dispozici, tato hodnota není vrácena.
processedBytes	integer (int64)	Zpracované bajty pro tuto tabulku
processedRows	integer (int64)	Zpracovaný počet řádků pro tuto tabulku

TableMirroringStatus

Výčet

Typ stavu zrcadlení tabulky. V průběhu času je možné přidat další typy TableMirroringStatus.

Hodnota	Description
Initialized	Inicializuje se mirroing tabulky.
Snapshotting	Tabulka vytváří snímky.
Replicating	Tabulka se replikuje.
Reseeding	Tabulka se znovu aktualizuje.
Stopped	Zrcadlení tabulky je zastaveno.
Failed	Mirroing tabulky selhal s chybou.

TableMirroringStatusResponse

Objekt

Odpověď na stav zrcadlení tabulky

Name	Typ	Description
error	ErrorResponse	Chyba na úrovni tabulky se nastaví, pokud dojde k chybě při zrcadlení této tabulky.
metrics	TableMirroringMetrics	Metriky zrcadlení tabulky.
sourceObjectType	TableSourceObjectType	Typ zdrojového objektu.
sourceSchemaName	string	Název schématu zdrojové tabulky
sourceTableName	string	Název zdrojové tabulky
status	TableMirroringStatus	Typ stavu zrcadlení tabulky.

TablesMirroringStatusResponse

Objekt

Stránkovaný seznam stavů zrcadlení tabulek.

Name	Typ	Description
continuationToken	string	Token pro další dávku sady výsledků. Pokud neexistují žádné další záznamy, odebere se z odpovědi.
continuationUri	string	Identifikátor URI další dávky sady výsledků. Pokud neexistují žádné další záznamy, odebere se z odpovědi.
data	TableMirroringStatusResponse[]	Seznam stavů zrcadlení tabulky

TableSourceObjectType

Výčet

Typ zdrojového objektu tabulky. V průběhu času je možné přidat další typy TableSourceObjectType.

Hodnota	Description
Table	Typ tabulky
View	Typ zobrazení