TimescaleDB API 参考超函数最小值和最大值

简介

从列中获取 N 个最小值。

min_n() 函数给出与常规 SQL 查询 SELECT ... ORDER BY ... LIMIT n 相同的结果。但与 SQL 查询不同,它们可以像其他聚合超函数一样组合和组合。

要获取 N 个最大值,请使用 max_n()。要获取 N 个最小值及其伴随数据,请使用 min_n_by().

相关超函数组

聚合

min_n
查找数据集中最小的值

访问器

into_array
返回从 MinN 聚合中获取的最低值的数组
into_values
返回从 MinN 聚合中获取的最低值

汇总

rollup
组合多个 MinN 聚合
min_n(
value BIGINT | DOUBLE PRECISION | TIMESTAMPTZ,
capacity BIGINT
) MinN

构造一个聚合,它跟踪通过它的最小值。

必需参数
名称类型描述
valueBIGINT, DOUBLE PRECISION, TIMESTAMPTZ传递到聚合的值
capacityBIGINT要保留的值的数量。
返回
类型描述
min_nMinN已编译的聚合。请注意,确切类型为 MinIntsMinFloatsMinTimes,具体取决于输入类型
into_array (
agg MinN
) BIGINT[] | DOUBLE PRECISION[] | TIMESTAMPTZ[]

返回聚合所看到的 N 个最低值。这些值以数组形式格式化,按升序排列。

必需参数
名称类型描述
aggMinN要返回结果的聚合。请注意,这里的确切类型因存储的数据类型而异。
返回
类型描述
into_arrayBIGINT[], DOUBLE PRECISION[], TIMESTAMPTZ[]创建此聚合时所看到的最低值。
示例

查找 i * 13 % 10007 的底部 5 个值,其中 i = 1 到 10000

SELECT into_array(
min_n(sub.val, 5))
FROM (
SELECT (i * 13) % 10007 AS val
FROM generate_series(1,10000) as i
) sub;
into_array
---------------------------------
{1,2,3,4,5}
into_values (
agg MinN
) SETOF BIGINT | SETOF DOUBLE PRECISION | SETOF TIMESTAMPTZ

返回聚合所看到的 N 个最低值。

必需参数
名称类型描述
aggMinN要返回结果的聚合。请注意,这里的确切类型因存储的数据类型而异。
返回
类型描述
into_valuesSETOF BIGINT, SETOF DOUBLE PRECISION, SETOF TIMESTAMPTZ创建此聚合时所看到的最低值。
示例

查找 i * 13 % 10007 的底部 5 个值,其中 i = 1 到 10000

SELECT toolkit_experimental.into_array(
toolkit_experimental.min_n(sub.val, 5))
FROM (
SELECT (i * 13) % 10007 AS val
FROM generate_series(1,10000) as i
) sub;
into_values
---------------------------------
1
2
3
4
5
rollup(
agg MinN
) MinN

此聚合组合由其他 min_n 聚合生成的聚合,并返回在所有聚合数据中找到的最小值。

必需参数
名称类型描述
aggMinN要组合的聚合
返回
类型描述
rollupMinN对所有贡献值的聚合。

此示例假设您有一个股票交易表,其格式如下

CREATE TABLE stock_sales(
ts TIMESTAMPTZ,
symbol TEXT,
price FLOAT,
volume INT
);

您可以查询每天 10 笔最小的交易

WITH t as (
SELECT
time_bucket('1 day'::interval, ts) as day,
min_n(price * volume, 10) AS daily_min
FROM stock_sales
GROUP BY time_bucket('1 day'::interval, ts)
)
SELECT
day, as_array(daily_max)
FROM t;

关键词

在此页面上发现问题了吗?报告问题 或 在 GitHub 中编辑此页面.