12.6. 词典

12.6.1. 屏蔽词

屏蔽词是很常见的词，出现在几乎每一个文档中，并且没有区分值。因此，他们可以在全文搜索的环境中被忽视的。 例如，每个英文文本包含像a 和 the的单词，因此它们在索引中存储无效。然而，屏蔽词影响在tsvector中的位置， 这反过来也影响相关度：

SELECT to_tsvector('english','in the list of stop words');
        to_tsvector
----------------------------
 'list':3 'stop':5 'word':6

丢失位置1,2,4是因为屏蔽词。带有和没有屏蔽词的文档排序计算是完全不同的：

SELECT ts_rank_cd (to_tsvector('english','in the list of stop words'), to_tsquery('list & stop'));
 ts_rank_cd
------------
       0.05

SELECT ts_rank_cd (to_tsvector('english','list stop words'), to_tsquery('list & stop'));
 ts_rank_cd
------------
        0.1

如何处理屏蔽词，它是由特定词典决定的。例如，ispell词典首先规范词，然后查看屏蔽词列表， 而Snowball词干首先检查屏蔽词列表。这个不同操作的原因是为了减少噪音。

12.6.2. Simple 词典

simple字典模板通过转换输入标记为小写字母进行，并且屏蔽词文件前检查它。 如果在文档中找到并返回空数组，则丢弃这个标记。如果没有，单词的小写字母形式作为归一化的词返回。 另外，词典可以为报告未识别的非屏蔽词进行配置，允许将它们传递到列表中的后继词典中。

这有使用simple模板的词典定义的例子：

CREATE TEXT SEARCH DICTIONARY public.simple_dict (
    TEMPLATE = pg_catalog.simple,
    STOPWORDS = english
);

在这里，english是一种屏蔽词文件的基础名称。文档的全名为$SHAREDIR/tsearch_data/english.stop， 这里的$SHAREDIR是PostgreSQL安装的共享数据目录，经常使用/usr/local/share/postgresql（如果你不确定， 则使用pg_config --sharedir来决定）。文档格式是一个简单的单词列表，每行一个。忽略空白行和空格， 并且大写字母转换成小写字母，但对文档内容没有其他的处理方式。

现在我们可以测试我们的词典：

SELECT ts_lexize('public.simple_dict','YeS');
 ts_lexize
-----------
 {yes}

SELECT ts_lexize('public.simple_dict','The');
 ts_lexize
-----------
 {}

如果没在屏蔽词文件中找到，我们也可以选择返回NULL，而不是小写字母单词。 这种行为是通过设置字典的Accept参数为false选择的。继续例子：

ALTER TEXT SEARCH DICTIONARY public.simple_dict ( Accept = false );

SELECT ts_lexize('public.simple_dict','YeS');
 ts_lexize
-----------


SELECT ts_lexize('public.simple_dict','The');
 ts_lexize
-----------
 {}

随着缺省设置Accept = true，它把simple词典放在词典列表末尾的时候是很有用的， 因为它不会传递任何标记给后继词典。相反，当至少有一个后继词典时，Accept = false是唯一有用的。

12.6.3. 同义词词典

这个字典模板用于创建替代词和同义词的词典。不支持短语（使用同义词库模板（节Section 12.6.4）。 一个同义词词典可以用来克服语言上的问题，例如，防止英语词干词典使单词"Paris"变成"pari"。 这足以在同义词词典中有Paris paris行并且放在english_stem词典之前。比如：

SELECT * FROM ts_debug('english', 'Paris');
   alias   |   description   | token |  dictionaries  |  dictionary  | lexemes 
-----------+-----------------+-------+----------------+--------------+---------
 asciiword | Word, all ASCII | Paris | {english_stem} | english_stem | {pari}

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

ALTER TEXT SEARCH CONFIGURATION english
    ALTER MAPPING FOR asciiword
    WITH my_synonym, english_stem;

SELECT * FROM ts_debug('english', 'Paris');
   alias   |   description   | token |       dictionaries        | dictionary | lexemes 
