Variables SQL¶

Identificateurs de variables¶

Les variables SQL sont identifiées globalement à l’aide de noms insensibles à la casse.

DDL de variables¶

Snowflake fournit les commandes DDL suivantes pour l’utilisation des variables SQL :

• SET

• UNSET

• SHOW VARIABLES

Utiliser SQL pour initialiser des variables dans une session¶

Les variables peuvent être initialisées dans SQL en utilisant la commande SET. Le type de données de la variable s’appuie sur le type de données du résultat de l’expression évaluée.

SET MY_VARIABLE=10;
SET MY_VARIABLE='example';

Copy

Plusieurs variables peuvent être initialisées dans la même instruction, réduisant ainsi le nombre de communications aller-retour avec le serveur.

SET (VAR1, VAR2, VAR3)=(10, 20, 30);
SET (VAR1, VAR2, VAR3)=(SELECT 10, 20, 30);

Copy

Réglage des variables à la connexion¶

En plus d’utiliser SET pour définir des variables dans une session, les variables peuvent être transmises en arguments dans la chaîne de connexion utilisée pour initialiser une session dans Snowflake. Ceci est particulièrement utile lorsque vous utilisez des outils où la spécification de la chaîne de connexion est la seule personnalisation possible.

Par exemple, en utilisant le pilote JDBC de Snowflake, vous pouvez définir des propriétés de connexion supplémentaires qui seront interprétées comme des paramètres. Notez que l’API JDBC nécessite que des variables SQL soient des chaînes.

// build connection properties
Properties properties = new Properties();

// Required connection properties
properties.put("user"    ,  "jsmith"      );
properties.put("password",  "mypassword");
properties.put("account" ,  "myaccount");

// Set some additional variables.
properties.put("$variable_1", "some example");
properties.put("$variable_2", "1"           );

// create a new connection
String connectStr = "jdbc:snowflake://localhost:8080";

// Open a connection under the snowflake account and enable variable support
Connection con = DriverManager.getConnection(connectStr, properties);

Copy

Affichage des variables de la session¶

Pour voir toutes les variables définies dans la session actuelle, utilisez la commande SHOW VARIABLES :

SET (MIN, MAX)=(40, 70);

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+

SHOW VARIABLES;

+-------------+---------------------------------+---------------------------------+------+-------+-------+---------+
|  session_id | created_on                      | updated_on                      | name | value | type  | comment |
|-------------+---------------------------------+---------------------------------+------+-------+-------+---------|
| 34359992326 | Fri, 21 Apr 2017 11:20:32 -0700 | Fri, 21 Apr 2017 11:20:32 -0700 | MAX  | 70    | fixed |         |
| 34359992326 | Fri, 21 Apr 2017 11:20:32 -0700 | Fri, 21 Apr 2017 11:20:32 -0700 | MIN  | 40    | fixed |         |
+-------------+---------------------------------+---------------------------------+------+-------+-------+---------+

Copy

Fonctions des variables de session¶

Les fonctions de commodité suivantes sont fournies pour manipuler des variables de session afin d’assurer la compatibilité avec d’autres systèmes de base de données et d’émettre des commandes SQL au moyen d’outils qui ne prennent pas en charge la syntaxe $ d’accès aux variables. Notez que toutes ces fonctions acceptent et retournent des valeurs de variables de session sous forme de chaînes :

• SYS_CONTEXT et SET_SYS_CONTEXT

• SESSION_CONTEXT et SET_SESSION_CONTEXT

• GETVARIABLE et SETVARIABLE

Voici des exemples d’utilisation de GETVARIABLE. Définissez d’abord une variable en utilisant SET :

SET var_artist_name = 'Jackson Browne';

Copy

+----------------------------------+
| status                           |
+----------------------------------+
| Statement executed successfully. |
+----------------------------------+

Renvoyez la valeur de la variable :

SELECT GETVARIABLE('var_artist_name');

Copy

Dans cet exemple, la sortie est NULL car Snowflake stocke les variables avec des lettres majuscules.

Mise à jour de la casse :

SELECT GETVARIABLE('VAR_ARTIST_NAME');

Copy

+--------------------------------+
| GETVARIABLE('VAR_ARTIST_NAME') |
+--------------------------------+
| Jackson Browne                 |
+--------------------------------+

Vous pouvez utiliser le nom de la variable dans une clause WHERE, par exemple :

SELECT album_title
  FROM albums
  WHERE artist = $VAR_ARTIST_NAME;

Copy