max_n_by()函数
工具包TimescaleDB 工具包函数在 Timescale 社区版中可用。它们会自动包含在 Timescale 中,但对于自托管的 TimescaleDB,必须单独安装。点击了解更多。简介
从一个列中获取 N 个最大值,以及每个值的关联数据。例如,可以返回一个伴随列,或整个行。
max_n_by()
函数与常规 SQL 查询 SELECT ... ORDER BY ... LIMIT n
返回相同的结果。但与 SQL 查询不同,它们可以像其他聚合超级函数一样组合和合并。
要获取 N 个最小值及其关联数据,请使用 min_n_by()
。要获取 N 个最大值而没有关联数据,请使用 max_n()
。
相关超级函数组
聚合
- max_n_by
- 跟踪一组值中的最大值和关联数据
访问器
- into_values
- 从 MaxNBy 聚合中返回最高值和关联数据
汇总
- rollup
- 合并多个 MaxNBy 聚合
max_n_by(value BIGINT | DOUBLE PRECISION | TIMESTAMPTZ,data ANYELEMENT,capacity BIGINT) MaxNBy
构造一个聚合,跟踪通过它的最大值,以及与该值一起传递的一些关联数据。
必需参数
名称 | 类型 | 描述 |
---|---|---|
value | BIGINT , DOUBLE PRECISION , TIMESTAMPTZ | 传递到聚合中的值 |
data | ANYELEMENT | 与特定值关联的数据 |
capacity | BIGINT | 要保留的值的数量。 |
返回
列 | 类型 | 描述 |
---|---|---|
max_n_by | MaxNBy | 已编译的聚合。请注意,确切的类型将根据输入类型为 MaxByInts、MaxByFloats 或 MaxByTimes |
into_values(agg MaxNBy,dummy ANYELEMENT) TABLE (value BIGINT | DOUBLE PRECISION | TIMESTAMPTZ,data ANYELEMENT)
这将返回聚合看到过的最大值以及与它们相关的对应值。请注意,PostgresQL 需要一个类型与关联值匹配的输入参数,以便确定响应类型。
必需参数
名称 | 类型 | 描述 |
---|---|---|
agg | MaxNBy | 要返回结果的聚合。请注意,此处的确切类型根据存储的数据类型而有所不同。 |
dummy | ANYELEMENT | 这纯粹是为了告知 PostgresQL 响应类型。将 NULL 转换为适当类型是典型的做法。 |
返回
列 | 类型 | 描述 |
---|---|---|
into_values | TABLE (value BIGINT , DOUBLE PRECISION , TIMESTAMPTZ, data ANYELEMENT) | 创建此聚合时所看到的最大值和关联数据。 |
示例
查找 i = 1 到 10000 的 i * 13 % 10007
中的 5 个最大值,以及生成该模数的操作的整数结果
SELECT into_values(max_n_by(sub.mod, sub.div, 5),NULL::INT)FROM (SELECT (i * 13) % 10007 AS mod, (i * 13) / 10007 AS divFROM generate_series(1,10000) as i) sub;
into_values-------------(10006,3)(10005,7)(10004,11)(10003,2)(10002,6)
rollup(agg MaxNBy) MaxNBy
此聚合将其他 maxnby 聚合生成的聚合合并在一起,并返回所有聚合数据中找到的最大值,以及关联数据。
必需参数
名称 | 类型 | 描述 |
---|---|---|
agg | MaxNBy | 要合并的聚合 |
返回
列 | 类型 | 描述 |
---|---|---|
rollup | MaxNBy | 所有贡献值的聚合。 |
此示例假设你有一个以这种格式存储股票交易的表
CREATE TABLE stock_sales(ts TIMESTAMPTZ,symbol TEXT,price FLOAT,volume INT);
查找表中的 10 笔最大交易,交易发生的时间,以及交易的股票代码
SELECT(data).time,(data).symbol,value AS transactionFROMinto_values((SELECT max_n_by(price * volume, stock_sales, 10)FROM stock_sales),NULL::stock_sales);
关键字
在该页面上发现问题了吗?报告问题 或 在 GitHub 上编辑此页面。