topn
top-n JSONB 的类型
仓库
citusdata/postgresql-topn
https://github.com/citusdata/postgresql-topn
源码
postgresql-topn-2.7.0.tar.gz
postgresql-topn-2.7.0.tar.gz
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
topn | 2.7.0 | FUNC | AGPL-3.0 | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 4600 | topn | 否 | 是 | 否 | 是 | 否 | 否 | - |
| 相关扩展 | count_distinct quantile lower_quantile first_last_agg omnisketch ddsketch aggs_for_arrays aggs_for_vecs |
|---|
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PGDG | 2.7.0 | 1817161514 | topn | - |
| RPM | PGDG | 2.7.0 | 1817161514 | topn_$v | - |
| DEB | PIGSTY | 2.7.0 | 1817161514 | postgresql-$v-topn | - |
构建
您可以使用 pig build 命令构建 topn 扩展的 DEB 包：
pig build pkg topn # 构建 DEB 包
安装
您可以直接安装 topn 扩展包的预置二进制包，首先确保 PGDG 仓库已经添加并启用：
pig repo add pgdg -u # 添加 PGDG 仓库并更新缓存
使用 pig 或者是 apt/yum/dnf 安装扩展：
pig install topn; # 当前活跃 PG 版本安装
pig ext install -y topn -v 18 # PG 18
pig ext install -y topn -v 17 # PG 17
pig ext install -y topn -v 16 # PG 16
pig ext install -y topn -v 15 # PG 15
pig ext install -y topn -v 14 # PG 14
dnf install -y topn_18 # PG 18
dnf install -y topn_17 # PG 17
dnf install -y topn_16 # PG 16
dnf install -y topn_15 # PG 15
dnf install -y topn_14 # PG 14
apt install -y postgresql-18-topn # PG 18
apt install -y postgresql-17-topn # PG 17
apt install -y postgresql-16-topn # PG 16
apt install -y postgresql-15-topn # PG 15
apt install -y postgresql-14-topn # PG 14
创建扩展：
CREATE EXTENSION topn;
用法
提供近似的 Top-N 值跟踪，使用近似算法维护预定数量的高频项及其计数器。支持物化、增量更新以及跨时间区间的合并。
CREATE EXTENSION topn;
数据类型
使用 JSONB 存储高频项及其频率。
聚合函数
| 函数 | 描述 |
|---|---|
topn_add_agg(text) | 从文本列创建 JSONB 计数器的聚合函数 |
topn_union_agg(jsonb) | 合并多个 JSONB 计数器列表的聚合函数 |
函数
| 函数 | 描述 |
|---|---|
topn(jsonb, n) | 返回 Top-N 元素及其频率的行集 |
topn_add(jsonb, text) | 向 JSONB 计数器添加一个文本值 |
topn_union(jsonb, jsonb) | 合并两个 JSONB 计数器列表 |
配置
topn.number_of_counters– 要跟踪的计数器数量（默认：1000）
示例
-- 按日期物化热门产品
CREATE TABLE popular_products (
review_date date UNIQUE,
agg_data jsonb
);
INSERT INTO popular_products
SELECT review_date, topn_add_agg(product_id)
FROM customer_reviews GROUP BY review_date;
-- 获取每天排名第一的产品
SELECT review_date, (topn(agg_data, 1)).*
FROM popular_products ORDER BY review_date;
-- 跨时间范围的 Top 10（合并每日摘要）
SELECT (topn(topn_union_agg(agg_data), 10)).*
FROM popular_products
WHERE review_date >= '2000-01-01' AND review_date < '2000-02-01'
ORDER BY 2 DESC;