-----------+-----------------+-------+---------------------------+------------+---------
 asciiword | Word, all ASCII | Paris | {my_synonym,english_stem} | my_synonym | {paris}

synonym模版要求的唯一的参数是SYNONYMS，这是它的配置文件的基础名称—上面例子中my_synonyms。 文件的全名为$SHAREDIR/tsearch_data/my_synonyms.syn（$SHAREDIR是PostgreSQL安装的共享数据目录）。 文件格式是每一行的每个字被取代，带有这个词的同义词，用空格分隔。忽略空白行和空格。

synonym模版也有一个可选的参数CaseSensitive，缺省是false。当CaseSensitive是false时， 同义词文件中的词转换成小写字母，正如输入标记。 比较而言，当它是true时，词语和标记不转换成小写字母

星号（*）可以被放置在配置文件中的同义词结尾。这表明，同义词是一个前缀。 当在to_tsvector()中使用记录时，忽略星号。但当它被用在to_tsquery()中时， 结果将是带前缀匹配标记的查询记录（参见节Section 12.3.2）。例如，假设我们在$SHAREDIR/tsearch_data/synonym_sample.syn中有这些记录。

postgres        pgsql
postgresql      pgsql
postgre pgsql
gogle   googl
indices index*

然后我们将得到这些结果：

mydb=# CREATE TEXT SEARCH DICTIONARY syn (template=synonym, synonyms='synonym_sample');
mydb=# SELECT ts_lexize('syn','indices');
 ts_lexize
-----------
 {index}
(1 row)

mydb=# CREATE TEXT SEARCH CONFIGURATION tst (copy=simple);
mydb=# ALTER TEXT SEARCH CONFIGURATION tst ALTER MAPPING FOR asciiword WITH syn;
mydb=# SELECT to_tsvector('tst','indices');
 to_tsvector
-------------
 'index':1
(1 row)

mydb=# SELECT to_tsquery('tst','indices');
 to_tsquery
------------
 'index':*
(1 row)

mydb=# SELECT 'indexes are very useful'::tsvector;
            tsvector             
---------------------------------
 'are' 'indexes' 'useful' 'very'
(1 row)

mydb=# SELECT 'indexes are very useful'::tsvector @@ to_tsquery('tst','indices');
 ?column?
----------
 t
(1 row)

12.6.4. 同义词词典库

同义词词库（有时简称TZ）是一个单词的组合，包括单词和短语的关系信息， 比如，更广泛术语（BT），更窄的术语（NT），首选术语，非优先术语，相关术语等。

基本上同义词词库通过一个首选的术语替换所有非优先术语，另外，也保留索引的原术语。 同义词词典PostgreSQL的当前实现是带有附加短语支持的同义词词典的扩展。同义词词典需要下列格式的配置文件：

# this is a comment
sample word(s) : indexed word(s)
more sample word(s) : more indexed word(s)
...

冒号（:）符号作为短语和其替代物之间的分隔符。

同义词词典检查短语匹配之前使用一个子词典（这是在字典的配置中指定）规范输入文本。 它选择一个子词典是可能的。如果子词典无法识别单词，报告一个错误。在这种情况下， 你应该删除这个词或训练子词典。你可以在一个索引字跳过应用子词典的开头放一个星号（*）， 但是所有简单的词必须是子词典已知的。

如果有多个短语匹配输入，同义词词典选择最长的匹配。并且使用最后一个定义分离关系。

通过子词典识别的具体屏蔽词不能被指定；而使用?标记任何屏蔽词出现的位置。 例如，假设a和the是依据子词典的屏蔽词：

? one ? two : swsw

匹配a one the two和the one a two；两者都会被swsw替代。

由于同义词词典有能力识别短语，它必须记住其状态并且与分析器交互。同义词词典使用这些任务检查它是否应该处理下一个词， 或停止积累。同义词词典必须小心配置。例如，如果字典词库分配只处理asciiword标记，那么像one 7的同义词词典定义将不工作， 因为标记类型uint不分配给同义词词典。

