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

ARRAY_LAST_INDEX

array_last_index​

SinceVersion 2.0.0

機能​

ラムダ式の条件を満たす配列内の最後の要素を探し、その位置を 1 から始まるインデックスで返します。

構文​

array_last_index(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

戻り値​

戻り値の型: BIGINT

戻り値の意味:

  • ラムダ式の条件を満たす配列内の最後の要素の位置を返します。位置は 0 ではなく 1 から数えます。条件を満たす要素が配列の最初の要素である場合は、0 ではなく 1 を返します。
  • 0: 入力配列が NULL でラムダ式がない場合、配列が空の場合、または条件を満たす要素がない場合

使用上の注意:

  • ラムダ式の引数の数は、配列引数の数と一致する必要があります。
  • 空の配列を指定すると 0 を返します。ラムダ式を指定せずに NULL 配列を渡した場合も 0 を返します。ラムダ式とともに NULL 配列を渡すとエラーになります。
  • 配列引数を複数指定する場合、すべての配列の長さが同じである必要があります。
  • ラムダ式には任意のスカラー式を使用できますが、集約関数は使用できません。
  • ラムダ式から他の高階関数を呼び出すこともできますが、戻り値の型に互換性がある必要があります。
  • 配列要素が NULL の場合、その要素はラムダ式に渡されます。ラムダ式で NULL かどうかを判定できます。

クエリ例:

浮動小数点数の配列で、3 以上の最後の要素の位置を求めます:

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

文字列の配列で、長さが 2 を超える最後の要素の位置を求めます:

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

空の配列を指定すると 0 を返します:

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

NULL 配列とラムダ式を組み合わせた場合です。ラムダ式とともに NULL を渡すとエラーになります。ラムダ式がない場合は 0 を返します:

SELECT array_last_index(NULL);
+-------------------------+
| array_last_index(NULL) |
+-------------------------+
|                       0 |
+-------------------------+

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

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

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

複数の配列を検索し、最初の配列の値が次の配列の値より大きい最後の要素の位置を求めます:

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

入れ子の配列を検索し、部分配列の長さが 2 を超える最後の要素の位置を求めます:

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

Map 型の配列を検索し、キー 'a' に対応する値が 10 を超える最後の要素の位置を求めます:

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

引数の数が正しくない場合はエラーになります:

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

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

SELECT array_last_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_last_index(x -> x > 0, 'not_an_array');
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not find the compatibility function signature: array_last_index(Expression, VARCHAR(12))

キーワード​

ARRAY, LAST, INDEX, ARRAY_LAST_INDEX

Report issue