Comment lire un diagramme de syntaxe
S’applique à :
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é
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.