Clause * (étoile)

S’applique à : Databricks SQL Databricks Runtime

Raccourci pour nommer toutes les colonnes référençantes dans la FROM clause, ou les colonnes ou champs d’une référence de table spécifique dans la FROM clause.

La liste des colonnes ou des champs est triée selon l’ordre des références de table et l’ordre des colonnes dans chaque référence de table. Dans le cas des champs, elle est triée selon l’ordre des champs dans le struct.

La _metadata colonne n’est pas incluse dans cette liste. Vous devez la référencer explicitement.

Avant Databricks Runtime 15.0, la clause étoile (*) ne peut être utilisée que dans la SELECT liste.

Syntaxe

star_clause
   [ name . ] * [ except_clause ]

except_clause
   EXCEPT ( { column_name | field_name } [, ...] )

Paramètres

• nom

  Si le nom est un nom de table, répertorie les colonnes de la table référencée spécifiée. Si le nom est une colonne ou un nom de champ de type STRUCT, répertorie les champs de la colonne ou du champ référencé spécifié. S’il n’est pas présent, toutes les colonnes de toutes les tables référencées dans la clause FROM sont répertoriées.

• clause_d'exception

  S’applique à : Databricks SQL Databricks Runtime 11.3 LTS et versions ultérieures

  Supprime éventuellement les colonnes ou les champs de l’ensemble référencé de colonnes identifiées dans la select_star clause.

  • nom_de_colonne

    Colonne qui fait partie de l’ensemble de colonnes que vous pouvez référencer.

  • field_name

    Référence à un champ dans une colonne de l’ensemble de colonnes que vous pouvez référencer. Si vous excluez tous les champs d’un STRUCT, le résultat est un STRUCT vide.

  Chaque nom doit référencer une colonne incluse dans l’ensemble de colonnes que vous pouvez référencer ou leurs champs. Sinon, Databricks SQL génère une erreur UNRESOLVED_COLUMN. Si les noms se chevauchent ou ne sont pas uniques, Databricks SQL déclenche une erreur EXCEPT_OVERLAPPING_COLUMNS.

Exemples

– Return all columns in the FROM clause
> SELECT * FROM VALUES(1, 2) AS TA(c1, c2), VALUES('a', 'b') AS TB(ca, cb);
  1  2  a  b

– Return all columns from TA
> SELECT TA.* FROM VALUES(1, 2) AS TA(c1, c2), VALUES('a', 'b') AS TB(ca, cb);
  1  2

– Return all columns except TA.c1 and TB.cb
> SELECT * EXCEPT (c1, cb)  FROM VALUES(1, 2) AS TA(c1, c2), VALUES('a',' b') AS TB(ca, cb);
  2  a

– Return all columns, but strip the field x from the struct.
> SELECT TA.* EXCEPT (c1.x) FROM VALUES(named_struct('x', x, 'y', 'y'), 2) AS (c1, c2), VALUES('a', 'b') AS TB(ca, cb);
  { y } 2 a b

-- Return all fields in c1.
> SELECT c1.* FROM VALUES(named_struct('x', x, 'y', 'y'), 2) AS (c1, c2), VALUES('a', 'b') AS TB(ca, cb);
  x  y

– Return the first not-NULL column in TA
> SELECT coalesce(TA.*)  FROM VALUES(1, 2) AS TA(c1, c2), VALUES('a', 'b') AS TB(ca, cb);
  1

Articles connexes

• Appel de fonction
• SELECT
• Expression SQL