Skip to content

Commit 6943a94

Browse files
feodorfeodor
committed
Tsvector editing functions
Adds several tsvector editting function: convert tsvector to/from text array, set weight for given lexemes, delete lexeme(s), unnest, filter lexemes with given weights Author: Stas Kelvich with some editorization by me Reviewers: Tomas Vondram, Teodor Sigaev
1 parent 49635d7 commit 6943a94

File tree

7 files changed

+933
-18
lines changed

7 files changed

+933
-18
lines changed

‎doc/src/sgml/func.sgml

Lines changed: 89 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9211,13 +9211,26 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple
92119211
<indexterm>
92129212
<primary>setweight</primary>
92139213
</indexterm>
9214-
<literal><function>setweight(<type>tsvector</>, <type>"char"</>)</function></literal>
9214+
<literal><function>setweight(<replaceable class="PARAMETER">vector</replaceable> <type>tsvector</>, <replaceable class="PARAMETER">weight</replaceable> <type>"char"</>)</function></literal>
92159215
</entry>
92169216
<entry><type>tsvector</type></entry>
9217-
<entry>assign weight to each element of <type>tsvector</></entry>
9217+
<entry>assign <replaceable class="PARAMETER">weight</replaceable> to each element of <replaceable class="PARAMETER">vector</replaceable></entry>
92189218
<entry><literal>setweight('fat:2,4 cat:3 rat:5B'::tsvector, 'A')</literal></entry>
92199219
<entry><literal>'cat':3A 'fat':2A,4A 'rat':5A</literal></entry>
92209220
</row>
9221+
<row>
9222+
<entry>
9223+
<indexterm>
9224+
<primary>setweight</primary>
9225+
<secondary>setweight by filter</secondary>
9226+
</indexterm>
9227+
<literal><function>setweight(<replaceable class="PARAMETER">vector</replaceable> <type>tsvector</>, <replaceable class="PARAMETER">weight</replaceable> <type>"char"</>, <replaceable class="PARAMETER">lexemes</replaceable> <type>"text"[]</>)</function></literal>
9228+
</entry>
9229+
<entry><type>tsvector</type></entry>
9230+
<entry>assign <replaceable class="PARAMETER">weight</replaceable> to elements of <replaceable class="PARAMETER">vector</replaceable> that are listed in <replaceable class="PARAMETER">lexemes</replaceable> array</entry>
9231+
<entry><literal>setweight('fat:2,4 cat:3 rat:5B'::tsvector, 'A', '{cat,rat}')</literal></entry>
9232+
<entry><literal>'cat':3A 'fat':2,4 'rat':5A</literal></entry>
9233+
</row>
92219234
<row>
92229235
<entry>
92239236
<indexterm>
@@ -9230,6 +9243,80 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple
92309243
<entry><literal>strip('fat:2,4 cat:3 rat:5A'::tsvector)</literal></entry>
92319244
<entry><literal>'cat' 'fat' 'rat'</literal></entry>
92329245
</row>
9246+
<row>
9247+
<entry>
9248+
<indexterm>
9249+
<primary>delete</primary>
9250+
<secondary>delete lemexeme</secondary>
9251+
</indexterm>
9252+
<literal><function>delete(<replaceable class="PARAMETER">vector</replaceable> <type>tsvector</>, <replaceable class="PARAMETER">lexeme</replaceable> <type>text</>)</function></literal>
9253+
</entry>
9254+
<entry><type>tsvector</type></entry>
9255+
<entry>remove given <replaceable class="PARAMETER">lexeme</replaceable> from <replaceable class="PARAMETER">vector</replaceable></entry>
9256+
<entry><literal>delete('fat:2,4 cat:3 rat:5A'::tsvector, 'fat')</literal></entry>
9257+
<entry><literal>'cat':3 'rat':5A</literal></entry>
9258+
</row>
9259+
<row>
9260+
<entry>
9261+
<indexterm>
9262+
<primary>delete</primary>
9263+
<secondary>delete lemexemes array</secondary>
9264+
</indexterm>
9265+
<literal><function>delete(<replaceable class="PARAMETER">vector</replaceable> <type>tsvector</>, <replaceable class="PARAMETER">lexemes</replaceable> <type>text[]</>)</function></literal>
9266+
</entry>
9267+
<entry><type>tsvector</type></entry>
9268+
<entry>remove any occurrence of lexemes in <replaceable class="PARAMETER">lexemes</replaceable> array from <replaceable class="PARAMETER">vector</replaceable></entry>
9269+
<entry><literal>delete('fat:2,4 cat:3 rat:5A'::tsvector, ARRAY['fat','rat'])</literal></entry>
9270+
<entry><literal>'cat':3</literal></entry>
9271+
</row>
9272+
<row>
9273+
<entry>
9274+
<indexterm>
9275+
<primary>unnest</primary>
9276+
</indexterm>
9277+
<literal><function>unnest(<type>tsvector</>, OUT <replaceable class="PARAMETER">lexeme</> <type>text</>, OUT <replaceable class="PARAMETER">positions</> <type>smallint[]</>, OUT <replaceable class="PARAMETER">weights</> <type>text</>)</function></literal>
9278+
</entry>
9279+
<entry><type>setof record</type></entry>
9280+
<entry>expand a tsvector to a set of rows</entry>
9281+
<entry><literal>unnest('fat:2,4 cat:3 rat:5A'::tsvector)</literal></entry>
9282+
<entry><literal>(cat,{3},{D}) ...</literal></entry>
9283+
</row>
9284+
<row>
9285+
<entry>
9286+
<indexterm>
9287+
<primary>tsvector_to_array</primary>
9288+
</indexterm>
9289+
<literal><function>tsvector_to_array(<type>tsvector</>)</function></literal>
9290+
</entry>
9291+
<entry><type>text[]</type></entry>
9292+
<entry>convert <type>tsvector</> to array of lexemes</entry>
9293+
<entry><literal>tsvector_to_array('fat:2,4 cat:3 rat:5A'::tsvector)</literal></entry>
9294+
<entry><literal>{cat,fat,rat}</literal></entry>
9295+
</row>
9296+
<row>
9297+
<entry>
9298+
<indexterm>
9299+
<primary>array_to_tsvector</primary>
9300+
</indexterm>
9301+
<literal><function>array_to_tsvector(<type>text[]</>)</function></literal>
9302+
</entry>
9303+
<entry><type>tsvector</type></entry>
9304+
<entry>convert array of lexemes to <type>tsvector</type></entry>
9305+
<entry><literal>array_to_tsvector('{fat,cat,rat}'::text[])</literal></entry>
9306+
<entry><literal>'fat' 'cat' 'rat'</literal></entry>
9307+
</row>
9308+
<row>
9309+
<entry>
9310+
<indexterm>
9311+
<primary>filter</primary>
9312+
</indexterm>
9313+
<literal><function>filter(<replaceable class="PARAMETER">vector</replaceable> <type>tsvector</>, <replaceable class="PARAMETER">weights</replaceable> <type>"char"[]</>)</function></literal>
9314+
</entry>
9315+
<entry><type>tsvector</type></entry>
9316+
<entry>Select only elements with given <replaceable class="PARAMETER">weights</replaceable> from <replaceable class="PARAMETER">vector</replaceable></entry>
9317+
<entry><literal>filter('fat:2,4 cat:3b rat:5A'::tsvector, '{a,b}')</literal></entry>
9318+
<entry><literal>'cat':3B 'rat':5A</literal></entry>
9319+
</row>
92339320
<row>
92349321
<entry>
92359322
<indexterm>

‎doc/src/sgml/textsearch.sgml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1326,6 +1326,10 @@ FROM (SELECT id, body, q, ts_rank_cd(ti, q) AS rank
13261326

13271327
</variablelist>
13281328

1329+
<para>
1330+
Full list of <type>tsvector</>-related functions available in <xref linkend="textsearch-functions-table">.
1331+
</para>
1332+
13291333
</sect2>
13301334

13311335
<sect2 id="textsearch-manipulate-tsquery">

0 commit comments

Comments
 (0)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy