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

TOPN_WEIGHTED

Описание​

Функция TOPN_WEIGHTED возвращает N наиболее часто встречающихся значений в указанном столбце по результатам взвешенного подсчёта. В отличие от обычной функции TOPN, TOPN_WEIGHTED позволяет регулировать значимость значений с помощью весов.

Синтаксис​

TOPN_WEIGHTED(<expr>, <weight>, <top_num> [, <space_expand_rate>])

Параметры​

ПараметрОписание
<expr>Столбец или выражение, для которого выполняется подсчёт. Поддерживаемые типы: Boolean (в ветке Doris 4.1 начиная с версии 4.1.5), TinyInt, SmallInt, Integer, BigInt, LargeInt, Float, Double, Decimal, Date, Datetime, IPV4, IPV6, String.
<weight>Столбец или выражение для регулировки веса. Тип: BIGINT.
<top_num>Количество наиболее часто встречающихся значений, которые нужно вернуть. Должно быть положительной константой типа INT.
<space_expand_rate>Необязательная константа типа INT, по умолчанию 50. При положительном значении во время сериализации промежуточного состояния сохраняется не более top_num * space_expand_rate кандидатов; более высокие значения обычно повышают точность. Этот параметр не задаёт жёсткое ограничение памяти для локальной агрегации. В ветке Doris 4.1 начиная с версии 4.1.5 значение 0 или меньше позволяет сохранить всех промежуточных кандидатов, при этом итоговый результат по-прежнему содержит не более top_num значений. В этом режиме может потребоваться больше памяти, и на него по-прежнему распространяются ограничения памяти запроса.

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

Возвращает массив, содержащий N значений с наибольшим взвешенным количеством вхождений. Если в группе нет допустимых данных, возвращает NULL.

Пример​

-- setup
CREATE TABLE product_sales (
    product_id INT,
    sale_amount DECIMAL(10,2),
    sale_date DATE
) DISTRIBUTED BY HASH(product_id)
PROPERTIES (
    "replication_num" = "1"
);
INSERT INTO product_sales VALUES
(1, 100.00, '2024-01-01'),
(2, 50.00, '2024-01-01'),
(1, 150.00, '2024-01-01'),
(3, 75.00, '2024-01-01'),
(1, 200.00, '2024-01-01'),
(2, 80.00, '2024-01-01'),
(1, 120.00, '2024-01-01'),
(4, 90.00, '2024-01-01');
SELECT TOPN_WEIGHTED(product_id, sale_amount, 3) as top_products
FROM product_sales;

Найти 3 товара с наибольшей суммой продаж (с учётом весов).

+--------------+
| top_products |
+--------------+
| [1, 2, 4]    |
+--------------+
SELECT TOPN_WEIGHTED(product_id, sale_amount, 3) as top_products
FROM product_sales where product_id is null;

Найти 3 товара с наибольшей суммой продаж (с учётом весов).

+--------------+
| top_products |
+--------------+
| NULL         |
+--------------+

Входные данные типа BOOLEAN (в ветке Doris 4.1 начиная с версии 4.1.5):

SELECT TOPN_WEIGHTED(TRUE, 1, 2), TOPN_WEIGHTED(CAST(NULL AS BOOLEAN), 1, 2);
[1]    NULL
Report issue