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

ARRAY_LAST

array_last​

SinceVersion 2.0.0

Описание​

Находит последний элемент массива, удовлетворяющий лямбда-выражению. Находит последний элемент, удовлетворяющий условию, и возвращает его.

Синтаксис​

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

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

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

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

  • Возвращает последний элемент массива, удовлетворяющий лямбда-выражению
  • NULL: если ни один элемент не удовлетворяет условию или входной массив равен NULL

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

  • Количество параметров лямбда-выражения должно совпадать с количеством параметров-массивов
  • Если ни один элемент не удовлетворяет условию, возвращается NULL
  • Входные параметры со значением NULL не поддерживаются
  • При передаче нескольких параметров-массивов все массивы должны иметь одинаковую длину
  • Лямбда-выражение может использовать любое скалярное выражение, но не может использовать агрегатные функции
  • Лямбда-выражения могут вызывать другие функции высшего порядка, но типы возвращаемых значений должны быть совместимы
  • Обработка значений null в элементах массива: элементы null передаются в лямбда-выражение для обработки, и оно может проверять значения на null

Примеры запросов:

Поиск последнего элемента, который больше или равен 3, в массиве чисел с плавающей точкой:

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

Поиск последнего элемента длиной больше 2 в массиве строк:

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

Для пустого массива возвращается NULL:

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

Входной параметр со значением NULL вызывает ошибку:

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

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

Массив со значениями null: лямбда-выражение может проверять значения на null:

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

Поиск по нескольким массивам: найти последний элемент первого массива, который больше соответствующего элемента второго массива:

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

Поиск во вложенном массиве: найти последний подмассив, длина которого больше 2:

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

Ошибка при неверном количестве параметров:

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

Ошибка при несовпадении количества параметров лямбда-выражения с количеством параметров-массивов:

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

Ключевые слова​

ARRAY, LAST, ARRAY_LAST

Report issue