9.13. 文本搜索函数和操作符 — PostgreSQL 9.4

支持中的版本：当前版本 (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

历史版本。 PostgreSQL 9.4 已结束支持。 2020-02-13. 请参阅当前版本手册.

9.13. 文本搜索函数和操作符
上一页	上一级	第 9 章函数和操作符	起始页	下一页

9.13. 文本搜索函数和操作符 #

表 9.37、表 9.38以及表 9.39总结了为全文检索提供的函数和操作符。PostgreSQL的文本检索功能的详细解释可参考第 12 章。

表 9.37. 文本搜索操作符

操作符	描述	示例	结果
`@@`	`tsvector` 是否匹配 `tsquery`？	`to_tsvector('fat cats ate rats') @@ to_tsquery('cat & rat')`	`t`
`@@@`	`@@` 的已弃用同义写法	`to_tsvector('fat cats ate rats') @@@ to_tsquery('cat & rat')`	`t`
`\|\|`	串接 `tsvector`	`'a:1 b:2'::tsvector \|\| 'c:1 d:2 b:3'::tsvector`	`'a':1 'b':2,5 'c':3 'd':4`
`&&`	将 `tsquery` 进行 AND 组合	`'fat \| rat'::tsquery && 'cat'::tsquery`	`( 'fat' \| 'rat' ) & 'cat'`
`\|\|`	将 `tsquery` 进行 OR 组合	`'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`

注意

tsquery 包含操作符只考虑两个查询中列出的词位，忽略组合操作符。

除了表中列出的操作符，tsvector 和 tsquery 类型还定义了普通的 B-树比较操作符（=、< 等）。这些操作符对文本检索用处不大，但可以用于其他用途，例如在这些类型的列上建立唯一索引。

表 9.38. 文本搜索函数

函数	返回类型	描述	示例	结果
`get_current_ts_config()`	`regconfig`	获取默认的文本搜索配置	`get_current_ts_config()`	`english`
`length(tsvector)`	`integer`	`tsvector` 中的词位数	`length('fat:2,4 cat:3 rat:5A'::tsvector)`	`3`
`numnode(tsquery)`	`integer`	`tsquery` 中的词位数与操作符数之和	`numnode('(fat & rat) \| cat'::tsquery)`	`5`
`plainto_tsquery([ config regconfig , ] query text)`	`tsquery`	生成 `tsquery`，忽略标点符号	`plainto_tsquery('english', 'The Fat Rats')`	`'fat' & 'rat'`
`querytree(query tsquery)`	`text`	获取 `tsquery` 中可索引的部分	`querytree('foo & ! bar'::tsquery)`	`'foo'`
`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([ config regconfig , ] query text)`	`tsquery`	正规化单词并转换为 `tsquery`	`to_tsquery('english', 'The & Fat & Rats')`	`'fat' & 'rat'`
`to_tsvector([ config regconfig , ] document text)`	`tsvector`	将文档文本转换为 `tsvector`	`to_tsvector('english', 'The Fat Rats')`	`'fat':2 'rat':3`
`ts_headline([ config regconfig, ] document text, query tsquery [, options text ])`	`text`	显示查询匹配内容	`ts_headline('x y z', 'z'::tsquery)`	`x y <b>z</b>`
`ts_rank([ weights float4[], ] vector tsvector, query tsquery [, normalization integer ])`	`float4`	计算文档相对于查询的排名分值	`ts_rank(textsearch, query)`	`0.818`
`ts_rank_cd([ weights float4[], ] vector tsvector, query tsquery [, normalization integer ])`	`float4`	使用覆盖密度计算文档相对于查询的排名分值	`ts_rank_cd('{0.1, 0.2, 0.4, 1.0}', textsearch, query)`	`2.01317`
`ts_rewrite(query tsquery, target tsquery, substitute tsquery)`	`tsquery`	将查询中的target替换为substitute	`ts_rewrite('a & b'::tsquery, 'a'::tsquery, 'foo\|bar'::tsquery)`	`'b' & ( 'foo' \| 'bar' )`
`ts_rewrite(query tsquery, select text)`	`tsquery`	使用 `SELECT` 命令提供的目标和替代内容进行替换	`SELECT ts_rewrite('a & b'::tsquery, 'SELECT t,s FROM aliases')`	`'b' & ( 'foo' \| 'bar' )`
`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)`

注意

所有接受一个可选的regconfig参数的文本检索函数在省略该参数时，会使用由default_text_search_config指定的配置。

表 9.39中的函数被单独列出，因为它们通常不被用于日常的文本检索操作。它们有助于开发和调试新的文本检索配置。

表 9.39. 文本搜索调试函数

函数	返回类型	描述	示例	结果
`ts_debug([ config regconfig, ] document text, OUT alias text, OUT description text, OUT token text, OUT dictionaries regdictionary[], OUT dictionary regdictionary, OUT lexemes text[])`	`setof record`	测试配置	`ts_debug('english', 'The Brightest supernovaes')`	`(asciiword,"Word, all ASCII",The,{english_stem},english_stem,{}) ...`
`ts_lexize(dict regdictionary, token text)`	`text[]`	测试词典	`ts_lexize('english_stem', 'stars')`	`{star}`
`ts_parse(parser_name text, document text, OUT tokid integer, OUT token text)`	`setof record`	测试解析器	`ts_parse('default', 'foo - bar')`	`(1,foo) ...`
`ts_parse(parser_oid oid, document text, OUT tokid integer, OUT token text)`	`setof record`	测试解析器	`ts_parse(3722, 'foo - bar')`	`(1,foo) ...`
`ts_token_type(parser_name text, OUT tokid integer, OUT alias text, OUT description text)`	`setof record`	获取解析器定义的词元类型	`ts_token_type('default')`	`(1,asciiword,"Word, all ASCII") ...`
`ts_token_type(parser_oid oid, OUT tokid integer, OUT alias text, OUT description text)`	`setof record`	获取解析器定义的词元类型	`ts_token_type(3722)`	`(1,asciiword,"Word, all ASCII") ...`
`ts_stat(sqlquery text, [ weights text, ] OUT word text, OUT ndoc integer, OUT nentry integer)`	`setof record`	获取 `tsvector` 列的统计信息	`ts_stat('SELECT vector from apod')`	`(foo,10,15) ...`

上一页	上一级	下一页
9.12. 网络地址函数和操作符	起始页	9.14. XML 函数

报告文档问题

阅读上游文档. 反馈更正前请先核对当前版本手册.