data_skipping_summary fungsi dengan nilai tabel

Berlaku untuk:tanda centang ya Databricks SQL ditandai ya Databricks Runtime 19 ke atas

Mengembalikan satu baris untuk setiap kolom daun dalam tabel Delta Lake atau tabel Apache Iceberg yang dikelola. Setiap baris melaporkan apakah kolom memenuhi syarat untuk dilewati data dan persentase file dalam snapshot tabel saat ini yang berisi statistik minimum dan maksimum untuk kolom tersebut.

Fungsi ini membaca log tabel dan tidak memindai file data.

Requirements

Untuk mengaktifkan fungsi ini, Anda harus memiliki hak istimewa di SELECT atas meja.

Syntax

data_skipping_summary( TABLE ( table_name ) )

Arguments

  • table_name: Pengenal tiga bagian yang menentukan tabel.

    Fungsi ini mendukung tipe tabel berikut:

    • Tabel Delta Lake yang dikelola dan eksternal
    • Tabel Apache Iceberg dan Delta Lake yang dikelola dengan pembacaan Iceberg diaktifkan
    • meja streaming
    • tampilan materialisasi
    • Kloning dangkal yang dikelola dan eksternal

    Fungsi ini tidak mendukung tampilan metrik, tabel asing, atau tampilan.

Returns

Fungsi ini mengembalikan kolom-kolom berikut:

  • column_name STRING NOT NULL: Nama kolom logis. Bidang struktur bersarang menggunakan jalur titik-titik, seperti address.street.
  • data_type STRING NOT NULL: Tipe data Spark SQL, diformat seperti DESCRIBE TABLEdi .
  • is_partition_column BOOLEAN NOT NULL: true jika kolom merupakan bagian dari spesifikasi partisi tabel.
  • is_clustering_column BOOLEAN NOT NULL: true jika kolom adalah kunci clustering cair.
  • data_skipping_eligible BOOLEAN NOT NULL: true jika tabel mengumpulkan statistik yang melewati data untuk kolom.
  • data_skipping_excluded_reason STRING: Alasan mengapa sebuah kolom tidak memenuhi syarat untuk lompatan data. Nilainya adalah NULL ketika kolom memenuhi syarat. Jika tidak, nilainya adalah salah satu dari berikut ini:
    • IS_PARTITION_COLUMN: Kolom adalah kolom partisi. Kolom partisi menggunakan mekanisme lompatan data yang terpisah.
    • NOT_IN_INDEXED_COLUMN_SET: Kolom tidak dikonfigurasi untuk pengumpulan statistik.
    • TYPE_NOT_ELIGIBLE: Tipe data kolom tidak mendukung statistik yang dilewati data.
  • stats_coverage_pct DOUBLE: Persentase file dalam snapshot tabel saat ini yang berisi statistik minimum dan maksimum untuk kolom, dari 0.0 hingga 100.0. Nilainya adalah NULL ketika kolom tersebut tidak memenuhi syarat.

MAP kolom, ARRAY kolom, dan STRUCT kontainer tidak memenuhi syarat untuk statistik melewatkan data. Daun dalam sebuah STRUCT dievaluasi secara terpisah.

Sebuah VARIANT kolom dilaporkan sebagai satu kolom daun. Statistik ini hanya memenuhi syarat jika statistik melewati data varian dikumpulkan untuknya. Fungsi ini tidak mencantumkan VARIANT subpath.

Examples

> SELECT * FROM data_skipping_summary(TABLE(my_catalog.my_schema.events));
  column_name  data_type            is_partition_column  is_clustering_column  data_skipping_eligible  data_skipping_excluded_reason  stats_coverage_pct
  -----------  -------------------  -------------------  --------------------  ----------------------  -----------------------------  ------------------
  event_date   date                 true                 false                 false                   IS_PARTITION_COLUMN            null
  event_type   string               false                false                 true                    null                           98.0
  user_agent   string               false                false                 false                   NOT_IN_INDEXED_COLUMN_SET      null
  metadata     map<string,string>   false                false                 false                   TYPE_NOT_ELIGIBLE              null

Sumber daya tambahan