SQL Academy · 课时

使用 tsvector 和 GIN 进行全文搜索

Q: 「使用 tsvector 和 GIN 进行全文搜索」这节课中我会学到什么？

使用 tsvector 列、GIN 索引和可配置的文本搜索字典构建生产级全文搜索 你通过在浏览器中直接运行的动手代码来练习 SQL Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

使用 tsvector 列、GIN 索引和可配置的文本搜索字典构建生产级全文搜索

第 2 / 4 课14 个步骤

使用 tsvector 和 GIN 进行全文搜索 是 CoddyKit 上的免费 SQL Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 SQL Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 SQL Academy 课程共包含 4 节课。

超越子字符串：面向词语的搜索

全文搜索（FTS）能够理解词语：词干提取、停用词和排名。PostgreSQL 通过 tsvector / tsquery 类型内置了这一功能。

构建 tsvector

解析文档：

SELECT to_tsvector('english', 'The quick brown foxes jumped over');
-- 'brown':3 'fox':4 'jump':5 'quick':2

构建 tsquery

解析查询：

SELECT to_tsquery('english', 'fox & jumping');     -- 'fox' & 'jump'
SELECT websearch_to_tsquery('english', 'fox jumping -lazy');

匹配：@@

根据查询测试文档：

SELECT 'fox jumping'::tsvector @@ 'fox & jump'::tsquery;     -- t

用于 FTS 的索引

添加 tsvector 列和 GIN 索引：

ALTER TABLE articles
  ADD COLUMN search_doc tsvector
    GENERATED ALWAYS AS (
      to_tsvector('english', coalesce(title,'') || ' ' || coalesce(body,''))
    ) STORED;

CREATE INDEX articles_search_idx ON articles USING GIN (search_doc);

查询

快速筛选搜索：

SELECT id, title FROM articles
WHERE search_doc @@ websearch_to_tsquery('english', 'postgres performance')
ORDER BY ts_rank(search_doc, websearch_to_tsquery('english', 'postgres performance')) DESC
LIMIT 20;

使用 ts_rank 排名

ts_rank 会根据词频和位置为结果评分。ts_rank_cd 使用覆盖密度（考虑位置）：

SELECT id, ts_rank_cd(search_doc, q) AS rank
FROM articles, websearch_to_tsquery('english', $1) AS q
WHERE search_doc @@ q
ORDER BY rank DESC LIMIT 20;

使用 ts_headline 显示片段

显示匹配的片段，并突出显示其中的匹配词：

SELECT ts_headline('english', body,
  websearch_to_tsquery('english', $1),
  'StartSel=<mark>, StopSel=</mark>, MaxFragments=2')
FROM articles
WHERE search_doc @@ websearch_to_tsquery('english', $1);

短语搜索

查找相邻词语：

SELECT * FROM articles
WHERE search_doc @@ phraseto_tsquery('english', 'database performance');

多字段加权

使用 setweight 让标题的权重高于正文：

ALTER TABLE articles
  ADD COLUMN search_doc tsvector
    GENERATED ALWAYS AS (
      setweight(to_tsvector('english', coalesce(title,'')), 'A') ||
      setweight(to_tsvector('english', coalesce(body,'')),  'B')
    ) STORED;

语言配置

english 配置定义了停用词、词干提取等内容。PostgreSQL 内置了多种语言；请按语言切换：

SELECT to_tsvector('turkish', 'Veritabanı performansı');

内置 FTS 的局限

适用于类似英语的语言，提供基本排名。若有更高级的需求（BM25、向量嵌入、分面搜索），可以在 Postgres 旁结合使用 Elasticsearch 或 OpenSearch。

回顾

PostgreSQL FTS 是一个可靠的默认选择。

tsvector + tsquery + @@ 匹配
使用 GIN 索引提高速度
使用 websearch_to_tsquery 处理用户输入
使用 ts_rank/ts_headline 生成排序并突出显示的结果

快速检查

您需要根据全文查询快速筛选文章。应该使用哪种索引？

在交互式课程中回答

免费开始

用 AI 导师学习 SQL — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 46
课程: 183

免费开始学习查看完整课程

常见问题解答

「使用 tsvector 和 GIN 进行全文搜索」课时是免费的吗？

是的 — 「使用 tsvector 和 GIN 进行全文搜索」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 SQL Academy 课程的其余内容，请升级到 CoddyKit PRO。 SQL Academy 课程共包含 4 节课。

「使用 tsvector 和 GIN 进行全文搜索」这节课中我会学到什么？

使用 tsvector 列、GIN 索引和可配置的文本搜索字典构建生产级全文搜索你通过在浏览器中直接运行的动手代码来练习 SQL Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 SQL Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 SQL Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「使用 tsvector 和 GIN 进行全文搜索」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 SQL Academy 课中编写并运行代码吗？

能。每节 SQL Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 SQL Academy