PostgreSQL 9.0.4 中文文档
Prev	Fast Backward	Chapter 9. 函数和操作符	Fast Forward	Next

9.13. 文本检索函数和操作符

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`
`\|\|`	连接`tsvector`s	`'a:1 b:2'::tsvector \|\| 'c:1 d:2 b:3'::tsvector`	`'a':1 'b':2，5 'c':3 'd':4`
`&&`	和`tsquery`s 一起来与	`'fat \| rat'::tsquery && 'cat'::tsquery`	`( 'fat' \| 'rat' ) & 'cat'`
`\|\|`	和`tsquery`s一起来或	`'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) ...`

Prev	Home	Next
网络地址函数和操作符	Up	XML函数