ユーザー定義変数
このドキュメントでは、TiDB のユーザー定義変数の概念と、ユーザー定義変数を設定および読み取る方法について説明します。
ユーザー定義変数の形式は@var_name
です。 var_name
を構成する文字は、数字0-9
、文字a-zA-Z
、アンダースコア_
、ドル記号$
、UTF-8 文字など、識別子を構成できる任意の文字にすることができます。さらに、英語のピリオド.
も含まれます。ユーザー定義変数は大文字と小文字を区別しません。
ユーザー定義変数はセッション固有であるため、1 つのクライアント接続で定義されたユーザー変数は、他のクライアント接続では表示または使用できません。
ユーザー定義変数を設定する
SET
ステートメントを使用してユーザー定義変数を設定できます。構文はSET @var_name = expr [, @var_name = expr] ...;
です。例:
SET @favorite_db = 'TiDB';
SET @a = 'a', @b = 'b', @c = 'c';
代入演算子には:=
使用できます。例:
SET @favorite_db := 'TiDB';
代入演算子の右側の内容は、任意の有効な式にすることができます。例:
SET @c = @a + @b;
SET @c = b'1000001' + b'1000001';
ユーザー定義変数を読み取る
ユーザー定義変数を読み取るには、 SELECT
ステートメントを使用してクエリを実行します。
SELECT @a1, @a2, @a3
+------+------+------+
| @a1 | @a2 | @a3 |
+------+------+------+
| 1 | 2 | 4 |
+------+------+------+
SELECT
ステートメントで値を割り当てることもできます。
SELECT @a1, @a2, @a3, @a4 := @a1+@a2+@a3;
+------+------+------+--------------------+
| @a1 | @a2 | @a3 | @a4 := @a1+@a2+@a3 |
+------+------+------+--------------------+
| 1 | 2 | 4 | 7 |
+------+------+------+--------------------+
変数@a4
が変更される前、または接続が閉じられる前は、その値は常に7
です。
ユーザー定義変数を設定するときに 16 進数リテラルまたはバイナリ リテラルが使用される場合、TiDB はそれをバイナリ文字列として扱います。数値に設定する場合は、手動でCAST
変換を追加するか、式で数値演算子を使用します。
SET @v1 = b'1000001';
SET @v2 = b'1000001'+0;
SET @v3 = CAST(b'1000001' AS UNSIGNED);
SELECT @v1, @v2, @v3;
+------+------+------+
| @v1 | @v2 | @v3 |
+------+------+------+
| A | 65 | 65 |
+------+------+------+
初期化されていないユーザー定義変数を参照すると、その値は NULL になり、型は文字列になります。
SELECT @not_exist;
+------------+
| @not_exist |
+------------+
| NULL |
+------------+
SELECT
ステートメントを使用してユーザー定義変数を読み取ることに加えて、もう 1 つの一般的な使用法はPREPARE
ステートメントです。例:
SET @s = 'SELECT SQRT(POW(?,2) + POW(?,2)) AS hypotenuse';
PREPARE stmt FROM @s;
SET @a = 6;
SET @b = 8;
EXECUTE stmt USING @a, @b;
+------------+
| hypotenuse |
+------------+
| 10 |
+------------+
ユーザー定義変数の内容は、SQL ステートメント内の識別子として認識されません。例:
SELECT * from t;
+---+
| a |
+---+
| 1 |
+---+
SET @col = "`a`";
SELECT @col FROM t;
+------+
| @col |
+------+
| `a` |
+------+
MySQL 互換性
SELECT ... INTO <variable>
を除いて、MySQL と TiDB でサポートされる構文は同一です。
詳細についてはMySQL のユーザー定義変数参照してください。