Comment lire un diagramme de syntaxe

Article
03/01/2024

S’applique à : case marquée oui Databricks SQL Databricks Runtime

Cette section décrit les différents modèles de syntaxe utilisés dans la référence SQL.

Composants de base

Mot clé
Jeton
Clause
Argument

Mot clé

SELECT

Les mots clés dans SQL sont toujours écrits en majuscules dans ce document, mais ils ne respectent pas la casse.

par jeton

( )
<  >
.
*
,

Le langage SQL inclut des parenthèses ((, )) ainsi que des chevrons (<, >), des points (.), des virgules (,) et quelques autres caractères. Lorsque ces caractères sont présents dans un diagramme de syntaxe, vous devez les entrer tels quels.

Clause

LIMIT clause

SELECT named_expression

named_expression
  expression AS alias

Une clause représente une sous-section de syntaxe nommée. Une clause locale est décrite dans le même diagramme de syntaxe qui l’appelle. si la clause est courante, elle est liée à une autre section de la référence SQL Databricks. Certaines clauses sont connues par leur keyword principal et représentées par un mot clé en majuscule suivi de la clause. Les autres clauses sont toujours en minuscules et utilisent le trait de soulignement (_) le cas échéant. Les clauses locales sont expliquées en détail dans la section suivante. Toutes les autres clauses comportent une brève description avec un lien vers la page principale.

Argument

mapExpr

Les arguments des fonctions sont spécifiés avec une casse mixte. Databricks SQL décrit la signification des arguments dans la section Arguments.

Chaîne de jetons

SELECT expr

Les composants séparés par des espaces blancs doivent être entrés dans l’ordre, de manière inconditionnelle, et séparés uniquement par un espace blanc ou des commentaires. Databricks SQL prend en charge les commentaires dans le formulaire /* ... */ (style C), et -- ..., qui s'étendent jusqu'à la fin de la ligne.

Choice

Spécifie une duplication (fork) dans la syntaxe.

Choix obligatoire

{ INT | INTEGER }

Les accolades { ... } signifient que vous devez spécifier exactement un des multiples composants. Chaque choix est séparé par un |.

Choix facultatif

[ ASC | DESC ]

Les crochets [ ... ] indiquent que vous pouvez choisir au maximum un composant parmi plusieurs. Chaque choix est séparé par un |.

Regroupement

{ SELECT expr }

{ SELECT
 expr }

Les accolades { ... } indiquent que vous devez fournir tous les composants intégrés. Si un diagramme de syntaxe s’étend sur plusieurs lignes, ce formulaire spécifie qu’il représente la même syntaxe.

Option

[ NOT NULL ]

Les crochets [...] indiquent que les composants inclus sont facultatifs.

Répétition

col_option [...]

col_alias [, ...]

{ expr [ AS ] col_alias } [, ...]

L’ellipse [...] indique que vous pouvez répéter plusieurs fois le composant, le groupement ou le choix qui précède immédiatement. Si l'ellipse est précédée d'un autre caractère, tel qu'un point séparé [. ...] ou une virgule [, ...], vous devez séparer chaque répétition par ce caractère.

Partager via