read_state_metadata tabulková hodnotová funkce

Platí pro: Databricks SQL 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');

Související články

• CREATE STREAMING TABLE
• read_kafka tabulkově hodnotová funkce