↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3

12.7. 配置示例 #

一个文本检索配置指定了将一个文档转换成一个 tsvector 所需的所有选项:用于把文本分解成词元的解析器,以及用于将每一个词元转换成词位的词典。每一次 to_tsvector 或 to_tsquery 的调用都需要一个文本检索配置来执行其处理。配置参数 default_text_search_config 指定了默认配置的名称,如果省略了显式的配置参数,文本检索函数将会使用它。它可以在 postgresql.conf 中设置,或者使用 SET 命令为一个单独的会话设置。

有一些预定义的文本检索配置可用,并且你可以容易地创建自定义的配置。为了便于管理文本检索对象,可以使用一组 SQL 命令,并且有多个 psql 命令可以显示有关文本检索对象(第 12.10 节)的信息。

作为一个示例,我们将创建一个配置 pg,从复制内置的 english 配置开始:

CREATE TEXT SEARCH CONFIGURATION public.pg ( COPY = pg_catalog.english );

我们将使用一个 PostgreSQL 相关的同义词列表,并将它存储在 $SHAREDIR/tsearch_data/pg_dict.syn 中。文件内容看起来像:

postgres    pg
pgsql       pg
postgresql  pg

我们定义同义词词典如下:

CREATE TEXT SEARCH DICTIONARY pg_dict (
    TEMPLATE = synonym,
    SYNONYMS = pg_dict
);

接下来我们注册 Ispell 词典 english_ispell,它有其自己的配置文件:

CREATE TEXT SEARCH DICTIONARY english_ispell (
    TEMPLATE = ispell,
    DictFile = english,
    AffFile = english,
    StopWords = english
);

现在我们可以在配置 pg 中建立词的映射:

ALTER TEXT SEARCH CONFIGURATION pg
    ALTER MAPPING FOR asciiword, asciihword, hword_asciipart,
                      word, hword, hword_part
    WITH pg_dict, english_ispell, english_stem;

我们选择不索引或搜索某些内置配置确实处理的词元类型:

ALTER TEXT SEARCH CONFIGURATION pg
    DROP MAPPING FOR email, url, url_path, sfloat, float;

现在我们可以测试我们的配置:

SELECT * FROM ts_debug('public.pg', '
PostgreSQL, the highly scalable, SQL compliant, open source object-relational
database management system, is now undergoing beta testing of the next
version of our software.
');

下一步是把会话设置为使用这个新配置,该配置是在 public 模式中创建的:

=> \dF
   List of text search configurations
 Schema  | Name | Description
---------+------+-------------
 public  | pg   |

SET default_text_search_config = 'public.pg';
SET

SHOW default_text_search_config;
 default_text_search_config
----------------------------
 public.pg

报告文档问题

阅读 上游文档. 通过 PostgreSQL 文档反馈表单.