SQL 变量¶

变量标识符¶

SQL 变量使用不区分大小写的名称进行全局标识。

变量 DDL¶

Snowflake 提供了以下使用 SQL 变量的 DDL 命令：

• SET

• UNSET

• SHOW VARIABLES

使用 SQL 初始化会话中的变量¶

可以使用 SET 命令在 SQL 中初始化变量。变量的数据类型派生自计算表达式结果的数据类型。

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

Copy

可以在同一语句中初始化多个变量，从而减少与服务器的往返通信次数。

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

Copy

在连接时设置变量¶

除了使用 SET 在会话中设置变量之外，在 Snowflake 中用于初始化会话的连接字符串中，还可以将变量作为为实参传递。若连接字符串的规范是唯一可能的自定义工具，这时候使用工具尤其有用。

例如，使用 Snowflake JDBC 驱动程序，您可以对将解释为参数的其他连接属性进行设置。请注意，JDBC API 要求 SQL 变量是字符串。

// 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

查看会话的变量¶

若要查看当前会话中定义的所有变量，请使用 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

会话变量函数¶

为操作会话变量提供以下方便使用的函数，以支持与其他数据库系统的兼容性，并通过不支持 $ 语法的工具发出 SQL，以便访问变量。请注意，所有这些函数都接受并返回字符串形式的会话变量值：

• SYS_CONTEXT 和 SET_SYS_CONTEXT

• SESSION_CONTEXT 和 SET_SESSION_CONTEXT

• GETVARIABLE 和 SETVARIABLE

以下是使用 GETVARIABLE 的示例。首先，使用 SET 命令定义变量：

SET var_artist_name = 'Jackson Browne';

Copy

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

返回变量值：

SELECT GETVARIABLE('var_artist_name');

Copy

在此示例中，输出是 NULL，因为 Snowflake 存储的变量都是大写字母。

更新大小写：

SELECT GETVARIABLE('VAR_ARTIST_NAME');

Copy

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

您可以在 WHERE 子句中使用变量名称，例如：

SELECT album_title
  FROM albums
  WHERE artist = $VAR_ARTIST_NAME;

Copy