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

ARRAY_FIRST

array_first​

SinceVersion 2.0.0

説明​

ラムダ式の条件を満たす配列内の最初の要素を返します。この関数は配列の各要素にラムダ式を適用し、条件を満たす最初の要素を見つけて返します。

構文​

array_first(lambda, array1, ...)

パラメータ​

  • lambda：配列の要素を評価するラムダ式。true/false、または真偽値に変換できる式を返します
  • array1, ...：一つ以上の 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

戻り値​

戻り値の型：T

戻り値の意味：

  • ラムダ式の条件を満たす配列内の最初の要素を返します
  • NULL：配列が空の場合、または条件を満たす要素がない場合

使用上の注意：

  • ラムダ式のパラメータ数は配列パラメータの数と一致する必要があります
  • 入力配列はすべて同じ長さである必要があります
  • 複数の配列および複合型の配列を対象に検索できます
  • 空の配列は NULL を返します
  • NULL の入力パラメータはサポートされません
  • ラムダ式では任意のスカラー式を使用できますが、集約関数は使用できません
  • ラムダ式からほかの高階関数を呼び出せますが、戻り値の型に互換性が必要です
  • 配列要素が null の場合、その要素はラムダ式に渡されて処理されます。ラムダ式で null かどうかを判定できます

クエリ例：

浮動小数点数の配列から、3 以上の最初の要素を検索します：

SELECT array_first(x -> x >= 3, [1.1, 2.2, 3.3, 4.4, 5.5]);
+-----------------------------------------------------+
| array_first(x -> x >= 3, [1.1, 2.2, 3.3, 4.4, 5.5]) |
+-----------------------------------------------------+
|                                                 3.3 |
+-----------------------------------------------------+

文字列の配列から、長さが 2 を超える最初の要素を検索します：

SELECT array_first(x -> length(x) > 2, ['a', 'bb', 'ccc', 'dddd', 'eeeee']);
+----------------------------------------------------------------------+
| array_first(x -> length(x) > 2, ['a', 'bb', 'ccc', 'dddd', 'eeeee']) |
+----------------------------------------------------------------------+
| ccc                                                                  |
+----------------------------------------------------------------------+

空の配列は NULL を返します：

SELECT array_first(x -> x > 0, []);
+-------------------------------------+
| array_first(x -> x > 0, [])        |
+-------------------------------------+
| NULL                                |
+-------------------------------------+

NULL の入力パラメータを指定するとエラーになります：

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

SELECT array_first(NULL);
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not build function: 'array_first', expression: array_first(NULL), The 1st arg of array_filter must be lambda but is NULL

null 値を含む配列では、ラムダ式で null かどうかを判定できます：

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

複数の配列を対象に検索し、最初の配列の要素が二番目の配列の要素より大きくなる最初の要素を検索します：

SELECT array_first((x, y) -> x > y, [1, 2, 3, 4, 5], [1.1, 2.2, 3.3, 4.4, 5.5]);
+--------------------------------------------------------------------------+
| array_first((x, y) -> x > y, [1, 2, 3, 4, 5], [1.1, 2.2, 3.3, 4.4, 5.5]) |
+--------------------------------------------------------------------------+
|                                                                     NULL |
+--------------------------------------------------------------------------+

複合型の例：

ネストした配列から、長さが 2 を超える最初の部分配列を検索します：

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

MAP 型の配列から、キー 'a' に対応する値が 10 を超える最初の要素を検索します：

SELECT array_first(x -> x['a'] > 10, [{'a':5}, {'a':15}, {'a':20}]);
+---------------------------------------------------------------+
| array_first(x -> x['a'] > 10, [{'a':5}, {'a':15}, {'a':20}]) |
+---------------------------------------------------------------+
| {"a":15}                                                      |
+---------------------------------------------------------------+

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

SELECT array_first(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_first((x, y) -> x > y, [1,2,3], [4,5]);
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.6)[INVALID_ARGUMENT]in array map function, the input column size are not equal completely, nested column data rows 1st size is 3, 2th size is 2.

配列以外の型を渡すとエラーになります：

SELECT array_first(x -> x > 0, 'not_an_array');
ERROR 1105 (HY000): errCode = 2, detailMessage = lambda argument must be array but is 'not_an_array'

キーワード​

ARRAY, FIRST, ARRAY_FIRST

Report issue