文档是全文检索系统中的搜索单位，例如一篇杂志文章或一封电子邮件。文本检索引擎必须能够解析文档，并保存词位（关键字）与其所属文档之间的关联。随后，就可以利用这些关联来搜索包含查询词的文档。

在 PostgreSQL 中进行搜索时，文档通常是数据库表某一行中的一个文本字段，或者是这类字段的组合（串接），这些字段可能分布在多个表里，也可能是动态取得的。换句话说，文档可以由不同部分拼接而成以供索引，而且未必会以一个整体存储在任何地方。例如：

SELECT title || ' ' ||  author || ' ' ||  abstract || ' ' || body AS document
FROM messages
WHERE mid = 12;

SELECT m.title || ' ' || m.author || ' ' || m.abstract || ' ' || d.body AS document
FROM messages m, docs d
WHERE m.mid = d.did AND m.mid = 12;

另一种做法是把文档存储为文件系统中的普通文本文件。在这种情况下，数据库可以用于保存全文索引并执行搜索，而文档本身则借助某个唯一标识符从文件系统中取回。不过，从数据库外部检索文件需要超级用户权限或特殊函数支持，因此这种方法通常不如把所有数据都保存在 PostgreSQL 内部方便。此外，把所有内容都放在数据库中，也便于访问文档元数据来辅助索引和展示。

为了进行文本检索，每个文档都必须被化简为预处理后的 tsvector 格式。搜索和排名完全基于文档的 tsvector 表示来执行 — 只有当文档被选中并准备展示给用户时，才需要取回原始文本。因此，我们常常把 tsvector 直接称作文档，但它当然只是完整文档的一种紧凑表示。

在PostgreSQL中，全文检索基于匹配操作符@@。如果一个tsvector（文档）匹配一个tsquery（查询），它就返回true。哪一种数据类型写在前面并不重要：

SELECT 'a fat cat sat on a mat and ate a fat rat'::tsvector @@ 'cat & rat'::tsquery;
 ?column?
----------
 t

SELECT 'fat & cow'::tsquery @@ 'a fat cat sat on a mat and ate a fat rat'::tsvector;
 ?column?
----------
 f

正如上例所示，tsquery并不只是原始文本，tsvector也不是。tsquery包含搜索词，这些搜索词必须已经是正规化后的词位，并且可以用 AND、OR 和 NOT 操作符把多个搜索词组合起来。（详情见第 8.11 节。）to_tsquery和plainto_tsquery有助于把用户输入的文本转换为合适的 tsquery，例如对文本中的词做正规化。类似地，to_tsvector 用于解析并正规化文档字符串。因此在实践中，文本检索匹配更像是这样：

SELECT to_tsvector('fat cats ate fat rats') @@ to_tsquery('fat & rat');
 ?column?
----------
 t

请注意，如果写成

SELECT 'fat cats ate fat rats'::tsvector @@ to_tsquery('fat & rat');
 ?column?
----------
 f

就不会匹配成功，因为这里不会对单词 rats 做正规化。tsvector 的元素是词位，被假定为已经正规化，因此 rats 不会匹配 rat。

@@操作符也支持text输入，因此在简单场景下可以跳过把文本字符串显式转换为tsvector或tsquery。可用的形式有：

tsvector @@ tsquery
tsquery  @@ tsvector
text @@ tsquery
text @@ text

前两种形式我们已经见过。text @@ tsquery 等价于 to_tsvector(x) @@ y。text @@ text 等价于 to_tsvector(x) @@ plainto_tsquery(y)。

前述的都是简单的文本检索示例。正如前面所提到的，全文检索功能包括做更多事情的能力：跳过索引特定词（停用词）、处理同义词并使用更高级的解析，例如不局限于按空白划分的解析。这个功能由文本检索配置控制。PostgreSQL中有多种语言的预定义配置，并且你可以很容易地创建你自己的配置（psql的\dF命令显示所有可用的配置）。

在安装期间会选择一个合适的配置，并据此在postgresql.conf中设置default_text_search_config。如果整个集簇都使用同一种文本检索配置，你可以直接使用postgresql.conf中的这个值。若要在整个集簇中使用不同配置，但保证每个数据库内部使用同一种配置，可以使用ALTER DATABASE ... SET。否则，你也可以在每个会话中设置default_text_search_config。

依赖一个配置的每一个文本检索函数都有一个可选的regconfig参数，因此要使用的配置可以被显式指定。只有当省略这个参数时，default_text_search_config才被使用。

为了便于构建自定义文本检索配置，配置由更简单的数据库对象组合而成。PostgreSQL 的文本检索功能提供了四类与配置相关的数据库对象：

文本检索解析器和模板由底层 C 函数构成，因此开发新的解析器和模板需要 C 编程能力，将它们安装到数据库中则需要超级用户权限。（PostgreSQL 发行版的 contrib/ 目录中有附加解析器和模板的示例。）词典和配置只是为底层解析器和模板设置参数并将它们连接起来，因此创建新词典或配置不需要特殊权限。本章后面会给出创建自定义词典和配置的示例。