pg_accumulator

PostgreSQL 中用于余额与周转跟踪的累积寄存器

概览

扩展包名	版本	分类	许可证	语言
`pg_accumulator`	`1.1.3`	FUNC	PostgreSQL	C

ID	扩展名	Bin	Lib	Load	Create	Trust	Reloc	模式
4845	`pg_accumulator`	否	是	否	是	否	否	`accum`

相关扩展	`plpgsql` `currency` `financial` `omni_ledger`

版本

类型	仓库	版本	PG 大版本	包名	依赖
EXT	PIGSTY	`1.1.3`	1817161514	`pg_accumulator`	`plpgsql`
RPM	PIGSTY	`1.1.3`	1817161514	`pg_accumulator_$v`	-
DEB	PIGSTY	`1.1.3`	1817161514	`postgresql-$v-pg-accumulator`	-

OS / PG	PG18	PG17	PG16	PG15	PG14
el8.x86_64	PIGSTY 1.1.3 el8.x86_64.pg18 : pg_accumulator_18 pg_accumulator_18-1.1.3-1PIGSTY.el8.x86_64.rpm PIGSTY · 1.1.3 · 56.6KiB	PIGSTY 1.1.3 el8.x86_64.pg17 : pg_accumulator_17 pg_accumulator_17-1.1.3-1PIGSTY.el8.x86_64.rpm PIGSTY · 1.1.3 · 56.6KiB	PIGSTY 1.1.3 el8.x86_64.pg16 : pg_accumulator_16 pg_accumulator_16-1.1.3-1PIGSTY.el8.x86_64.rpm PIGSTY · 1.1.3 · 56.6KiB	PIGSTY 1.1.3 el8.x86_64.pg15 : pg_accumulator_15 pg_accumulator_15-1.1.3-1PIGSTY.el8.x86_64.rpm PIGSTY · 1.1.3 · 56.7KiB	PIGSTY 1.1.3 el8.x86_64.pg14 : pg_accumulator_14 pg_accumulator_14-1.1.3-1PIGSTY.el8.x86_64.rpm PIGSTY · 1.1.3 · 56.7KiB
el8.aarch64	PIGSTY 1.1.3 el8.aarch64.pg18 : pg_accumulator_18 pg_accumulator_18-1.1.3-1PIGSTY.el8.aarch64.rpm PIGSTY · 1.1.3 · 56.8KiB	PIGSTY 1.1.3 el8.aarch64.pg17 : pg_accumulator_17 pg_accumulator_17-1.1.3-1PIGSTY.el8.aarch64.rpm PIGSTY · 1.1.3 · 56.8KiB	PIGSTY 1.1.3 el8.aarch64.pg16 : pg_accumulator_16 pg_accumulator_16-1.1.3-1PIGSTY.el8.aarch64.rpm PIGSTY · 1.1.3 · 56.8KiB	PIGSTY 1.1.3 el8.aarch64.pg15 : pg_accumulator_15 pg_accumulator_15-1.1.3-1PIGSTY.el8.aarch64.rpm PIGSTY · 1.1.3 · 56.9KiB	PIGSTY 1.1.3 el8.aarch64.pg14 : pg_accumulator_14 pg_accumulator_14-1.1.3-1PIGSTY.el8.aarch64.rpm PIGSTY · 1.1.3 · 56.9KiB
el9.x86_64	PIGSTY 1.1.3 el9.x86_64.pg18 : pg_accumulator_18 pg_accumulator_18-1.1.3-1PIGSTY.el9.x86_64.rpm PIGSTY · 1.1.3 · 54.3KiB	PIGSTY 1.1.3 el9.x86_64.pg17 : pg_accumulator_17 pg_accumulator_17-1.1.3-1PIGSTY.el9.x86_64.rpm PIGSTY · 1.1.3 · 54.3KiB	PIGSTY 1.1.3 el9.x86_64.pg16 : pg_accumulator_16 pg_accumulator_16-1.1.3-1PIGSTY.el9.x86_64.rpm PIGSTY · 1.1.3 · 54.3KiB	PIGSTY 1.1.3 el9.x86_64.pg15 : pg_accumulator_15 pg_accumulator_15-1.1.3-1PIGSTY.el9.x86_64.rpm PIGSTY · 1.1.3 · 54.3KiB	PIGSTY 1.1.3 el9.x86_64.pg14 : pg_accumulator_14 pg_accumulator_14-1.1.3-1PIGSTY.el9.x86_64.rpm PIGSTY · 1.1.3 · 54.3KiB
el9.aarch64	PIGSTY 1.1.3 el9.aarch64.pg18 : pg_accumulator_18 pg_accumulator_18-1.1.3-1PIGSTY.el9.aarch64.rpm PIGSTY · 1.1.3 · 54.2KiB	PIGSTY 1.1.3 el9.aarch64.pg17 : pg_accumulator_17 pg_accumulator_17-1.1.3-1PIGSTY.el9.aarch64.rpm PIGSTY · 1.1.3 · 54.2KiB	PIGSTY 1.1.3 el9.aarch64.pg16 : pg_accumulator_16 pg_accumulator_16-1.1.3-1PIGSTY.el9.aarch64.rpm PIGSTY · 1.1.3 · 54.2KiB	PIGSTY 1.1.3 el9.aarch64.pg15 : pg_accumulator_15 pg_accumulator_15-1.1.3-1PIGSTY.el9.aarch64.rpm PIGSTY · 1.1.3 · 54.4KiB	PIGSTY 1.1.3 el9.aarch64.pg14 : pg_accumulator_14 pg_accumulator_14-1.1.3-1PIGSTY.el9.aarch64.rpm PIGSTY · 1.1.3 · 54.4KiB
el10.x86_64	PIGSTY 1.1.3 el10.x86_64.pg18 : pg_accumulator_18 pg_accumulator_18-1.1.3-1PIGSTY.el10.x86_64.rpm PIGSTY · 1.1.3 · 54.3KiB	PIGSTY 1.1.3 el10.x86_64.pg17 : pg_accumulator_17 pg_accumulator_17-1.1.3-1PIGSTY.el10.x86_64.rpm PIGSTY · 1.1.3 · 54.2KiB	PIGSTY 1.1.3 el10.x86_64.pg16 : pg_accumulator_16 pg_accumulator_16-1.1.3-1PIGSTY.el10.x86_64.rpm PIGSTY · 1.1.3 · 54.3KiB	PIGSTY 1.1.3 el10.x86_64.pg15 : pg_accumulator_15 pg_accumulator_15-1.1.3-1PIGSTY.el10.x86_64.rpm PIGSTY · 1.1.3 · 54.4KiB	PIGSTY 1.1.3 el10.x86_64.pg14 : pg_accumulator_14 pg_accumulator_14-1.1.3-1PIGSTY.el10.x86_64.rpm PIGSTY · 1.1.3 · 54.4KiB
el10.aarch64	PIGSTY 1.1.3 el10.aarch64.pg18 : pg_accumulator_18 pg_accumulator_18-1.1.3-1PIGSTY.el10.aarch64.rpm PIGSTY · 1.1.3 · 54.5KiB	PIGSTY 1.1.3 el10.aarch64.pg17 : pg_accumulator_17 pg_accumulator_17-1.1.3-1PIGSTY.el10.aarch64.rpm PIGSTY · 1.1.3 · 54.5KiB	PIGSTY 1.1.3 el10.aarch64.pg16 : pg_accumulator_16 pg_accumulator_16-1.1.3-1PIGSTY.el10.aarch64.rpm PIGSTY · 1.1.3 · 54.5KiB	PIGSTY 1.1.3 el10.aarch64.pg15 : pg_accumulator_15 pg_accumulator_15-1.1.3-1PIGSTY.el10.aarch64.rpm PIGSTY · 1.1.3 · 54.7KiB	PIGSTY 1.1.3 el10.aarch64.pg14 : pg_accumulator_14 pg_accumulator_14-1.1.3-1PIGSTY.el10.aarch64.rpm PIGSTY · 1.1.3 · 54.7KiB
d12.x86_64	PIGSTY 1.1.3 d12.x86_64.pg18 : postgresql-18-pg-accumulator postgresql-18-pg-accumulator_1.1.3-1PIGSTY~bookworm_amd64.deb PIGSTY · 1.1.3 · 51.1KiB	PIGSTY 1.1.3 d12.x86_64.pg17 : postgresql-17-pg-accumulator postgresql-17-pg-accumulator_1.1.3-1PIGSTY~bookworm_amd64.deb PIGSTY · 1.1.3 · 51.1KiB	PIGSTY 1.1.3 d12.x86_64.pg16 : postgresql-16-pg-accumulator postgresql-16-pg-accumulator_1.1.3-1PIGSTY~bookworm_amd64.deb PIGSTY · 1.1.3 · 51.1KiB	PIGSTY 1.1.3 d12.x86_64.pg15 : postgresql-15-pg-accumulator postgresql-15-pg-accumulator_1.1.3-1PIGSTY~bookworm_amd64.deb PIGSTY · 1.1.3 · 51.2KiB	PIGSTY 1.1.3 d12.x86_64.pg14 : postgresql-14-pg-accumulator postgresql-14-pg-accumulator_1.1.3-1PIGSTY~bookworm_amd64.deb PIGSTY · 1.1.3 · 51.1KiB
d12.aarch64	PIGSTY 1.1.3 d12.aarch64.pg18 : postgresql-18-pg-accumulator postgresql-18-pg-accumulator_1.1.3-1PIGSTY~bookworm_arm64.deb PIGSTY · 1.1.3 · 50.9KiB	PIGSTY 1.1.3 d12.aarch64.pg17 : postgresql-17-pg-accumulator postgresql-17-pg-accumulator_1.1.3-1PIGSTY~bookworm_arm64.deb PIGSTY · 1.1.3 · 50.9KiB	PIGSTY 1.1.3 d12.aarch64.pg16 : postgresql-16-pg-accumulator postgresql-16-pg-accumulator_1.1.3-1PIGSTY~bookworm_arm64.deb PIGSTY · 1.1.3 · 50.9KiB	PIGSTY 1.1.3 d12.aarch64.pg15 : postgresql-15-pg-accumulator postgresql-15-pg-accumulator_1.1.3-1PIGSTY~bookworm_arm64.deb PIGSTY · 1.1.3 · 50.9KiB	PIGSTY 1.1.3 d12.aarch64.pg14 : postgresql-14-pg-accumulator postgresql-14-pg-accumulator_1.1.3-1PIGSTY~bookworm_arm64.deb PIGSTY · 1.1.3 · 50.9KiB
d13.x86_64	PIGSTY 1.1.3 d13.x86_64.pg18 : postgresql-18-pg-accumulator postgresql-18-pg-accumulator_1.1.3-1PIGSTY~trixie_amd64.deb PIGSTY · 1.1.3 · 51.2KiB	PIGSTY 1.1.3 d13.x86_64.pg17 : postgresql-17-pg-accumulator postgresql-17-pg-accumulator_1.1.3-1PIGSTY~trixie_amd64.deb PIGSTY · 1.1.3 · 51.1KiB	PIGSTY 1.1.3 d13.x86_64.pg16 : postgresql-16-pg-accumulator postgresql-16-pg-accumulator_1.1.3-1PIGSTY~trixie_amd64.deb PIGSTY · 1.1.3 · 51.1KiB	PIGSTY 1.1.3 d13.x86_64.pg15 : postgresql-15-pg-accumulator postgresql-15-pg-accumulator_1.1.3-1PIGSTY~trixie_amd64.deb PIGSTY · 1.1.3 · 51.2KiB	PIGSTY 1.1.3 d13.x86_64.pg14 : postgresql-14-pg-accumulator postgresql-14-pg-accumulator_1.1.3-1PIGSTY~trixie_amd64.deb PIGSTY · 1.1.3 · 51.2KiB
d13.aarch64	PIGSTY 1.1.3 d13.aarch64.pg18 : postgresql-18-pg-accumulator postgresql-18-pg-accumulator_1.1.3-1PIGSTY~trixie_arm64.deb PIGSTY · 1.1.3 · 50.9KiB	PIGSTY 1.1.3 d13.aarch64.pg17 : postgresql-17-pg-accumulator postgresql-17-pg-accumulator_1.1.3-1PIGSTY~trixie_arm64.deb PIGSTY · 1.1.3 · 50.9KiB	PIGSTY 1.1.3 d13.aarch64.pg16 : postgresql-16-pg-accumulator postgresql-16-pg-accumulator_1.1.3-1PIGSTY~trixie_arm64.deb PIGSTY · 1.1.3 · 51.0KiB	PIGSTY 1.1.3 d13.aarch64.pg15 : postgresql-15-pg-accumulator postgresql-15-pg-accumulator_1.1.3-1PIGSTY~trixie_arm64.deb PIGSTY · 1.1.3 · 51.0KiB	PIGSTY 1.1.3 d13.aarch64.pg14 : postgresql-14-pg-accumulator postgresql-14-pg-accumulator_1.1.3-1PIGSTY~trixie_arm64.deb PIGSTY · 1.1.3 · 51.0KiB
u22.x86_64	PIGSTY 1.1.3 u22.x86_64.pg18 : postgresql-18-pg-accumulator postgresql-18-pg-accumulator_1.1.3-1PIGSTY~jammy_amd64.deb PIGSTY · 1.1.3 · 52.8KiB	PIGSTY 1.1.3 u22.x86_64.pg17 : postgresql-17-pg-accumulator postgresql-17-pg-accumulator_1.1.3-1PIGSTY~jammy_amd64.deb PIGSTY · 1.1.3 · 54.1KiB	PIGSTY 1.1.3 u22.x86_64.pg16 : postgresql-16-pg-accumulator postgresql-16-pg-accumulator_1.1.3-1PIGSTY~jammy_amd64.deb PIGSTY · 1.1.3 · 54.1KiB	PIGSTY 1.1.3 u22.x86_64.pg15 : postgresql-15-pg-accumulator postgresql-15-pg-accumulator_1.1.3-1PIGSTY~jammy_amd64.deb PIGSTY · 1.1.3 · 54.2KiB	PIGSTY 1.1.3 u22.x86_64.pg14 : postgresql-14-pg-accumulator postgresql-14-pg-accumulator_1.1.3-1PIGSTY~jammy_amd64.deb PIGSTY · 1.1.3 · 54.2KiB
u22.aarch64	PIGSTY 1.1.3 u22.aarch64.pg18 : postgresql-18-pg-accumulator postgresql-18-pg-accumulator_1.1.3-1PIGSTY~jammy_arm64.deb PIGSTY · 1.1.3 · 52.5KiB	PIGSTY 1.1.3 u22.aarch64.pg17 : postgresql-17-pg-accumulator postgresql-17-pg-accumulator_1.1.3-1PIGSTY~jammy_arm64.deb PIGSTY · 1.1.3 · 53.8KiB	PIGSTY 1.1.3 u22.aarch64.pg16 : postgresql-16-pg-accumulator postgresql-16-pg-accumulator_1.1.3-1PIGSTY~jammy_arm64.deb PIGSTY · 1.1.3 · 53.8KiB	PIGSTY 1.1.3 u22.aarch64.pg15 : postgresql-15-pg-accumulator postgresql-15-pg-accumulator_1.1.3-1PIGSTY~jammy_arm64.deb PIGSTY · 1.1.3 · 53.9KiB	PIGSTY 1.1.3 u22.aarch64.pg14 : postgresql-14-pg-accumulator postgresql-14-pg-accumulator_1.1.3-1PIGSTY~jammy_arm64.deb PIGSTY · 1.1.3 · 53.9KiB
u24.x86_64	PIGSTY 1.1.3 u24.x86_64.pg18 : postgresql-18-pg-accumulator postgresql-18-pg-accumulator_1.1.3-1PIGSTY~noble_amd64.deb PIGSTY · 1.1.3 · 52.2KiB	PIGSTY 1.1.3 u24.x86_64.pg17 : postgresql-17-pg-accumulator postgresql-17-pg-accumulator_1.1.3-1PIGSTY~noble_amd64.deb PIGSTY · 1.1.3 · 52.3KiB	PIGSTY 1.1.3 u24.x86_64.pg16 : postgresql-16-pg-accumulator postgresql-16-pg-accumulator_1.1.3-1PIGSTY~noble_amd64.deb PIGSTY · 1.1.3 · 52.3KiB	PIGSTY 1.1.3 u24.x86_64.pg15 : postgresql-15-pg-accumulator postgresql-15-pg-accumulator_1.1.3-1PIGSTY~noble_amd64.deb PIGSTY · 1.1.3 · 52.3KiB	PIGSTY 1.1.3 u24.x86_64.pg14 : postgresql-14-pg-accumulator postgresql-14-pg-accumulator_1.1.3-1PIGSTY~noble_amd64.deb PIGSTY · 1.1.3 · 52.3KiB
u24.aarch64	PIGSTY 1.1.3 u24.aarch64.pg18 : postgresql-18-pg-accumulator postgresql-18-pg-accumulator_1.1.3-1PIGSTY~noble_arm64.deb PIGSTY · 1.1.3 · 51.9KiB	PIGSTY 1.1.3 u24.aarch64.pg17 : postgresql-17-pg-accumulator postgresql-17-pg-accumulator_1.1.3-1PIGSTY~noble_arm64.deb PIGSTY · 1.1.3 · 51.9KiB	PIGSTY 1.1.3 u24.aarch64.pg16 : postgresql-16-pg-accumulator postgresql-16-pg-accumulator_1.1.3-1PIGSTY~noble_arm64.deb PIGSTY · 1.1.3 · 51.9KiB	PIGSTY 1.1.3 u24.aarch64.pg15 : postgresql-15-pg-accumulator postgresql-15-pg-accumulator_1.1.3-1PIGSTY~noble_arm64.deb PIGSTY · 1.1.3 · 52.0KiB	PIGSTY 1.1.3 u24.aarch64.pg14 : postgresql-14-pg-accumulator postgresql-14-pg-accumulator_1.1.3-1PIGSTY~noble_arm64.deb PIGSTY · 1.1.3 · 52.0KiB
u26.x86_64	PIGSTY 1.1.3 u26.x86_64.pg18 : postgresql-18-pg-accumulator postgresql-18-pg-accumulator_1.1.3-1PIGSTY~resolute_amd64.deb PIGSTY · 1.1.3 · 52.3KiB	PIGSTY 1.1.3 u26.x86_64.pg17 : postgresql-17-pg-accumulator postgresql-17-pg-accumulator_1.1.3-1PIGSTY~resolute_amd64.deb PIGSTY · 1.1.3 · 52.3KiB	PIGSTY 1.1.3 u26.x86_64.pg16 : postgresql-16-pg-accumulator postgresql-16-pg-accumulator_1.1.3-1PIGSTY~resolute_amd64.deb PIGSTY · 1.1.3 · 52.3KiB	PIGSTY 1.1.3 u26.x86_64.pg15 : postgresql-15-pg-accumulator postgresql-15-pg-accumulator_1.1.3-1PIGSTY~resolute_amd64.deb PIGSTY · 1.1.3 · 52.4KiB	PIGSTY 1.1.3 u26.x86_64.pg14 : postgresql-14-pg-accumulator postgresql-14-pg-accumulator_1.1.3-1PIGSTY~resolute_amd64.deb PIGSTY · 1.1.3 · 52.3KiB
u26.aarch64	PIGSTY 1.1.3 u26.aarch64.pg18 : postgresql-18-pg-accumulator postgresql-18-pg-accumulator_1.1.3-1PIGSTY~resolute_arm64.deb PIGSTY · 1.1.3 · 52.1KiB	PIGSTY 1.1.3 u26.aarch64.pg17 : postgresql-17-pg-accumulator postgresql-17-pg-accumulator_1.1.3-1PIGSTY~resolute_arm64.deb PIGSTY · 1.1.3 · 52.1KiB	PIGSTY 1.1.3 u26.aarch64.pg16 : postgresql-16-pg-accumulator postgresql-16-pg-accumulator_1.1.3-1PIGSTY~resolute_arm64.deb PIGSTY · 1.1.3 · 52.1KiB	PIGSTY 1.1.3 u26.aarch64.pg15 : postgresql-15-pg-accumulator postgresql-15-pg-accumulator_1.1.3-1PIGSTY~resolute_arm64.deb PIGSTY · 1.1.3 · 52.3KiB	PIGSTY 1.1.3 u26.aarch64.pg14 : postgresql-14-pg-accumulator postgresql-14-pg-accumulator_1.1.3-1PIGSTY~resolute_arm64.deb PIGSTY · 1.1.3 · 52.2KiB

