tsvector_update_trigger 必须通过 CREATE TRIGGER ... BEFORE INSERT OR UPDATE ... EXECUTE FUNCTION 绑定使用，参数顺序为：目标tsvector列名（单引号）、文本搜索配置（如'english'）、参与拼接的文本字段（不加引号）；不可直接调用，且仅支持BEFORE触发。
触发器函数 tsvector_update_trigger 怎么用
PostgreSQL 提供了内置的触发器函数 tsvector_update_trigger，它会在 INSERT 或 UPDATE 时自动调用 to_tsvector，把指定字段拼接后写入目标 tsvector 列。它不是存储过程，不能单独执行，必须绑定在触发器上。
常见错误是直接在 SQL 中调用它，比如：SELECT tsvector_update_trigger(...) —— 这会报错“function cannot be called directly”。
- 必须配合
CREATE TRIGGER ... BEFORE INSERT OR UPDATE ... EXECUTE FUNCTION使用 - 参数顺序固定：第一个是目标
tsvector列名（字符串字面量），第二个是文本搜索配置（如'english'），后续是参与拼接的文本列名（如title,body） - 注意：列名不能加引号，但配置名和目标列名必须用单引号包裹
正确示例：
CREATE TRIGGER tr_articles_tsv
BEFORE INSERT OR UPDATE ON articles
FOR EACH ROW
EXECUTE FUNCTION tsvector_update_trigger(
tsv, 'pg_catalog.english', title, body
);
为什么推荐用列存 tsvector 而非实时计算
两种方式都能查：WHERE to_tsvector('english', title || ' ' || body) @@ to_tsquery(...) 是运行时计算；而维护一个 tsv 列 + GIN 索引是预计算。前者每次查询都要重复分词、归一、去停用词，CPU 开销大，且无法走索引加速。
- 实时计算写法无法在
to_tsvector(...)上建索引（表达式索引虽可建，但需重复写相同表达式，易出错） -
tsvector列支持直接建USING GIN(tsv)，查询性能提升通常在 5–20 倍（取决于文本长度和数据量） - 触发器同步后，
tsv列值可被EXPLAIN显式看到，便于调试分词效果（比如SELECT tsv FROM articles LIMIT 1）
中文场景下触发器要绕过默认配置
PostgreSQL 内置的 english、french 等配置对中文完全无效 —— 它们依赖空格分词，而中文无天然分隔符。直接用会得到空 tsvector 或单个长 token，导致查不到结果。
- 必须提前安装并注册中文分词插件，最常用的是
zhparser - 安装后需创建自定义文本搜索配置，例如：
CREATE TEXT SEARCH CONFIGURATION chinese (PARSER = zhparser);，再添加词典映射 - 触发器中配置名要换成你创建的配置名，如
'chinese'，而不是'english' - 验证方式：
SELECT to_tsvector('chinese', '数据库管理系统');应返回类似'数据库':1 '管理':2 '系统':3的结果
触发器不生效？先检查这几个点
写了触发器却没更新 tsv 列，90% 情况出在以下环节：
- 表里
tsv列类型不是tsvector（比如误建为text），触发器静默失败 - INSERT/UPDATE 语句显式给
tsv赋值了（如INSERT INTO t (tsv, title) VALUES (...)），会跳过触发器逻辑 - 触发器定义在
AFTER而非BEFORE——tsvector_update_trigger只支持BEFORE - 文本列含 NULL：
to_tsvector遇到 NULL 返回 NULL，整个tsv变成 NULL；建议用COALESCE(title, '') || ' ' || COALESCE(body, '')预处理，或在触发器前加SET tsv = ...手动赋值
最稳妥的验证方式是手动触发一次：UPDATE articles SET title = title WHERE id = 1;，再查 tsv 列是否变化。
