Číst v angličtině

Sdílet prostřednictvím

read_state_metadata tabulková hodnotová funkce

  • Článek

Platí pro:zaškrtnuto ano Databricks SQL zaškrtnuto ano Databricks Runtime 14.3 a vyšší

Vrátí tabulku s řádky, které představují metadata stavu dotazu streamování.

Funkce s hodnotou tabulky pro čtení metadat stavových operátorů u streamovacích dotazů. Podporuje pouze spouštění jako dávkový dotaz.

Syntaxe

read_state_metadata(path)

Argumenty

Tato funkce vyžaduje vyvolání pojmenovaného parametru pro klíče možností.

  • path STRING: Literál s cestou umístění kontrolního bodu dotazu streamování.

Návraty

Tabulka stavových metadat má následující schéma. Všechny sloupce nemají hodnotu NULL.

  • operatorId INT NOT NULL

    Celočíselné ID stavového operátoru streamování.

  • operatorName STRING NOT NULL

    Název operátoru stavového streamování

  • stateStoreName STRING NOT NULL

    Název úložiště stavu operátora.

  • numPartitions INT NOT NULL

    Počet oddílů stavového úložiště

  • minBatchId BIGINT NOT NULL

    Minimální ID dávky, které je k dispozici pro dotazování stavu. Hodnota může být neplatná, pokud je spuštěn streamovací dotaz, který provádí kontrolní bod, protože to by vyvolalo spuštění úklidu.

  • maxBatchId BIGINT NOT NULL

    Maximální ID dávky, které je k dispozici pro dotazování stavu. Hodnota může být neplatná, pokud je streamovací dotaz, který provádí kontrolní bod, spuštěn, protože dotaz potvrdí další dávky.

Příklady

- Read state metadata from the checkpoint
> SELECT * FROM read_state_metadata('/checkpoint/path');