biscuit

概览

rename from pg_biscuit to biscuit to keep up with PGDG RPM name

版本

构建

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

pig build pkg pg_biscuit         # 构建 RPM / DEB 包

安装

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

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

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

• 安装
• pig
• dnf
• apt

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

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

dnf install -y biscuit_18       # PG 18
dnf install -y biscuit_17       # PG 17
dnf install -y biscuit_16       # PG 16

apt install -y postgresql-18-biscuit   # PG 18
apt install -y postgresql-17-biscuit   # PG 17
apt install -y postgresql-16-biscuit   # PG 16

创建扩展：

CREATE EXTENSION biscuit CASCADE;  -- 依赖: plpgsql

用法

来源：

• PGXN biscuit 2.4.1
• Biscuit README
• Biscuit CHANGELOG
• Biscuit documentation
• 本地包元数据

biscuit 是 PostgreSQL 的索引访问方法，用于加速文本上的 LIKE、NOT LIKE、ILIKE 和 NOT ILIKE 模式匹配。它使用类似位图的位置索引，避免 trigram 搜索中常见的 heap recheck 开销，并支持多列索引，适合通配符查询较多的负载。

PGXN 2.4.1 包里携带的 SQL/control 版本是 2.4.0，因此扩展可见的 default_version 仍是 2.4.0。Pigsty 本地扩展名为 biscuit，旧包元数据中可能仍能看到 pg_biscuit。

快速开始

CREATE EXTENSION IF NOT EXISTS biscuit;

CREATE TABLE users (
  id bigserial PRIMARY KEY,
  name text,
  email text,
  bio text
);

CREATE INDEX users_name_biscuit
ON users USING biscuit (name);

SELECT *
FROM users
WHERE name LIKE '%john%';

biscuit 支持带 % 和 _ 的普通通配符模式：

SELECT * FROM users WHERE name LIKE 'john%';
SELECT * FROM users WHERE name LIKE '%smith';
SELECT * FROM users WHERE name LIKE '%oh_';
SELECT * FROM users WHERE name ILIKE '%john%';
SELECT * FROM users WHERE name NOT LIKE '%test%';

多列索引

CREATE INDEX users_search_biscuit
ON users USING biscuit (name, email, bio);

SELECT *
FROM users
WHERE name ILIKE '%john%'
  AND email LIKE '%example.com'
  AND bio NOT LIKE '%inactive%';

Biscuit 可以合并多个索引列上的 bitmap 匹配，并可能按估计选择性重排谓词。

表达式索引

2.4.0 增加了 expression index 支持：

CREATE INDEX users_lower_name_biscuit
ON users USING biscuit (lower(name));

SELECT *
FROM users
WHERE lower(name) LIKE '%john%';

对于 char(n) / bpchar 列，上游建议使用显式 cast 到 text 的表达式索引，因为原生 bpchar 操作符类尚不可用：

CREATE INDEX legacy_code_biscuit
ON legacy_table USING biscuit ((code::text));

查看信息

SELECT *
FROM biscuit_operators;

SELECT *
FROM biscuit_version_history;

biscuit_operators 视图列出 Biscuit 访问方法注册的操作符。2.4.0 修复了该视图，使它在后续增加 operator class / family 时仍能保持正确。

运维说明

Biscuit 的设计重点是：

• prefix、suffix、substring 和混合通配符 LIKE / ILIKE 模式
• 多列谓词中通过 bitmap 交集减少候选集
• 不依赖 trigram false-positive recheck 的精确模式匹配
• 文本模式搜索占主要延迟的查询

它不是通用全文检索引擎，也不替代排序、词干化、分词或短语检索。如果需要这些语义，应使用 PostgreSQL 全文检索、trigram 索引或专门的搜索扩展。

注意事项

• 上游要求 PostgreSQL 16 或更高版本及标准构建工具。Pigsty 本地元数据目前为 PostgreSQL 16-18 打包 Biscuit。
• PGXN 包版本 2.4.1 携带的 SQL/control default_version = '2.4.0'；这是当前源码包的预期状态。
• Biscuit 只面向 LIKE / ILIKE 风格的通配符匹配；正则表达式不是它支持的搜索界面。
• 如需索引非 text 列，应使用显式 text 表达式。
• 替换现有生产索引前，应基于真实数据分布与 pg_trgm 做基准对比。