CREATE TEXT SEARCH DICTIONARY thesaurus_simple (
    TEMPLATE = thesaurus,
    DictFile = mythesaurus,
    Dictionary = pg_catalog.english_stem
);

ALTER TEXT SEARCH CONFIGURATION russian
    ALTER MAPPING FOR asciiword, asciihword, hword_asciipart
    WITH thesaurus_simple;

supernovae stars : sn
crab nebulae : crab

CREATE TEXT SEARCH DICTIONARY thesaurus_astro (
    TEMPLATE = thesaurus,
    DictFile = thesaurus_astro,
    Dictionary = english_stem
);

ALTER TEXT SEARCH CONFIGURATION russian
    ALTER MAPPING FOR asciiword, asciihword, hword_asciipart
    WITH thesaurus_astro, english_stem;

SELECT plainto_tsquery('supernova star');
 plainto_tsquery
-----------------
 'sn'

SELECT to_tsvector('supernova star');
 to_tsvector
-------------
 'sn':1

SELECT to_tsquery('''supernova star''');
 to_tsquery
------------
 'sn'

supernovae stars : sn supernovae stars

SELECT plainto_tsquery('supernova star');
       plainto_tsquery
-----------------------------
 'sn' & 'supernova' & 'star'

12.6.5. Ispell词典

Ispell词典模版支持形态学的词典，它可以将一个单词的许多不同的语言形式标准化为一个词。 例如，英语Ispell词典可以匹配所有词尾变化和搜索词bank的组合， 例如，banking, banked, banks, banks'和bank's。

标准的PostgreSQL发布不包括任何Ispell配置文件。大量的语言字典可以从Ispell获得。 同时，— MySpell (OO < 2.0.1) 和Hunspell(OO >= 2.0.2)支持一些更现代的词典文件格式。 大的词典列表在OpenOffice Wiki中可用。

使用内置的ispell模板创建Ispell 词典，并指定几个参数：

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

这里，DictFile, AffFile和StopWords指定词典基础的名字，词缀，和屏蔽词文件。 屏蔽词文件具有和上面解释的simple词典类型相同的格式。其它文件的格式不在这里指定， 但可以从上面提到的网站获取。

Ispell词典通常识别有限的一组词，所以他们应该遵循另一个更广泛的词典； 例如，一个Snowball词典，它可以识别一切。

Ispell词典支持分裂复合词；一个有用的功能。请注意， 词缀文件应使用compound words controlled语句指定一个特殊标记， 标记可以参与复合信息的词典单词：

compoundwords  controlled z

这有一些Norwegian语言的例子：

SELECT ts_lexize('norwegian_ispell', 'overbuljongterningpakkmesterassistent');
   {over,buljong,terning,pakk,mester,assistent}
SELECT ts_lexize('norwegian_ispell', 'sjokoladefabrikk');
   {sjokoladefabrikk,sjokolade,fabrikk}

12.6.6. Snowball词典

Snowball词典模板是基于Martin Porter的项目，他是英语语言的著名的Porter的词干提取算法的发明者。 现在Snowball提供了许多语言的词干提取算法（更多信息请见Snowball site）。 每个算法都知道如何改变词到基础，或词根，或其语言拼写的常见变异形式。 一个Snowball词典需要language参数标识要使用的词干，并且可以指定一个删除词的列表的stopword文件名。 （PostgreSQL的标准的屏蔽词列表也由Snowball项目提供）例如，有一个等价的内置定义。

CREATE TEXT SEARCH DICTIONARY english_stem (
    TEMPLATE = snowball,
    Language = english,
    StopWords = english
);

屏蔽词的文件格式和已经解释过的一样。

一个Snowball词典可以识别一切，是否能够简化字，所以它应该放在词典列表的末尾。 它放在任何其他的词典之前都是无用的，因为一个标记将不会经过它到下一个词典。