data_skipping_summary funzione con valori di tabella

Si applica a:spunta sì Databricks SQL spuntato sì Databricks Runtime 19 e superiori

Restituisce una riga per ogni colonna di foglie in una tabella di Delta Lake o Apache Iceberg gestita. Ogni riga riporta se la colonna è idonea per il salto dei dati e la percentuale di file nell'istantanea corrente della tabella che contengono statistiche minime e massime per la colonna.

Questa funzione legge il registro delle tabelle e non scansiona i file dati.

Requirements

Per invocare questa funzione, devi avere il SELECT privilegio sul tavolo.

Syntax

data_skipping_summary( TABLE ( table_name ) )

Arguments

  • table_name: Un identificatore a tre parti che specifica la tabella.

    La funzione supporta i seguenti tipi di tabelle:

    • Tabelle gestite ed esterne del Delta Lake
    • Tabelle Apache gestite con Iceberg e tabelle Delta Lake con le letture Iceberg abilitate
    • Tabelle in streaming
    • viste materializzate
    • Cloni superficiali gestiti ed esterni

    La funzione non supporta le metric view, le tabelle straniere o le view.

Restituzioni

La funzione restituisce le seguenti colonne:

  • column_name STRING NOT NULL: Il nome della colonna logica. I campi di strutture annidate usano percorsi punteggiati, come address.street.
  • data_type STRING NOT NULL: Il tipo di dato SQL di Spark, formattato come in DESCRIBE TABLE.
  • is_partition_column BOOLEAN NOT NULL: true se la colonna fa parte della specifica della partizione della tabella.
  • is_clustering_column BOOLEAN NOT NULL: true se la colonna è una chiave di clustering liquido.
  • data_skipping_eligible BOOLEAN NOT NULL: true se la tabella raccoglie dati saltando statistiche per la colonna.
  • data_skipping_excluded_reason STRING: Il motivo per cui una colonna non è idonea per il salto dei dati. Il valore è NULL quando la colonna è idonea. Altrimenti, il valore è uno dei seguenti:
    • IS_PARTITION_COLUMN: La colonna è una colonna di partizione. Le colonne di partizione utilizzano un meccanismo separato di salto dati.
    • NOT_IN_INDEXED_COLUMN_SET: La colonna non è configurata per la raccolta delle statistiche.
    • TYPE_NOT_ELIGIBLE: Il tipo di dato della colonna non supporta il salto di dati statistiche.
  • stats_coverage_pct DOUBLE: La percentuale di file nello snapshot corrente della tabella che contengono statistiche minime e massime per la colonna, da 0.0 fino a 100.0. Il valore è NULL quando la colonna non è idonea.

MAP Colonne, ARRAY colonne e STRUCT contenitori non sono idonei per le statistiche di salto dei dati. Le foglie all'interno di una STRUCT vengono valutate separatamente.

Una VARIANT colonna è riportata come una colonna di foglia. È idoneo solo se vengono raccolte statistiche di salto di dati varianti per essa. La funzione non elenca VARIANT i sottopercorsi.

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

Risorse aggiuntive

  • Ultimo aggiornamento: