©
本文档使用 PHP中文网手册 发布
Table 9-36， Table 9-37和 Table 9-38 概述了提供全文检索函数和操作符。 详见Chapter 12 PostgreSQL文本检索功能的说明。
Table 9-36. 文本检索操作符
| 操作符 | 描述 | 示例 | 结果 |
|---|---|---|---|
| @@ | tsvector匹配tsquery? | to_tsvector('fat cats ate rats') @@ to_tsquery('cat & rat') | t |
| @@@ | deprecated synonym for@@ | to_tsvector('fat cats ate rats') @@@ to_tsquery('cat & rat') | t |
| || | 连接tsvectors | 'a:1 b:2'::tsvector || 'c:1 d:2 b:3'::tsvector | 'a':1 'b':2，5 'c':3 'd':4 |
| && | 和tsquerys 一起来与 | 'fat | rat'::tsquery && 'cat'::tsquery | ( 'fat' | 'rat' ) & 'cat' |
| || | 和tsquerys一起来或 | 'fat | rat'::tsquery || 'cat'::tsquery | ( 'fat' | 'rat' ) | 'cat' |
| !! | tsquery非 | !! 'cat'::tsquery | !'cat' |
| @> | tsquery包含另一个 ? | 'cat'::tsquery @> 'cat & rat'::tsquery | f |
| <@ | tsquery包含于 ? | 'cat'::tsquery <@ 'cat & rat'::tsquery | t |
Note: tsquery的操作符只考虑两个的查询的情况，忽略组合的操作符。
除了显示在表中的操作符，还定义了普通的B-tree比较操作符（=，<， 等）。它们对于文本检索不是很有用，但是允许使用。 例如，建在这些类型列上的唯一索引。
Table 9-37. 文本检索函数
| 函数 | 返回类型 | 描述 | 示例 | 结果 |
|---|---|---|---|---|
to_tsvector([configregconfig，]documenttext) |
tsvector | 减少文档中的文本到tsvector | to_tsvector('english'， 'The Fat Rats') | 'fat':2 'rat':3 |
length(tsvector) |
integer | tsvector的单词数 | length('fat:2，4 cat:3 rat:5A'::tsvector) | 3 |
setweight(tsvector，"char") |
tsvector | 给tsvector的每个元素赋予权值 | setweight('fat:2，4 cat:3 rat:5B'::tsvector， 'A') | 'cat':3A 'fat':2A，4A 'rat':5A |
strip(tsvector) |
tsvector | 删除tsvector中的位置和权值 | strip('fat:2，4 cat:3 rat:5A'::tsvector) | 'cat' 'fat' 'rat' |
to_tsquery([configregconfig，]querytext) |
tsquery | 标准化单词并转换为tsquery | to_tsquery('english'， 'The & Fat & Rats') | 'fat' & 'rat' |
plainto_tsquery([configregconfig，]querytext) |
tsquery | 产生tsquery忽略标点 | plainto_tsquery('english'， 'The Fat Rats') | 'fat' & 'rat' |
numnode(tsquery) |
integer | tsquery中的单词加上操作符的数量 | numnode('(fat & rat) | cat'::tsquery) | 5 |
querytree(querytsquery) |
text | 获取tsquery可索引的部分 | querytree('foo & ! bar'::tsquery) | 'foo' |
ts_rank([weightsfloat4[]，]vectortsvector，querytsquery[，normalizationinteger]) |
float4 | 文档查询排名 | ts_rank(textsearch， query) | 0.818 |
ts_rank_cd([weightsfloat4[]，]vectortsvector，querytsquery[，normalizationinteger]) |
float4 | 排序文件查询使用覆盖密度 | ts_rank_cd('{0.1， 0.2， 0.4， 1.0}'， textsearch， query) | 2.01317 |
ts_headline([configregconfig，]documenttext，querytsquery[，optionstext]) |
text | 显示一个查询的匹配项 | ts_headline('x y z'， 'z'::tsquery) | x y <b>z</b> |
ts_rewrite(querytsquery，targettsquery，substitutetsquery) |
tsquery | 替换带有查询的替代目标 | ts_rewrite('a & b'::tsquery， 'a'::tsquery， 'foo|bar'::tsquery) | 'b' & ( 'foo' | 'bar' ) |
ts_rewrite(querytsquery，selecttext) |
tsquery | 从一条SELECT命令的替代目标做替换 | SELECT ts_rewrite('a & b'::tsquery， 'SELECT t，s FROM aliases') | 'b' & ( 'foo' | 'bar' ) |
get_current_ts_config() |
regconfig | 获取文本检索的默认配置 | get_current_ts_config() | english |
tsvector_update_trigger() |
trigger | 自动更新tsvector列的触发器函数 | CREATE TRIGGER ... tsvector_update_trigger(tsvcol， 'pg_catalog.swedish'， title， body) | |
tsvector_update_trigger_column() |
trigger | 自动更新tsvector列的触发器函数 | CREATE TRIGGER ... tsvector_update_trigger_column(tsvcol， configcol， title， body) |
Note: 所有的文本检索函数，接受一个选项regconfig参数。当这个参数忽略，使用由default_text_search_config指定的配置。
Table 9-38单独列出的函数，因为他们通常不用在每天文本检索操作。 它们有助于开发调试新文本检索配置。
Table 9-38. 文本检索调试函数
| 函数 | 返回类型 | 描述 | 示例 | 结果 |
|---|---|---|---|---|
ts_debug([configregconfig，]documenttext， OUTaliastext， OUTdescriptiontext， OUTtokentext， OUTdictionariesregdictionary[]， OUTdictionaryregdictionary， OUTlexemestext[]) |
setof record | 测试一个配置 | ts_debug('english'， 'The Brightest supernovaes') | (asciiword，"Word， all ASCII"，The，{english_stem}，english_stem，{}) ... |
ts_lexize(dictregdictionary，tokentext) |
text[] | 测试一个数据字典 | ts_lexize('english_stem'， 'stars') | {star} |
ts_parse(parser_nametext，documenttext， OUTtokidinteger， OUTtokentext) |
setof record | 测试一个解析 | ts_parse('default'， 'foo - bar') | (1，foo) ... |
ts_parse(parser_oidoid，documenttext， OUTtokidinteger， OUTtokentext) |
setof record | 测试一个解析 | ts_parse(3722， 'foo - bar') | (1，foo) ... |
ts_token_type(parser_nametext， OUTtokidinteger， OUTaliastext， OUTdescriptiontext) |
setof record | 由解析器获取分词类型的定义 | ts_token_type('default') | (1，asciiword，"Word， all ASCII") ... |
ts_token_type(parser_oidoid， OUTtokidinteger， OUTaliastext， OUTdescriptiontext) |
setof record | get token types defined by parser | ts_token_type(3722) | (1，asciiword，"Word， all ASCII") ... |
ts_stat(sqlquerytext，[weightstext，]OUTwordtext， OUTndocinteger， OUTnentryinteger) |
setof record | 获取tsvector列的统计数据 | ts_stat('SELECT vector from apod') | (foo，10，15) ... |
