Sdílet prostřednictvím

read_state_metadata table-valued – funkce

  • Článek

Platí pro: zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného 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ů dotazu streamování. 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í.

  • pathSTRING: 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 stavového operátoru streamování

  • stateStoreName STRING NOT NULL

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

  • numPartitions INT NOT NULL

    Počet oddílů úložiště stavů

  • 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ý dotaz streamování, který provádí kontrolní bod, protože by to způsobilo vyčištění.

  • maxBatchId BIGINT NOT NULL

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

Příklady

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