ARRAY_FIRST_INDEX
array_first_index
説明
配列内でlambda式の条件を満たす最初の要素の位置インデックス（1から開始）を返します。この関数は配列の要素にlambda式を適用し、条件を満たす最初の要素を見つけてその位置インデックスを返します。
構文
array_first_index(lambda, array1, ...)
パラメータ
lambda：配列要素を評価するために使用されるlambda式で、true/falseまたはboolean値に変換可能な式を返すarray1, ...：1つ以上のARRAY型パラメータ
Tでサポートされている型:
- 数値型: TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, DECIMAL
- 文字列型: CHAR, VARCHAR, STRING
- 日付・時刻型: DATE, DATETIME, DATEV2, DATETIMEV2
- Boolean型: BOOLEAN
- IP型: IPV4, IPV6
- 複合データ型: ARRAY, MAP, STRUCT
戻り値
戻り値の型: BIGINT
戻り値の意味:
- lambda式の条件を満たす配列内の最初の要素の位置インデックスを返す。戻り値は0ではなく1から開始される。条件を満たす見つかった要素が配列の最初の要素と一致する場合、この関数は0ではなく1を返す
- 0: 入力配列がNULLでlambda式がない場合、または配列が空の場合、または条件を満たす要素がない場合
使用上の注意:
- lambda式のパラメータ数は配列パラメータの数と一致する必要がある
- すべての入力配列は同じ長さである必要がある
- 多次元配列と複合型配列での検索をサポート
- 空の配列は0を返す。入力パラメータがNULL配列でlambda式がない場合、0を返す。入力パラメータがNULL配列でlambda式がある場合、エラーになる
- Lambdaは任意のスカラ式を使用できるが、集約関数は使用できない
- Lambda式は他の高階関数を呼び出すことができるが、戻り値の型に互換性がある必要がある
- 配列要素のnull値について: null要素はlambda式に渡されて処理され、lambdaはnull値をチェックできる
クエリ例:
浮動小数点数配列で3以上の最初の要素の位置インデックスを見つける:
SELECT array_first_index(x -> x >= 3, [1.1, 2.2, 3.3, 4.4, 5.5]);
+-----------------------------------------------------------+
| array_first_index(x -> x >= 3, [1.1, 2.2, 3.3, 4.4, 5.5]) |
+-----------------------------------------------------------+
| 3 |
+-----------------------------------------------------------+
文字列配列において、長さが2より大きい最初の要素の位置インデックスを検索します：
SELECT array_first_index(x -> length(x) > 2, ['a', 'bb', 'ccc', 'dddd', 'eeeee']);
+----------------------------------------------------------------------------+
| array_first_index(x -> length(x) > 2, ['a', 'bb', 'ccc', 'dddd', 'eeeee']) |
+----------------------------------------------------------------------------+
| 3 |
+----------------------------------------------------------------------------+
空の配列は0を返します：
SELECT array_first_index(x -> x > 0, []);
+-----------------------------------+
| array_first_index(x -> x > 0, []) |
+-----------------------------------+
| 0 |
+-----------------------------------+
NULL配列とlambda式の組み合わせ。NULLを含むlambda式がある場合、エラーになります。lambda式がない場合、0を返します：
SELECT array_first_index(NULL);
+-------------------------+
| array_first_index(NULL) |
+-------------------------+
| 0 |
+-------------------------+
SELECT array_first_index(x -> x > 2, NULL);
ERROR 1105 (HY000): errCode = 2, detailMessage = lambda argument must be array but is NULL
null値を含む配列では、ラムダでnullをチェックできます：
SELECT array_first_index(x -> x is not null, [null, 1, null, 3, null, 5]);
+--------------------------------------------------------------------+
| array_first_index(x -> x is not null, [null, 1, null, 3, null, 5]) |
+--------------------------------------------------------------------+
| 2 |
+--------------------------------------------------------------------+
マルチ配列検索では、最初の配列が2番目の配列より大きい最初の要素の位置インデックスを見つけます：
SELECT array_first_index((x, y) -> x > y, [1, 2, 3, 4, 5], [1.1, 2.2, 3.3, 4.4, 5.5]);
+--------------------------------------------------------------------------------+
| array_first_index((x, y) -> x > y, [1, 2, 3, 4, 5], [1.1, 2.2, 3.3, 4.4, 5.5]) |
+--------------------------------------------------------------------------------+
| 0 |
+--------------------------------------------------------------------------------+
複合型の例：
ネストした配列の検索で、長さが2より大きい最初のサブ配列の位置インデックスを見つける：
SELECT array_first_index(x -> size(x) > 2, [[1,2],[3,4,5],[6],[7,8,9,10]]);
+---------------------------------------------------------------------+
| array_first_index(x -> size(x) > 2, [[1,2],[3,4,5],[6],[7,8,9,10]]) |
+---------------------------------------------------------------------+
| 2 |
+---------------------------------------------------------------------+
Map型の検索で、キー'a'の値が10より大きい最初の要素の位置インデックスを見つける：
SELECT array_first_index(x -> x['a'] > 10, [{'a':5}, {'a':15}, {'a':20}]);
+--------------------------------------------------------------------+
| array_first_index(x -> x['a'] > 10, [{'a':5}, {'a':15}, {'a':20}]) |
+--------------------------------------------------------------------+
| 2 |
+--------------------------------------------------------------------+
lambda式のパラメータ数が配列パラメータ数と一致しない場合のエラー：
SELECT array_first_index(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_index((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_index(x -> x > 0, 'not_an_array');
ERROR 1105 (HY000): errCode = 2, detailMessage = lambda argument must be array but is 'not_an_array'
Keywords
ARRAY、FIRST、INDEX、ARRAY_FIRST_INDEX