array_map
Description
array_map() は、高階関数としてラムダ関数を引数に取ることができる SQL 関数です。入力された配列にラムダ関数を適用し、新しい配列を返します。
array_map() は複数の配列を受け入れることができ、変数をキャプチャするためにラムダ関数とネストすることができます。ラムダ関数の詳細については、 Lambda expression を参照してください。この関数は v2.5 からサポートされています。
エイリアスは transform() です。
Syntax
array_map(lambda_function, arr1, arr2...)
array_map(arr1, arr2..., lambda_function)
Usage notes
- ラムダ関数は高階関数の 最初 または 最後 のパラメータとしてのみ使用できます。どちらの位置でも計算には影響しません。
- 配列の数はラムダ関数の入力パラメータと同じでなければなりません。そうでない場合、エラーが返されます。
- すべての配列は同じ数の要素を持っていなければなりません。そうでない場合、エラーが返されます。
Examples
Example 1: 配列の各要素を 100 増加させます。
select array_map(x -> x+100,[1,2,3]);
+------------------------------------+
| array_map(x -> x + 100, [1, 2, 3]) |
+------------------------------------+
| [101,102,103] |
+------------------------------------+
Example 2: 配列1 [1,2,3] と配列2 [11,12,13] を要素ごとに合計します。
select array_map((x,y) -> x + y, [1,2,3], [11,12,13]);
+-----------------------------------------------------+
| array_map((x, y) -> x + y, [1, 2, 3], [11, 12, 13]) |
+-----------------------------------------------------+
| [12,14,16] |
+-----------------------------------------------------+
Example 3: x の要素が 1.5 より大きいかどうかを判断します。もしそうなら、要素に対して log(x) が返されます。そうでない場合、対応する要素に対して (x+y) が返されます。
select array_map((x,y) -> if(x>1.5,log(x),x+y), [1,2,3], [11,12,13]);
+--------------------------------------------------------------------------+
| array_map((x, y) -> if(x > 1.5, log(x), x + y), [1, 2, 3], [11, 12, 13]) |
+--------------------------------------------------------------------------+
| [12,0.6931471805599453,1.0986122886681098] |
+--------------------------------------------------------------------------+
Example 4: array_map() を使用して変数をキャプチャします。値が 1 の返された要素は条件が満たされていることを示します。
-- 例のテーブルでは、last_avg は前回の試験の平均点を示します。score は現在の試験の3科目の点数を表します。
+------+----------+------------+
| id | last_avg | score |
+------+----------+------------+
| 1 | 55 | [50,60,70] |
| 2 | 73 | [70,65,75] |
| 3 | 89 | [88,92,90] |
+------+----------+------------+
-- 前回の試験の平均点より高い点数を見つけます。
select array_map(x -> x > last_avg, score) from test_tbl;
+--------------------------------------+
| array_map(x -> x > last_avg, score) |
+--------------------------------------+
| [0,1,1] |
| [0,0,1] |
| [0,1,1] |
+--------------------------------------+
Example 5: ネストされたラムダ関数を使用します。
select array_map(x -> array_map(x->x+100, x),[[1,2.3],[4,3,2]]);
+-------------------------------------------------------------------+
| array_map(x -> array_map(x -> x + 100, x), [[1, 2.3], [4, 3, 2]]) |
+-------------------------------------------------------------------+
| [[101,102.3],[104,103,102]] |
+-------------------------------------------------------------------+
Example 6: 配列の数とラムダパラメータが一致しないため、エラーが返されます。ラムダ関数は1つの配列のみを必要としますが、2つの配列が渡されています。
select array_map(x -> x,[1],[2,4]);
ERROR 1064 (HY000): Lambda arguments should equal to lambda input arrays.
