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

ARRAY_MAP

array_map​

SinceVersion 2.0.0

Описание​

Применяет лямбда-выражение к элементам массива и возвращает новый массив. Функция применяет лямбда-выражение к каждому элементу массива и возвращает соответствующий результат.

Синтаксис​

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

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

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

Описание возвращаемого значения:

  • Возвращает новый массив той же длины, что и входной массив. Каждая позиция содержит результат применения лямбда-выражения к соответствующему элементу

Особенности использования:

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

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

Возведение каждого элемента массива в квадрат:

SELECT array_map(x -> x * x, [1, 2, 3, 4, 5]);
+------------------------------------------+
| array_map(x -> x * x, [1, 2, 3, 4, 5]) |
+------------------------------------------+
| [1, 4, 9, 16, 25]                       |
+------------------------------------------+

Округление каждого элемента массива чисел с плавающей точкой:

SELECT array_map(x -> round(x), [1.1, 2.7, 3.3, 4.9, 5.5]);
+--------------------------------------------------+
| array_map(x -> round(x), [1.1, 2.7, 3.3, 4.9, 5.5]) |
+--------------------------------------------------+
| [1, 3, 3, 5, 6]                                 |
+--------------------------------------------------+

Вычисление длины каждого элемента массива строк:

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

Обработка массива, содержащего значения null:

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

Передача NULL в array_map приводит к ошибке:

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

Пример с несколькими параметрами-массивами: сложение соответствующих элементов двух массивов:

SELECT array_map((x, y) -> x + y, [1, 2, 3, 4, 5], [10, 20, 30, 40, 50]);
+--------------------------------------------------+
| array_map((x, y) -> x + y, [1, 2, 3, 4, 5], [10, 20, 30, 40, 50]) |
+--------------------------------------------------+
| [11, 22, 33, 44, 55]                             |
+--------------------------------------------------+

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

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

Обработка типа Map: извлечение значения по ключу 'a' из каждого отображения:

SELECT array_map(x -> x['a'], [{'a':1,'b':2}, {'a':3,'b':4}, {'a':5,'b':6}]);
+--------------------------------------------------+
| array_map(x -> x['a'], [{'a':1,'b':2}, {'a':3,'b':4}, {'a':5,'b':6}]) |
+--------------------------------------------------+
| [1, 3, 5]                                        |
+--------------------------------------------------+

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

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

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

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

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

ARRAY, MAP, ARRAY_MAP

Report issue