构建

您可以使用 pig build 命令构建 pg_accumulator 扩展的 RPM / DEB 包：

BASH

pig build pkg pg_accumulator         # 构建 RPM / DEB 包

安装

您可以直接安装 pg_accumulator 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：

BASH

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展：

安装

BASH

pig install pg_accumulator;          # 当前活跃 PG 版本安装

pig

BASH

pig ext install -y pg_accumulator -v 18  # PG 18
pig ext install -y pg_accumulator -v 17  # PG 17
pig ext install -y pg_accumulator -v 16  # PG 16
pig ext install -y pg_accumulator -v 15  # PG 15
pig ext install -y pg_accumulator -v 14  # PG 14

dnf

BASH

dnf install -y pg_accumulator_18       # PG 18
dnf install -y pg_accumulator_17       # PG 17
dnf install -y pg_accumulator_16       # PG 16
dnf install -y pg_accumulator_15       # PG 15
dnf install -y pg_accumulator_14       # PG 14

apt

BASH

apt install -y postgresql-18-pg-accumulator   # PG 18
apt install -y postgresql-17-pg-accumulator   # PG 17
apt install -y postgresql-16-pg-accumulator   # PG 16
apt install -y postgresql-15-pg-accumulator   # PG 15
apt install -y postgresql-14-pg-accumulator   # PG 14

