max_n_by() 函数
ToolkitTimescaleDB Toolkit 函数在 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
此聚合组合由其他 max*n*by 聚合生成的聚合,并返回在所有聚合数据中找到的最大值以及关联数据。
必需参数
名称 | 类型 | 描述 |
---|---|---|
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 上编辑此页。