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.

Les accolades sont également utilisées avec des barres verticales pour délimiter les choix lorsque plusieurs choix sont disponibles.

Dans les deux cas, les accolades ne doivent pas être saisies.

[ ITEM ] , [ item1 item2 ... ]

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

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. Les crochets ou les accolades ne doivent être pas être saisis.

... (ellipse)

Le point précédent peut être répété un nombre illimité de fois.

Exemples

Dans ce qui suit, le mot-clé WORK est facultatif :

BEGIN [ WORK ]

Par conséquent, l’un ou l’autre des éléments suivants sont valides :

BEGIN;
BEGIN WORK;

Dans ce qui suit, vous pouvez utiliser le mot-clé WORK ou le mot-clé TRANSACTION. Vous ne devez pas utiliser les deux. Vous pouvez omettre les deux.

BEGIN [ { WORK | TRANSACTION } ]

Par conséquent, tous les éléments suivants sont valides :

BEGIN;
BEGIN WORK;
BEGIN TRANSACTION;

Voici la syntaxe d’un appel de fonction qui accepte un argument. Les parenthèses sont obligatoires. <nom_fonction>, <nom_argument>, et <type_données> doivent être remplacés par les noms réels :

create function <function_name>( <argument_name> <data_type> )

Par conséquent, ce qui suit est valable :

create function my_function(my_argument integer)

Ce qui suit montre une fonction qui nécessite au moins un argument et accepte des arguments supplémentaires facultatifs.

<function_name>( <argument_name> <data_type> [ , <argument_name> data_type ] ... )

Par conséquent, ce qui suit est valide :

my_function(argument_1 integer)
my_function(argument_1 integer, argument_2 integer)
my_function(argument_1 integer, argument_2 integer, argument_3 varchar)

Dans ce cas, des arguments supplémentaires sont également autorisés.

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.