| Ð”Ð¾ÐºÑƒÐ¼ÐµÐ½Ñ‚Ð°Ñ†Ð¸Ñ Ð¿Ð¾ PostgreSQL 9.4.1 | |||
|---|---|---|---|
| Пред. | Уровень выше | Глава 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 |
| && | логичеÑкое И (AND) двух запроÑов tsquery | 'fat | rat'::tsquery && 'cat'::tsquery | ( 'fat' | 'rat' ) & 'cat' |
| || | логичеÑкое ИЛИ (OR) двух запроÑов tsquery | '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([ÐºÐ¾Ð½Ñ„Ð¸Ð³ÑƒÑ€Ð°Ñ†Ð¸Ñ regconfig ,] Ð·Ð°Ð¿Ñ€Ð¾Ñ text) | tsquery | выдаёт значение tsquery, Ð¸Ð³Ð½Ð¾Ñ€Ð¸Ñ€ÑƒÑ Ð¿ÑƒÐ½ÐºÑ‚ÑƒÐ°Ñ†Ð¸ÑŽ | plainto_tsquery('english', 'The Fat Rats') | 'fat' & 'rat' |
querytree(Ð·Ð°Ð¿Ñ€Ð¾Ñ 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([ÐºÐ¾Ð½Ñ„Ð¸Ð³ÑƒÑ€Ð°Ñ†Ð¸Ñ regconfig ,] Ð·Ð°Ð¿Ñ€Ð¾Ñ text) | tsquery | нормализует Ñлова и переводит их в tsquery | to_tsquery('english', 'The & Fat & Rats') | 'fat' & 'rat' |
to_tsvector([ÐºÐ¾Ð½Ñ„Ð¸Ð³ÑƒÑ€Ð°Ñ†Ð¸Ñ regconfig ,] документ text) | tsvector | Ñокращает текÑÑ‚ документа до Ð·Ð½Ð°Ñ‡ÐµÐ½Ð¸Ñ tsvector | to_tsvector('english', 'The Fat Rats') | 'fat':2 'rat':3 |
ts_headline([ÐºÐ¾Ð½Ñ„Ð¸Ð³ÑƒÑ€Ð°Ñ†Ð¸Ñ regconfig,] документ text, Ð·Ð°Ð¿Ñ€Ð¾Ñ tsquery [, параметры text]) | text | выводит фрагмент, ÑоответÑтвующий запроÑу | ts_headline('x y z', 'z'::tsquery) | x y <b>z</b> |
ts_rank([веÑа float4[],] вектор tsvector, Ð·Ð°Ð¿Ñ€Ð¾Ñ tsquery [, Ð½Ð¾Ñ€Ð¼Ð°Ð»Ð¸Ð·Ð°Ñ†Ð¸Ñ integer]) | float4 | вычиÑлÑет ранг документа по отношению к запроÑу | ts_rank(textsearch, query) | 0.818 |
ts_rank_cd([веÑа float4[],] вектор tsvector, Ð·Ð°Ð¿Ñ€Ð¾Ñ tsquery [, Ð½Ð¾Ñ€Ð¼Ð°Ð»Ð¸Ð·Ð°Ñ†Ð¸Ñ integer]) | float4 | вычиÑлÑет ранг документа по отношению к запроÑу, иÑÐ¿Ð¾Ð»ÑŒÐ·ÑƒÑ Ð¿Ð»Ð¾Ñ‚Ð½Ð¾ÑÑ‚ÑŒ Ð¿Ð¾ÐºÑ€Ñ‹Ñ‚Ð¸Ñ (CDR) | ts_rank_cd('{0.1, 0.2, 0.4, 1.0}', textsearch, query) | 2.01317 |
ts_rewrite(Ð·Ð°Ð¿Ñ€Ð¾Ñ tsquery, цель tsquery, замена tsquery) | tsquery | заменÑет целевой Ð¿Ð¾Ð´Ð·Ð°Ð¿Ñ€Ð¾Ñ Ð¿Ð¾Ð´Ñтановкой | ts_rewrite('a & b'::tsquery, 'a'::tsquery, 'foo|bar'::tsquery) | 'b' & ( 'foo' | 'bar' ) |
ts_rewrite(Ð·Ð°Ð¿Ñ€Ð¾Ñ tsquery, выборка 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([ÐºÐ¾Ð½Ñ„Ð¸Ð³ÑƒÑ€Ð°Ñ†Ð¸Ñ regconfig,] документ text, OUT пÑевдоним text, OUT опиÑание text, OUT фрагмент text, OUT Ñловари regdictionary[], OUT Ñловарь regdictionary, OUT лекÑемы text[]) | setof record | проверÑет конфигурацию | ts_debug('english', 'The Brightest supernovaes') | (asciiword,"Word, all ASCII",The,{​english_stem​},​english_stem,{}) ... |
ts_lexize(Ñловарь regdictionary, фрагмент text) | text[] | проверÑет Ñловарь | ts_lexize('english_stem', 'stars') | {star} |
ts_parse(имÑ_анализатора text, документ text, OUT код_фрагмента integer, OUT фрагмент text) | setof record | проверÑет анализатор | ts_parse('default', 'foo - bar') | (1,foo) ... |
ts_parse(oid_анализатора oid, документ text, OUT код_фрагмента integer, OUT фрагмент text) | setof record | проверÑет анализатор | ts_parse(3722, 'foo - bar') | (1,foo) ... |
ts_token_type(имÑ_анализатора text, OUT код_фрагмента integer, OUT пÑевдоним text, OUT опиÑание text) | setof record | получает типы фрагментов, определённые анализатором | ts_token_type('default') | (1,asciiword,"Word, all ASCII") ... |
ts_token_type(oid_анализатора oid, OUT код_фрагмента integer, OUT пÑевдоним text, OUT опиÑание text) | setof record | получает типы фрагментов, определённые анализатором | ts_token_type(3722) | (1,asciiword,"Word, all ASCII") ... |
ts_stat(sql_Ð·Ð°Ð¿Ñ€Ð¾Ñ text, [веÑа text,] OUT Ñлово text, OUT чиÑло_док integer, OUT чиÑло_вхожд integer) | setof record | получает ÑтатиÑтику колонки tsvector | ts_stat('SELECT vector from apod') | (foo,10,15) ... |
| Пред. | Ðачало | След. |
| Функции и операторы Ð´Ð»Ñ Ñ€Ð°Ð±Ð¾Ñ‚Ñ‹ Ñ Ñетевыми адреÑами | Уровень выше | XML-функции |