百科 / 函数百科 / 文本检索函数和操作符
FUNCTION文本检索函数和操作符
ts_debug
根据指定的或默认的文本检索配置从document中提取和正规化词元，并返回关于每个词元是如何处理的信息。
Extracts and normalizes tokens from the document according to the specified or default text search configuration, and returns information about how each token was processed.
文本检索函数和操作符 引入 9.0（基线） 现存至 20 devel 1 条签名 0 次签名变更
- 分组
- 文本检索函数和操作符
- 签名数
- 1 条
- 引入版本
- 9.0（基线）
- 状态
- 现存
- 签名变更
- 未变过
- 本版来源
- 本站译文
版本轨迹
相对 PostgreSQL 17 无变化。
签名
PostgreSQL 18 里 ts_debug 的 1 条签名，按上游手册顺序排列。参数名用斜体，类型用弱化色， 之后是返回类型。说明取自本站手册译文：标「沿用」的借用了另一版的译文，标「EN」的本站暂无译文、按英文原文显示。
-
ts_debug( [configregconfig, ]documenttext) →setof record(aliastext,descriptiontext,tokentext,dictionariesregdictionary[],dictionaryregdictionary,lexemestext[])根据指定的或默认的文本检索配置从document中提取和正规化词元，并返回关于每个词元是如何处理的信息。详情参见第 12.8.1 节。ts_debug('english', 'The Brightest supernovaes')(asciiword,"Word, all ASCII",The,{english_stem},english_stem,{}) ...
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的签名。
-
PostgreSQL 13 ← 12 手册重排
这一跳手册重排了函数表的写法，签名文本整体改写，只记函数的增删，不逐条比较签名。
签名矩阵
每条签名在给出了签名的 18 个版本里的存在情况；方格指向该版的签名。只在正文里提到此函数、没有给出签名的版本不列进来，上面的版本轨迹里仍然有它们。签名文本在 PostgreSQL 13 前后写法不同，跨越那一跳的同一条签名会显示成两行。
存在 不存在
| 签名 | 9.0 | 9.1 | 9.2 | 9.3 | 9.4 | 9.5 | 9.6 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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 ( [ config regconfig, ] document text ) → setof record ( alias text, description text, token text, dictionaries regdictionary[], dictionary regdictionary, lexemes text[] ) |
不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 不存在 | 存在 | 存在 | 存在 | 存在 | 存在 | 存在 | 存在 | 存在 |
同组函数
| 函数 | 签名 | 主签名 | 版本变动 | 最近变更 |
|---|---|---|---|---|
array_to_tsvector |
1 | array_to_tsvector ( text[] ) → tsvector |
— | |
| 将文本字符串数组转换为tsvector。 | 现存 | |||
get_current_ts_config基线 |
1 | get_current_ts_config ( ) → regconfig |
— | |
| 返回当前默认文本检索配置的 OID（由default_text_search_config设置）。 | 现存 | |||
json_to_tsvector |
1 | json_to_tsvector ( [config regconfig, ] document json, filter jsonb ) → tsvector |
— | |
| 选择filter请求的JSON文档中的每个项，并将每个项转换为tsvector，根据指定的或默认配置对单词进行正规化。 | 现存 | |||
jsonb_to_tsvector |
1 | jsonb_to_tsvector ( [config regconfig, ] document jsonb, filter jsonb ) → tsvector |
— | |
| 选择filter请求的JSON文档中的每个项，并将每个项转换为tsvector，根据指定的或默认配置对单词进行正规化。 | 现存 | |||
numnode基线 |
1 | numnode ( tsquery ) → integer |
— | |
| 返回tsquery中词位和操作符的数目。 | 现存 | |||
phraseto_tsquery |
1 | phraseto_tsquery ( [config regconfig, ] query text ) → tsquery |
— | |
| 将文本转换为tsquery，根据指定的或默认配置对单词进行正规化。 | 现存 | |||
plainto_tsquery基线 |
1 | plainto_tsquery ( [config regconfig, ] query text ) → tsquery |
— | |
| 将文本转换为tsquery，根据指定的或默认配置对单词进行正规化。 | 现存 | |||
querytree基线 |
1 | querytree ( tsquery ) → text |
— | |
| 生成tsquery中可索引部分的表示。 | 现存 | |||
setweight基线 |
2 | setweight ( vector tsvector, weight "char" ) → tsvector |
9.61 次 | |
| 将指定的weight赋给vector的每个元素。 | 现存 | |||
strip基线 |
1 | strip ( tsvector ) → tsvector |
— | |
| 从tsvector中移除位置和权重。 | 现存 | |||
to_tsquery基线 |
1 | to_tsquery ( [config regconfig, ] query text ) → tsquery |
— | |
| 将文本转换为tsquery，根据指定的或默认配置对单词进行正规化。 | 现存 | |||
to_tsvector基线 |
3 | to_tsvector ( [config regconfig, ] document text ) → tsvector |
101 次 | |
| 将文本转换为tsvector，根据指定的或默认配置对单词进行正规化。 | 现存 | |||
ts_debug基线 |
1 | ts_debug ( [config regconfig, ] document text ) → setof record ( alias text, description text, token text, dictionaries regdictionary[], dictionary regdictionary, lexemes text[] ) |
— | |
| 根据指定的或默认的文本检索配置从document中提取和正规化词元，并返回关于每个词元是如何处理的信息。 | 现存 | |||
ts_delete |
2 | ts_delete ( vector tsvector, lexeme text ) → tsvector |
— | |
| 从vector中删除给定的lexeme的所有出现。 | 现存 | |||
ts_filter |
1 | ts_filter ( vector tsvector, weights "char"[] ) → tsvector |
— | |
| 只从vector中选择具有给定weights的元素。 | 现存 | |||
ts_headline基线 |
3 | ts_headline ( [config regconfig, ] document text, query tsquery [, options text] ) → text |
101 次 | |
| 以缩略形式显示query在document中的匹配项；后者必须是原始文本，不能是tsvector。 | 现存 | |||
ts_lexize基线 |
1 | ts_lexize ( dict regdictionary, token text ) → text[] |
— | |
| 如果词典识别输入词元，则返回由替换词位组成的数组；如果词典识别该词元，但它是停用词，则返回空数组；如果词典无法识别该词元，则返回NULL。 | 现存 | |||
ts_parse基线 |
2 | ts_parse ( parser_name text, document text ) → setof record ( tokid integer, token text ) |
— | |
| 使用指定名称的解析器从document中提取词元。 | 现存 | |||
ts_rank基线 |
1 | ts_rank ( [weights real[], ] vector tsvector, query tsquery [, normalization integer] ) → real |
— | |
| 计算一个分数，显示vector与query的匹配程度。 | 现存 | |||
ts_rank_cd基线 |
1 | ts_rank_cd ( [weights real[], ] vector tsvector, query tsquery [, normalization integer] ) → real |
— | |
| 使用覆盖密度算法计算一个分数，显示vector与query的匹配程度。 | 现存 | |||
ts_rewrite基线 |
2 | ts_rewrite ( query tsquery, target tsquery, substitute tsquery ) → tsquery |
— | |
| 在query中使用 substitute替换出现的target。 | 现存 | |||
ts_stat基线 |
1 | ts_stat ( sqlquery text [, weights text] ) → setof record ( word text, ndoc integer, nentry integer ) |
— | |
| 执行sqlquery，该查询必须返回单个tsvector列，并返回数据中每个不同词位的统计信息。 | 现存 | |||
ts_token_type基线 |
2 | ts_token_type ( parser_name text ) → setof record ( tokid integer, alias text, description text ) |
— | |
| 返回一个表，该表描述指定名称的解析器可以识别的每种类型的词元。 | 现存 | |||
tsquery_phrase |
2 | tsquery_phrase ( query1 tsquery, query2 tsquery ) → tsquery |
— | |
| 构造一个短语查询，在连续的词位上搜索query1和query2的匹配项（与<->操作符相同）。 | 现存 | |||
tsvector_to_array |
1 | tsvector_to_array ( tsvector ) → text[] |
— | |
| 将tsvector转换为词位的数组。 | 现存 | |||
unnest基线 |
4 | unnest ( tsvector ) → setof record ( lexeme text, positions smallint[], weights text ) |
143 次 | |
| 将tsvector展开为一组行，每行对应一个词位。 | 现存 | |||
websearch_to_tsquery |
1 | websearch_to_tsquery ( [config regconfig, ] query text ) → tsquery |
— | |
| 将文本转换为tsquery，根据指定的或默认配置对单词进行正规化。 | 现存 | |||