pg_lion

概览

Custom WAL requires preload.

版本

构建

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

pig build pkg pg_lion         # 构建 RPM / DEB 包

安装

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

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

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

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

pig ext install -y pg_lion -v 18  # PG 18
pig ext install -y pg_lion -v 17  # PG 17
pig ext install -y pg_lion -v 16  # PG 16

dnf install -y pg_lion_18       # PG 18
dnf install -y pg_lion_17       # PG 17
dnf install -y pg_lion_16       # PG 16

apt install -y postgresql-18-pg-lion   # PG 18
apt install -y postgresql-17-pg-lion   # PG 17
apt install -y postgresql-16-pg-lion   # PG 16

创建扩展：

CREATE EXTENSION pg_lion;

用法

来源：

• README
• 参考手册
• 扩展控制文件

pg_lion 0.3.0 为 PostgreSQL 16 及以上版本提供 Roaring 位图倒排索引，用于过滤、计数与分组聚合。它支持堆表，查询沿用 PostgreSQL 原有运算符；默认的通用 WAL 模式不需要预加载。

核心流程

为过滤与分组使用的列创建 lion 索引。经过清理、所有行均可见的页面允许计数避免访问堆；最近修改过的页面可能仍需到堆中检查可见性。

CREATE EXTENSION pg_lion;
CREATE TABLE lion_events (country text, amount integer);
INSERT INTO lion_events VALUES ('JP', 10), ('JP', 20), ('NZ', 30);
CREATE INDEX lion_country ON lion_events USING lion (country);
CREATE INDEX lion_amount ON lion_events USING lion (amount) WITH (slices = on);
VACUUM ANALYZE lion_events;
SELECT count(*), sum(amount) FROM lion_events WHERE country = 'JP';
SELECT country, count(*) FROM lion_events GROUP BY country;

支持标量相等、范围、IN、空值判断及组合条件。lion 也可索引数组、jsonb 和 tsvector；lion_bm25_score 用于全文匹配排序。针对 JSON 字段的表达式索引可以支持默认 jsonb 索引无法处理的分组。

选项与诊断

pg_lion_citext 添加 citext 运算符类。pg_lion_vector 添加 lionvec 访问方法，依赖 pgvector 0.7 或更新版本。这两个伴随扩展随父扩展一起分发，分别启用。

WAL 与运行边界

创建这些扩展需要超级用户。可选的 shared_preload_libraries = 'pg_lion' 配置加服务器重启会启用自定义 WAL 资源管理器（默认 ID 为 170）。以该模式创建的索引在重建前，写入与 VACUUM 均依赖预加载；修改设置前先检查 lion_index_wal_mode。

只要旧的自定义 WAL 仍可能被回放，就需要在相关实例上保留预加载，包括备用库和归档恢复。REINDEX 不会改写历史 WAL。移除预加载前，应在动态库仍预加载时，将所有 rmgr 索引以 wal_mode = generic 重建，并核对各 WAL 回放使用方。

不支持唯一索引或 INCLUDE 列，且仅支持堆表。唯一性约束与普通有序扫描仍应使用 B-tree。加载动态库会安装规划器钩子，并可能影响其他查询的估算。为写密集型负载添加索引或位切片前应先测量。

1.0 之前的磁盘格式可能变化，应遵循各版本的 REINDEX 要求。0.3.0 之前的构建没有扩展升级路径：上游要求重新创建扩展及其索引。0.3.0 只提供安装脚本。