第 12.3.1 节展示了如何将原始文本文档转换为 tsvector 值。PostgreSQL 还提供了函数和运算符，可用于操作已采用 tsvector 格式的文档。

有关 tsvector 相关函数的完整列表，请参阅表 9.43。

第 12.3.2 节展示了如何将原始文本查询转换为 tsquery 值。PostgreSQL 还提供了函数和运算符，可用于操作已采用 tsquery 格式的查询。

CREATE TABLE aliases (t tsquery primary key, s tsquery);
INSERT INTO aliases VALUES(to_tsquery('supernovae'), to_tsquery('supernovae|sn'));

SELECT ts_rewrite(to_tsquery('supernovae & crab'), 'SELECT * FROM aliases');
           ts_rewrite
---------------------------------
 'crab' & ( 'supernova' | 'sn' )

UPDATE aliases
SET s = to_tsquery('supernovae|sn & !nebulae')
WHERE t = to_tsquery('supernovae');

SELECT ts_rewrite(to_tsquery('supernovae & crab'), 'SELECT * FROM aliases');
                 ts_rewrite
---------------------------------------------
 'crab' & ( 'supernova' | 'sn' & !'nebula' )

SELECT ts_rewrite('a & b'::tsquery,
                  'SELECT t,s FROM aliases WHERE ''a & b''::tsquery @> t');
 ts_rewrite
------------
 'b' & 'c'

当使用单独的列来存储文档的 tsvector 表示时，有必要创建一个触发器，以便在文档内容列发生更改时更新 tsvector 列。为此，可以使用两个内置的触发器函数，或者您可以编写自己的触发器函数。

tsvector_update_trigger(tsvector_column_name,​ config_name, text_column_name [, ... ])
tsvector_update_trigger_column(tsvector_column_name,​ config_column_name, text_column_name [, ... ])

这些触发器函数会在 CREATE TRIGGER 命令中指定的参数的控制下，自动从一个或多个文本列计算 tsvector 列。以下是它们的用法示例

CREATE TABLE messages (
    title       text,
    body        text,
    tsv         tsvector
);

CREATE TRIGGER tsvectorupdate BEFORE INSERT OR UPDATE
ON messages FOR EACH ROW EXECUTE FUNCTION
tsvector_update_trigger(tsv, 'pg_catalog.english', title, body);

INSERT INTO messages VALUES('title here', 'the body text is here');

SELECT * FROM messages;
   title    |         body          |            tsv
------------+-----------------------+----------------------------
 title here | the body text is here | 'bodi':4 'text':5 'titl':1

SELECT title, body FROM messages WHERE tsv @@ to_tsquery('title & body');
   title    |         body
------------+-----------------------
 title here | the body text is here

创建此触发器后，title 或 body 中的任何更改都将自动反映到 tsv 中，而无需应用程序为此担心。

第一个触发器参数必须是要更新的 tsvector 列的名称。第二个参数指定用于执行转换的文本搜索配置。对于 tsvector_update_trigger，配置名称只需作为第二个触发器参数给出。它必须像上面那样使用模式限定，这样触发器行为就不会随着 search_path 的变化而改变。对于 tsvector_update_trigger_column，第二个触发器参数是另一个表列的名称，该列必须是 regconfig 类型。这允许每行选择配置。其余的参数是文本列（类型为 text、varchar 或 char）的名称。这些列将按给定的顺序包含在文档中。NULL 值将被跳过（但其他列仍将被索引）。

这些内置触发器的一个限制是它们以相同的方式处理所有输入列。要以不同的方式处理列（例如，对标题的加权与正文不同），必须编写自定义触发器。以下是使用 PL/pgSQL 作为触发器语言的示例

CREATE FUNCTION messages_trigger() RETURNS trigger AS $$
begin
  new.tsv :=
     setweight(to_tsvector('pg_catalog.english', coalesce(new.title,'')), 'A') ||
     setweight(to_tsvector('pg_catalog.english', coalesce(new.body,'')), 'D');
  return new;
end
$$ LANGUAGE plpgsql;

CREATE TRIGGER tsvectorupdate BEFORE INSERT OR UPDATE
    ON messages FOR EACH ROW EXECUTE FUNCTION messages_trigger();

请记住，在触发器内部创建 tsvector 值时，显式指定配置名称非常重要，这样列的内容就不会受到 default_text_search_config 更改的影响。否则很可能会导致诸如在转储和恢复后搜索结果发生变化的问题。

函数 ts_stat 对于检查您的配置和查找停用词候选项非常有用。

ts_stat(sqlquery text, [ weights text, ]
        OUT word text, OUT ndoc integer,
        OUT nentry integer) returns setof record

sqlquery 是一个文本值，包含一个 SQL 查询，该查询必须返回单个 tsvector 列。ts_stat 执行查询并返回有关 tsvector 数据中包含的每个不同词素（单词）的统计信息。返回的列包括

如果提供了 weights，则仅计算具有这些权重之一的出现次数。

例如，查找文档集合中出现频率最高的前十个单词

SELECT * FROM ts_stat('SELECT vector FROM apod')
ORDER BY nentry DESC, ndoc DESC, word
LIMIT 10;

相同，但仅计算权重为 A 或 B 的单词出现次数

SELECT * FROM ts_stat('SELECT vector FROM apod', 'ab')
ORDER BY nentry DESC, ndoc DESC, word
LIMIT 10;