メインコンテンツまでスキップ
バージョン: 26.x

ARRAY_LAST_INDEX

array_last_index​

デスクリプション​

ラムダ式を満たす配列内の最後の要素の位置インデックス（1から開始）を見つけます。条件を満たす最後の要素を見つけて、その位置インデックスを返します。

Syntax​

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

パラメータ​

  • lambda：検索条件を定義するために使用されるlambda式
  • arr1, arr2, ...：ARRAY型、検索対象の配列。1つ以上の配列パラメータをサポートします。

Tでサポートされる型：

  • 数値型：TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、DECIMAL
  • 文字列型：CHAR、VARCHAR、STRING
  • 日付・時刻型：DATE、DATETIME、DATEV2、DATETIMEV2
  • ブール型：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_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配列とlambda式の組み合わせ。NULLを含むlambda式がある場合、エラーになります。lambda式がない場合は、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値を含む配列では、lambdaで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 |
+-------------------------------------------------------------------+

多重配列検索において、最初の配列が2番目の配列より大きい最後の要素の位置インデックスを見つけます：

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...)]

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

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))

Keywords​

ARRAY、LAST、INDEX、ARRAY_LAST_INDEX