Перейти к содержимому
Последнее обновление

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
  • Логический тип: BOOLEAN
  • Типы IP: IPV4, IPV6
  • Сложные типы: ARRAY, MAP, STRUCT

Возвращаемое значение​

Тип возвращаемого значения: BIGINT

Значение результата:

  • Возвращает индекс последнего элемента массива, удовлетворяющего лямбда-выражению. Отсчёт индексов начинается с 1, а не с 0. Если найденный элемент, удовлетворяющий условию, является первым элементом массива, функция возвращает 1, а не 0
  • 0: если входной массив имеет значение NULL и лямбда-выражение не задано, массив пуст или ни один элемент не удовлетворяет условию

Примечания по использованию:

  • Число параметров лямбда-выражения должно совпадать с числом массивов, переданных в качестве параметров
  • Для пустых массивов возвращается 0. Если входной параметр — массив со значением NULL и лямбда-выражение не задано, возвращается 0. Если входной параметр — массив со значением NULL и задано лямбда-выражение, возникает ошибка
  • Если передано несколько массивов, все они должны иметь одинаковую длину
  • В лямбда-выражении можно использовать любые скалярные выражения, но нельзя использовать агрегатные функции
  • Лямбда-выражения могут вызывать другие функции высшего порядка, но типы возвращаемых значений должны быть совместимы
  • Обработка значений 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