read_state_metadata fungsi bernilai tabel

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 14.3 ke atas

Mengembalikan tabel dengan baris yang mewakili metadata status kueri streaming.

Fungsi bernilai tabel untuk membaca metadata dari operator kueri streaming yang bersifat stateful. Ini hanya mendukung pengoperasian sebagai kueri batch.

Sintaks

read_state_metadata(path)

Argumen

Fungsi ini memerlukan pemanggilan parameter bernama untuk kunci pilihan.

  • path: Literal STRING dengan jalur lokasi titik pemeriksaan kueri streaming.

Pengembalian

Tabel metadata status memiliki skema berikut. Semua kolom TIDAK NULL.

  • operatorId INT NOT NULL

    Id bilangan bulat dari operator streaming berstatus stateful.

  • operatorName STRING NOT NULL

    Nama operator stateful streaming.

  • stateStoreName STRING NOT NULL

    Nama penyimpanan status operator.

  • numPartitions INT NOT NULL

    Jumlah partisi penyimpanan status.

  • minBatchId BIGINT NOT NULL

    ID batch minimum yang tersedia untuk status kueri. Nilai bisa tidak valid jika kueri streaming yang mengambil titik pemeriksaan sedang berjalan, karena hal itu dapat menyebabkan proses pembersihan berjalan.

  • maxBatchId BIGINT NOT NULL

    ID batch maksimum yang tersedia untuk menanyakan status. Nilai mungkin tidak valid jika kueri streaming yang sedang mengambil titik pemeriksaan masih berjalan, karena kueri tersebut akan memproses lebih banyak kumpulan data.

Contoh

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