Conventions de notation

Les conventions de notation suivantes sont utilisées dans la documentation Snowflake.

Important

Dans la description de la syntaxe et du code, les guillemets simples (<>), les crochets ([ ]), les accolades ({ }) et les barres verticales (|) sont utilisés à des fins de notation uniquement. Pour éviter les erreurs de syntaxe, ne les incluez pas lors de la saisie d’une commande ou de l’écriture de code.

Toutefois, les crochets et les accolades ont des significations spécifiques dans JSON et XML. Ils doivent donc être inclus lors de l’utilisation de documents / donnnées JSON ou XML.

Syntaxe, exemples et texte

Notation

Description

ITEM , ITEM

Tout en majuscule indique une commande, un mot-clé, un nom de paramètre ou un nom de fonction Snowflake SQL.

élément, item

Tout en minuscule indique une valeur fournie par l’utilisateur pour un identifiant, un paramètre ou un argument.

<élément> , élément

Les guillemets simples et les italiques indiquent les identificateurs, les paramètres ou les arguments fournis par les utilisateurs.

( item1 item2 ... )

Les parenthèses sont utilisées dans SQL pour regrouper des paramètres ou des arguments.

Elles sont obligatoires lors de la saisie d’une commande (c.-à-d. doivent être saisies exactement comme elles apparaissent).

{ item1 item2 ... }

Les accolades indiquent des groupements d’identifiants, de paramètres ou d’arguments. Elles ne doivent pas être entrées.

[ ITEM ] , [ item1 item2 ... ]

Les crochets indiquent les parties facultatives d’une instruction. Ils ne doivent pas être entrés.

Dans de nombreux cas, les éléments entre crochets sont facultatifs car les valeurs par défaut sont fournies.

|

Une barre verticale indique un choix entre deux ou plusieurs éléments ou valeurs, généralement entre crochets ou accolades. Elles ne doivent pas être entrées.

Données JSON

Notation

Description

[ item1 ... ]

Les crochets sont des délimiteurs de tableau JSON.

{ item1 item2 ... }

Les accolades sont des délimiteurs d’objet JSON.

Données XML

Notation

Description

<élément> ... </élément>

Les guillemets simples indiquent le début ou la fin d’un élément XML.