Condividi tramite

read_state_metadata funzione con valori di tabella

  • Articolo

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 14.3 e versioni successive

Restituisce una tabella con righe che rappresentano i metadati dello stato di una query di streaming.

Funzione per la lettura dei metadati degli operatori con stato nelle query di streaming con valori di tabella. Supporta solo l'esecuzione come query batch.

Sintassi

read_state_metadata(path)

Argomenti

Questa funzione richiede la chiamata di parametri denominati per le chiavi di opzione.

  • path: un valore STRING letterale con il percorso del checkpoint della query di streaming.

Valori restituiti

Una tabella di metadati di stato ha lo schema seguente. Tutte le colonne non sono NULL.

  • operatorId INT NOT NULL

    ID intero dell'operatore di streaming con stato.

  • operatorName STRING NOT NULL

    Nome dell'operatore di streaming con stato.

  • stateStoreName STRING NOT NULL

    Nome dell'archivio di stato dell'operatore.

  • numPartitions INT NOT NULL

    Numero di partizioni dell'archivio di stato.

  • minBatchId BIGINT NOT NULL

    ID del batch minimo disponibile per l'interrogazione dello stato. Il valore potrebbe non essere valido se la query di streaming che prende il checkpoint è in esecuzione, perché causerebbe l'avvio della pulizia.

  • maxBatchId BIGINT NOT NULL

    ID batch massimo disponibile per l'interrogazione dello stato. Il valore potrebbe non essere valido se la query di streaming che accetta il checkpoint è in esecuzione, perché la query eseguirà il commit di altri batch.

Esempi

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