doc-exports/docs/dws/dev/dws_06_0319.html
Lu, Huayi e6fa411af0 DWS DEV 830.201 version
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2024-05-16 07:24:04 +00:00

127 lines
13 KiB
HTML

<a name="EN-US_TOPIC_0000001444647932"></a><a name="EN-US_TOPIC_0000001444647932"></a>
<h1 class="topictitle1">Text Search Operators</h1>
<div id="body0000001444647932"><div class="section" id="EN-US_TOPIC_0000001444647932__section10328532098"><h4 class="sectiontitle">@@</h4><p id="EN-US_TOPIC_0000001444647932__p102885313918">Description: Specifies whether the <strong id="EN-US_TOPIC_0000001444647932__b175107411293918">tsvector</strong>-typed words match the <strong id="EN-US_TOPIC_0000001444647932__b12644635993918">tsquery</strong>-typed words.</p>
<p id="EN-US_TOPIC_0000001444647932__p1628953597">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001444647932__screen14281653894"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">to_tsvector</span><span class="p">(</span><span class="s1">'fat cats ate rats'</span><span class="p">)</span><span class="w"> </span><span class="o">@@</span><span class="w"> </span><span class="n">to_tsquery</span><span class="p">(</span><span class="s1">'cat &amp; rat'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001444647932__section0286745108"><h4 class="sectiontitle">@@@</h4><p id="EN-US_TOPIC_0000001444647932__p102825411106">Description: Synonym for @@</p>
<p id="EN-US_TOPIC_0000001444647932__p10283745104">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001444647932__screen1428414461010"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">to_tsvector</span><span class="p">(</span><span class="s1">'fat cats ate rats'</span><span class="p">)</span><span class="w"> </span><span class="o">@@@</span><span class="w"> </span><span class="n">to_tsquery</span><span class="p">(</span><span class="s1">'cat &amp; rat'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001444647932__section11623121419103"><h4 class="sectiontitle">&amp;&amp;</h4><p id="EN-US_TOPIC_0000001444647932__p962161416109">Description: Performs the AND operation on two <strong id="EN-US_TOPIC_0000001444647932__b167251839193918">tsquery</strong>-typed words.</p>
<p id="EN-US_TOPIC_0000001444647932__p106214149100">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001444647932__screen9622014151018"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="s1">'fat | rat'</span><span class="p">::</span><span class="n">tsquery</span><span class="w"> </span><span class="o">&amp;&amp;</span><span class="w"> </span><span class="s1">'cat'</span><span class="p">::</span><span class="n">tsquery</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------------</span>
<span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="s1">'fat'</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="s1">'rat'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="o">&amp;</span><span class="w"> </span><span class="s1">'cat'</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001444647932__section18891161452014"><h4 class="sectiontitle">||</h4><p id="EN-US_TOPIC_0000001444647932__p988971442020">Description: Performs the OR operation on two <strong id="EN-US_TOPIC_0000001444647932__b89739068193918">tsquery</strong>-typed words.</p>
<p id="EN-US_TOPIC_0000001444647932__p28895141207">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001444647932__screen48901414182017"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="s1">'fat | rat'</span><span class="p">::</span><span class="n">tsquery</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="s1">'cat'</span><span class="p">::</span><span class="n">tsquery</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------------</span>
<span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="s1">'fat'</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="s1">'rat'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="s1">'cat'</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="s1">'a:1 b:2'</span><span class="p">::</span><span class="n">tsvector</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="s1">'c:1 d:2 b:3'</span><span class="p">::</span><span class="n">tsvector</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------------------</span>
<span class="w"> </span><span class="s1">'a'</span><span class="p">:</span><span class="mi">1</span><span class="w"> </span><span class="s1">'b'</span><span class="p">:</span><span class="mi">2</span><span class="p">,</span><span class="mi">5</span><span class="w"> </span><span class="s1">'c'</span><span class="p">:</span><span class="mi">3</span><span class="w"> </span><span class="s1">'d'</span><span class="p">:</span><span class="mi">4</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001444647932__section12305318152019"><h4 class="sectiontitle">!!</h4><p id="EN-US_TOPIC_0000001444647932__p163035180208">Description: <strong id="EN-US_TOPIC_0000001444647932__b168311090193918">NOT</strong> a <strong id="EN-US_TOPIC_0000001444647932__b13585106693918">tsquery</strong></p>
<p id="EN-US_TOPIC_0000001444647932__p13303418142012">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001444647932__screen193041118172020"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="o">!!</span><span class="w"> </span><span class="s1">'cat'</span><span class="p">::</span><span class="n">tsquery</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="o">!</span><span class="s1">'cat'</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001444647932__section395262242013"><h4 class="sectiontitle">@&gt;</h4><p id="EN-US_TOPIC_0000001444647932__p79501022152011">Description: Specifies whether a <strong id="EN-US_TOPIC_0000001444647932__b178468248993918">tsquery</strong>-typed word contains another <strong id="EN-US_TOPIC_0000001444647932__b165483400293918">tsquery</strong>-typed word.</p>
<p id="EN-US_TOPIC_0000001444647932__p13950722152019">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001444647932__screen1295252202011"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="s1">'cat'</span><span class="p">::</span><span class="n">tsquery</span><span class="w"> </span><span class="o">@&gt;</span><span class="w"> </span><span class="s1">'cat &amp; rat'</span><span class="p">::</span><span class="n">tsquery</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001444647932__section1665102652018"><h4 class="sectiontitle">&lt;@</h4><p id="EN-US_TOPIC_0000001444647932__p564142619207">Description: Specifies whether a <strong id="EN-US_TOPIC_0000001444647932__b48826129993918">tsquery</strong>-typed word is contained in another <strong id="EN-US_TOPIC_0000001444647932__b124040379293918">tsquery</strong>-typed word.</p>
<p id="EN-US_TOPIC_0000001444647932__p8641126122019">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001444647932__screen06542617207"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="s1">'cat'</span><span class="p">::</span><span class="n">tsquery</span><span class="w"> </span><span class="o">&lt;@</span><span class="w"> </span><span class="s1">'cat &amp; rat'</span><span class="p">::</span><span class="n">tsquery</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001444647932__p665926132015">In addition to the preceding operators, the ordinary B-tree comparison operators (including = and &lt;) are defined for types <strong id="EN-US_TOPIC_0000001444647932__b96921499693918">tsvector</strong> and <strong id="EN-US_TOPIC_0000001444647932__b145820415193918">tsquery</strong>.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0039.html">Text Search Functions and Operators</a></div>
</div>
</div>