ユーザー定義変数
このトピックでは、ユーザー定義変数の宣言と使用方法について説明します。
StarRocks 2.5以降のバージョンでは、ユーザー定義変数をサポートしています。これらの変数は、後の SQL ステートメントで参照される特定の値を格納するために使用され、SQL ステートメントの記述を簡素化し、重複した計算を避けることができます。
使用上の注意
- ユーザー定義変数は、ユーザーが作成できるセッション内に存在する変数です。これは、他のユーザーによって宣言されたユーザー定義変数に誰もアクセスできず、セッションが閉じられるとこれらの変数が期限切れになることを意味します。
- StarRocks は、SHOW ステートメントを使用して既存のユーザー定義変数を表示することをサポートしていません。
- 次のタイプの値は、ユーザー定義変数として宣言できません: BITMAP、HLL、および PERCENTILE。JSON タイプのユーザー定義変数は、保存のために STRING タイプに変換 されます。
- v3.2.7以降、StarRocks はユーザー定義変数として ARRAY タイプをサポートしています。
ユーザー定義変数の宣言
構文
SET @var_name = expr [, ...];
注意
- すべての変数は、単一のアットマーク (@) を前に付ける必要があります。
- 複数の変数は同じ SET ステートメントで宣言でき、カンマ (
,) で区切る必要があります。- 同じ変数を複数回宣言できます。新しく宣言された値は元の値を上書きします。
- 宣言されていない変数が使用された場合、その変数の値はデフォルトで
NULLであり、NULL タイプは STRING です。
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
| var_name | はい | ユーザー定義変数の名前。命名規則は次のとおりです:
|
| expr | はい | ユーザー定義変数の値。このパラメータには、数値 (例: 43) または複雑な式 (例: SELECT ステートメントによって返される値) を指定できます。変数のデータ型は、式によって返される結果のデータ型と同じです。 |
例
例 1: 数値をユーザー定義変数として宣言します。
SET @var = 43;
例 2: SELECT クエリによって返される値をユーザー定義変数として宣言します。
SET @var = (SELECT SUM(v1) FROM test);
例 3: 同じ SET ステートメントで複数のユーザー定義変数を宣言します。
SET @v1=1, @v2=2;
SQL でユーザー定義変数を使用する
-
SQL ステートメントの記述を簡素化します。たとえば、次の SELECT ステートメントを実行すると、StarRocks は
@varを1として解析します。SET @var = 1;
SELECT @var, v1 from test; -
重複した 計算を避けます。たとえば、次の SELECT ステートメントを実行すると、StarRocks は
@varをselect sum(c1) from tblコマンドによって返される結果として解析します。SET @var = (select sum(c1) from tbl);
SELECT @var, v1 from test;
