ts_rank()不是窗口函数，不能直接加over子句；必须先计算分数再用rank()等窗口函数基于该分数排序，且中文需zhparser等扩展才能获得有效分词和可区分的排名分数。
为什么不能直接用 ts_rank() 做窗口排序？
很多人一上来就写 ORDER BY ts_rank(...) 加 OVER ()，结果报错：ERROR: window function ts_rank() is not allowed。这是因为 ts_rank() 和 ts_rank_cd() 是普通标量函数，不是窗口函数——PostgreSQL 不允许把它们直接套在 OVER 子句里。
真正能开窗的是排序逻辑本身，不是评分函数。所以得先算出每个匹配行的分数，再用窗口函数（比如 ROW_NUMBER()、RANK()）基于这个分数排序或分组。
怎么给全文检索结果加可开窗的评分字段？
核心是把 to_tsvector() 和 plainto_tsquery() 配合 ts_rank() 写成一个计算列，再在这个列上应用窗口函数。注意三点：
-
ts_rank()的第二个参数必须是tsvector字段（或表达式），不能是文本字段直接传入；否则会隐式转换但丢失权重信息 - 推荐用
ts_rank_cd()替代ts_rank()，它对短文档（如标题、摘要）更敏感，且支持文档长度归一化 - 如果检索字段有多个（比如
title和body），要先拼接再转tsvector，例如：to_tsvector('english', coalesce(title, '') || ' ' || coalesce(body, ''))
示例：
SELECT
id,
title,
ts_rank_cd(
to_tsvector('english', title || ' ' || coalesce(content, '')),
plainto_tsquery('english', 'database optimization')
) AS rank_score,
RANK() OVER (ORDER BY ts_rank_cd(
to_tsvector('english', title || ' ' || coalesce(content, '')),
plainto_tsquery('english', 'database optimization')
) DESC) AS rank_position
FROM documents
WHERE to_tsvector('english', title || ' ' || coalesce(content, ''))
@@ plainto_tsquery('english', 'database optimization');
如何避免重复计算 ts_rank_cd() 导致性能下降？
上面的 SQL 在 SELECT 和 WHERE 里各算了一次 ts_rank_cd()，在大表上很慢。解决办法是用 CTE 或子查询把评分提前算好：
PostgreSQL 18.4 官方 Ubuntu 安装包现已发布，这是目前最新的稳定版本。推荐通过官方 APT 仓库安装：先执行 sudo apt update 更新索引，再运行 sudo apt install postgresql-18 即可完成部署。新版本引入了异步 I/O 子系统，在顺序扫描与 VACUUM 场景下性能提升显著，同时支持 UUID v7 原生生成函数与虚拟生成列。
- CTE 最清晰：先过滤再评分，避免对全表调用
ts_rank_cd() - 别在
WHERE里写ts_rank_cd(...) > 0.1这种条件——全文检索的谓词下推依赖@@，ts_rank_cd()无法走索引，纯 CPU 过滤 - 如果要按分数阈值截断，务必放在 CTE 外层，而不是 WHERE 里
优化后写法：
WITH ranked AS (
SELECT
id,
title,
ts_rank_cd(
to_tsvector('english', title || ' ' || coalesce(content, '')),
plainto_tsquery('english', 'database optimization')
) AS score
FROM documents
WHERE to_tsvector('english', title || ' ' || coalesce(content, ''))
@@ plainto_tsquery('english', 'database optimization')
)
SELECT
id,
title,
score,
ROW_NUMBER() OVER (ORDER BY score DESC) AS rn
FROM ranked
WHERE score > 0.05;
中文全文检索时 ts_rank() 为什么几乎不生效？
PostgreSQL 原生中文分词能力极弱，to_tsvector('chinese', ...) 实际上只是按字切分，没有语义粒度，导致 ts_rank() 返回的分数全部趋近于 0 或完全相同。这不是窗口函数的问题，而是底层分词失效。
真实可用的方案只有两个：
- 用扩展如
zhparser（需编译安装），并配置对应词典，之后才能得到有意义的tsvector和可区分的ts_rank()分数 - 改用外部引擎（如 Elasticsearch 或 PgVector + embedding），PostgreSQL 自带全文检索对中文基本只适合“存在性判断”，不适合“排序打分”
哪怕你把窗口函数写得再漂亮，输入是无效 tsvector，输出就是无意义数字。
