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

この例では、Snowflakeは変数をすべて大文字で保存するため、出力は NULL になります。

大文字小文字を更新します。

SELECT GETVARIABLE('VAR_ARTIST_NAME');

Copy

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

WHERE 句の中で変数名を使うことができます。たとえば、

SELECT album_title
  FROM albums
  WHERE artist = $VAR_ARTIST_NAME;

Copy