PostgreSQL 14全文搜索多同义词配置与使用技术问询

现状说明 #

我正在基于PostgreSQL实现全文搜索，当前使用的查询语句为：

FROM schema.table t0
WHERE t0.document @@ websearch_to_tsquery('error')

为实现相似词搜索，已在C:\Program Files\PostgreSQL\14\share\tsearch_data目录的xsyn_sample.rules文件中定义同义词规则：

# Sample rules file for eXtended Synonym (xsyn) dictionary
# format is as follows:
#
# word synonym1 synonym2 ...
#
error fault issue mistake malfunctioning

希望搜索error时返回包含error、fault、issues、mistakes等同义词的结果，以下是针对三个问题的解答：

问题1：仅使用xsyn_sample.rules是否足够？若不足，还有哪些实现方式？ #

仅靠xsyn_sample.rules不足以实现同义词搜索，该文件只是xsyn字典的规则数据源，还需创建字典、配置文本搜索模板并关联到搜索配置中才能生效。

其他同义词搜索实现方式：

• 基础同义词字典（synonym）：适合简单的一对一/多对一同义词映射，配置比xsyn更简洁，但不支持词形变化匹配等扩展功能。
• 叙词表字典（thesaurus）：支持复杂短语同义词、上下文相关的术语替换，适合专业领域场景。
• 自定义函数结合tsvector：在创建索引或查询时手动替换同义词，但维护成本高，性能不如内置字典。

问题2：如何在本地PostgreSQL 14中配置使用该自定义字典，替代默认的'simple'或'english'字典？ #

步骤1：确认xsyn模板存在 #

PostgreSQL默认自带xsyn模板，执行以下命令验证：

SELECT * FROM pg_ts_template WHERE tmplname = 'xsyn';

若未返回结果，先安装依赖的pg_trgm扩展：

CREATE EXTENSION IF NOT EXISTS pg_trgm;

步骤2：创建自定义xsyn字典 #

基于xsyn_sample.rules创建字典：

CREATE TEXT SEARCH DICTIONARY my_xsyn_dict (
    TEMPLATE = xsyn,
    RULES = 'xsyn_sample',  -- 规则文件前缀（去掉.rules后缀）
    KEEPORIGINAL = true,    -- 保留原词，同时匹配同义词
    MATCHSYNONYMS = true,   -- 搜索同义词时匹配原词文档
    MATCHORIGINAL = true    -- 搜索原词时匹配同义词文档
);

步骤3：创建/修改文本搜索配置 #

复制默认english配置并替换字典：

-- 复制默认english配置为自定义配置
CREATE TEXT SEARCH CONFIGURATION my_english_config (COPY = english);

-- 将自定义xsyn字典设置为优先处理的字典
ALTER TEXT SEARCH CONFIGURATION my_english_config
    ALTER MAPPING FOR asciiword, word, numword, asciihword, hword, numhword, hword_asciipart, hword_part, hword_numpart
    WITH my_xsyn_dict, english_stem;

注：将my_xsyn_dict放在english_stem前，确保先处理同义词，再进行词干提取（如issues转为issue匹配规则中的词）。

步骤4：修改查询使用新配置 #

更新原有查询，指定使用自定义配置：

FROM schema.table t0
WHERE t0.document @@ websearch_to_tsquery('my_english_config', 'error');

步骤5：（可选）更新全文索引 #

若已存在基于默认配置的索引，需重建索引适配新配置：

DROP INDEX IF EXISTS idx_document_ts;
CREATE INDEX idx_document_ts ON schema.table USING GIN (to_tsvector('my_english_config', document));

步骤6：验证配置生效 #

执行以下命令测试：

-- 查看生成的tsquery，应包含原词及同义词的词干
SELECT websearch_to_tsquery('my_english_config', 'error');
-- 测试匹配同义词文档
SELECT * FROM schema.table t0 WHERE t0.document @@ websearch_to_tsquery('my_english_config', 'error');

问题3：有没有比PostgreSQL官方全文搜索字典文档更优质的资料？ #

官方文档是最权威的参考，但可补充以下类型资料：

• 实战书籍：如《PostgreSQL实战》《PostgreSQL修炼之道：从小工到专家》，包含全文搜索的实操案例与最佳实践，更贴近实际场景。
• 社区技术博客：PG中文社区、国内云厂商数据库博客等平台的文章，多为开发者分享的配置优化实战经验。
• 开源项目案例：查看GitHub上使用PostgreSQL全文搜索的CMS、搜索服务等项目代码，学习实际项目中的配置方式。
• 官方中文文档：官方文档的中文翻译版本，阅读门槛更低，适合快速理解配置逻辑。

内容的提问来源于stack exchange，提问作者Mehul