メインコンテンツまでスキップ
に最終更新

ARRAY_MAP

array_map​

SinceVersion 2.0.0

説明​

配列の要素にラムダ式を適用し、新しい配列を返します。配列の各要素にラムダ式を適用し、それぞれに対応する結果を返します。

構文​

array_map(lambda, ARRAY<T> arr1, [ARRAY<T> arr2, ...])

パラメータ​

  • lambda：変換規則を定義するラムダ式
  • arr1, arr2, ...：変換対象の配列。型は ARRAY です。少なくとも一つの配列パラメータを指定できます。

T でサポートされる型：

  • 数値型：TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, DECIMAL
  • 文字列型：CHAR, VARCHAR, STRING
  • 日付・時刻型：DATE, DATETIME, DATEV2, DATETIMEV2, TIMESTAMP_NS
  • 真偽値型：BOOLEAN
  • IP 型：IPV4, IPV6
  • UUID：UUID
  • 複合型：ARRAY, MAP, STRUCT

戻り値​

戻り値の型：ARRAY

戻り値の意味：

  • 入力配列と同じ長さの新しい配列を返します。各位置には、対応する要素にラムダ式を適用した結果が入ります。

使用上の注意：

  • ラムダ式のパラメータ数は、配列パラメータの数と一致する必要があります
  • 入力配列パラメータに NULL は指定できません
  • 複数の配列パラメータを指定する場合、すべての配列の長さが同じである必要があります
  • ラムダ式では任意のスカラー式を使用できますが、集約関数は使用できません
  • ラムダ式からほかの高階関数を呼び出せますが、戻り値の型に互換性がある必要があります
  • 配列内の NULL 要素は処理のためにラムダ式へ渡され、ラムダ式内で NULL かどうかを確認できます

クエリ例：

配列の各要素を二乗する：

SELECT array_map(x -> x * x, [1, 2, 3, 4, 5]);
+------------------------------------------+
| array_map(x -> x * x, [1, 2, 3, 4, 5]) |
+------------------------------------------+
| [1, 4, 9, 16, 25]                       |
+------------------------------------------+

浮動小数点数の配列の各要素を丸める：

SELECT array_map(x -> round(x), [1.1, 2.7, 3.3, 4.9, 5.5]);
+--------------------------------------------------+
| array_map(x -> round(x), [1.1, 2.7, 3.3, 4.9, 5.5]) |
+--------------------------------------------------+
| [1, 3, 3, 5, 6]                                 |
+--------------------------------------------------+

文字列の配列の各要素の長さを計算する：

SELECT array_map(x -> length(x), ['a', 'bb', 'ccc', 'dddd', 'eeeee']);
+--------------------------------------------------+
| array_map(x -> length(x), ['a', 'bb', 'ccc', 'dddd', 'eeeee']) |
+--------------------------------------------------+
| [1, 2, 3, 4, 5]                                 |
+--------------------------------------------------+

NULL 値を含む配列を処理する：

SELECT array_map(x -> x is not null, [1, null, 3, null, 5]);
+--------------------------------------------------+
| array_map(x -> x is not null, [1, null, 3, null, 5]) |
+--------------------------------------------------+
| [1, 0, 1, 0, 1]                                 |
+--------------------------------------------------+

入力配列に NULL を指定すると、次のエラーが発生します：

mysql> SELECT array_map(x->x>2, NULL);
ERROR 1105 (HY000): errCode = 2, detailMessage = lambda argument must be array but is NULL

複数の配列パラメータを指定し、二つの配列の対応する要素を加算する例：

SELECT array_map((x, y) -> x + y, [1, 2, 3, 4, 5], [10, 20, 30, 40, 50]);
+--------------------------------------------------+
| array_map((x, y) -> x + y, [1, 2, 3, 4, 5], [10, 20, 30, 40, 50]) |
+--------------------------------------------------+
| [11, 22, 33, 44, 55]                             |
+--------------------------------------------------+

ネストした配列を処理し、各部分配列の長さを計算する：

SELECT array_map(x -> size(x), [[1,2],[3,4,5],[6],[7,8,9,10]]);
+--------------------------------------------------+
| array_map(x -> size(x), [[1,2],[3,4,5],[6],[7,8,9,10]]) |
+--------------------------------------------------+
| [2, 3, 1, 4]                                     |
+--------------------------------------------------+

MAP 型を処理し、各マップからキー 'a' の値を取り出す：

SELECT array_map(x -> x['a'], [{'a':1,'b':2}, {'a':3,'b':4}, {'a':5,'b':6}]);
+--------------------------------------------------+
| array_map(x -> x['a'], [{'a':1,'b':2}, {'a':3,'b':4}, {'a':5,'b':6}]) |
+--------------------------------------------------+
| [1, 3, 5]                                        |
+--------------------------------------------------+

パラメータ数が正しくない場合のエラー：

SELECT array_map();
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not found function 'array_map' which has 0 arity. Candidate functions are: [array_map(Expression, Expression...)]

ラムダ式のパラメータ数が配列パラメータの数と一致しない場合のエラー：

SELECT array_map(x -> x > 0, [1,2,3], [4,5,6], [7,8,9]);
ERROR 1105 (HY000): errCode = 2, detailMessage = lambda x -> (x > 0) arguments' size is not equal parameters' size

配列以外の型を渡した場合のエラー：

SELECT array_map(x -> x * 2, 'not_an_array');
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not find the compatibility function signature: array_map(Expression, VARCHAR(12))

キーワード​

ARRAY, MAP, ARRAY_MAP

Report issue