Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Berlaku untuk:
Databricks SQL
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, sepertiaddress.street. -
data_type STRING NOT NULL: Tipe data Spark SQL, diformat sepertiDESCRIBE TABLEdi . -
is_partition_column BOOLEAN NOT NULL:truejika kolom merupakan bagian dari spesifikasi partisi tabel. -
is_clustering_column BOOLEAN NOT NULL:truejika kolom adalah kunci clustering cair. -
data_skipping_eligible BOOLEAN NOT NULL:truejika tabel mengumpulkan statistik yang melewati data untuk kolom. -
data_skipping_excluded_reason STRING: Alasan mengapa sebuah kolom tidak memenuhi syarat untuk lompatan data. Nilainya adalahNULLketika 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, dari0.0hingga100.0. Nilainya adalahNULLketika 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