创建扩展：

SQL

CREATE EXTENSION pg_accumulator CASCADE;  -- 依赖: plpgsql

用法

来源：README，documentation，control file

pg_accumulator 为 PostgreSQL 提供声明式累积寄存器。寄存器按任意维度和资源记录业务流水，并生成余额、发生额、流水历史、校验和重建等查询与维护函数。

启用

SQL

CREATE EXTENSION pg_accumulator;

如果高写入场景需要 delta buffer 和后台 worker，需要预加载共享库并重启 PostgreSQL：

CONF

shared_preload_libraries = 'pg_accumulator'

创建寄存器

SQL

SELECT accum.register_create(
  name := 'inventory',
  dimensions := '{"warehouse": "int", "product": "int"}',
  resources := '{"quantity": "numeric", "amount": "numeric"}',
  kind := 'balance'
);

一次调用会创建寄存器元数据、流水表、汇总表、余额缓存、触发器、生成查询函数和配套索引。

记账与查询

SQL

SELECT accum.register_post('inventory', '{
  "period": "2026-04-01",
  "document": "receipt:1",
  "dimensions": {"warehouse": 1, "product": 42},
  "resources": {"quantity": 10, "amount": 250}
}');

SELECT * FROM accum.inventory_balance(
  dimensions := '{"warehouse": 1, "product": 42}'
);

SELECT * FROM accum.inventory_turnover(
  from_date := '2026-04-01',
  to_date := '2026-04-30',
  dimensions := '{"warehouse": 1}',
  group_by := '["product"]'
);

更正与维护

使用 register_unpost 和 register_repost 处理追溯更正。必要时使用 register_verify、register_rebuild_totals、register_rebuild_cache 校验和修复派生状态。

SQL

SELECT accum.register_unpost('inventory', 'receipt:1');
SELECT accum.register_verify('inventory');

配置

文档中的 GUC 包括 pg_accumulator.background_workers、pg_accumulator.delta_merge_interval、pg_accumulator.delta_merge_delay、pg_accumulator.delta_merge_batch_size、pg_accumulator.partitions_ahead、pg_accumulator.maintenance_interval。

意见反馈

这个页面对您有帮助吗？

感谢反馈！请告诉我们如何改进。

抱歉给您带来不便。请告诉我们如何改进。