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

ARRAY_PRODUCT

array_product​

SinceVersion 2.0.0

Описание​

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

Синтаксис​

array_product(ARRAY<T> arr)

Параметры​

  • arr：массив типа ARRAY, для которого нужно вычислить произведение

Поддерживаемые типы T:

  • Числовые типы: TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, DECIMAL
  • Логический тип: BOOLEAN (true преобразуется в 1, false преобразуется в 0)

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

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

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

  • Возвращает произведение всех элементов массива
  • NULL: если массив пуст, сам массив равен NULL или все его элементы равны NULL

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

  • Функция пропускает значения NULL в массиве и вычисляет произведение только тех элементов, которые не равны NULL
  • Если все элементы массива равны NULL, возвращается NULL
  • Для пустых массивов возвращается NULL
  • Сложные типы (MAP, STRUCT, ARRAY) не поддерживают вычисление произведения и вызывают ошибки
  • Обработка значений null в элементах массива: элементы null не участвуют в вычислении произведения

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

Вычисление произведения элементов массива целых чисел:

SELECT array_product([1, 2, 3, 4, 5]);
+--------------------------------+
| array_product([1, 2, 3, 4, 5]) |
+--------------------------------+
|                            120 |
+--------------------------------+

Вычисление произведения элементов массива чисел с плавающей точкой:

SELECT array_product([1.1, 2.2, 3.3, 4.4, 5.5]);
+------------------------------------------+
| array_product([1.1, 2.2, 3.3, 4.4, 5.5]) |
+------------------------------------------+
|                                 193.2612 |
+------------------------------------------+

Вычисление произведения элементов массива, содержащего значения null:

SELECT array_product([1, null, 3, null, 5]);
+----------------------------------------+
| array_product([1, null, 3, null, 5])  |
+----------------------------------------+
| 15.0                                   |
+----------------------------------------+

Вычисление произведения элементов массива логических значений (true=1, false=0):

SELECT array_product([true, false, true, true]);
+------------------------------------------+
| array_product([true, false, true, true]) |
+------------------------------------------+
|                                        0 |
+------------------------------------------+

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

SELECT array_product([]);
+----------------------+
| array_product([])    |
+----------------------+
| NULL                 |
+----------------------+

Для массивов, в которых все элементы равны null, возвращается NULL:

SELECT array_product([null, null, null]);
+----------------------------------+
| array_product([null, null, null]) |
+----------------------------------+
| NULL                             |
+----------------------------------+

Примеры со сложными типами:

Вложенные массивы не поддерживаются и вызывают ошибку:

SELECT array_product([[1,2],[3,4],[5,6]]);
ERROR 1105 (HY000): errCode = 2, detailMessage: array_product does not support type: ARRAY<ARRAY<TINYINT>>

Типы Map не поддерживаются и вызывают ошибку:

SELECT array_product([{'k':1},{'k':2},{'k':3}]);
ERROR 1105 (HY000): errCode = 2, detailMessage: array_product does not support type: ARRAY<MAP<VARCHAR(1),TINYINT>>

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

SELECT array_product([1,2,3], [4,5,6]);
ERROR 1105 (HY000): errCode = 2, detailMessage: Can not found function 'array_product' which has 2 arity. Candidate functions are: [array_product(Expression)]

Ошибка при передаче значений, не являющихся массивами:

SELECT array_product('not_an_array');
ERROR 1105 (HY000): errCode = 2, detailMessage: Can not find the compatibility function signature: array_product(VARCHAR(12))

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

ARRAY, PRODUCT, ARRAY_PRODUCT

Report issue