forked from docs/doc-exports
Su, Xiaomeng
be9eabe464
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Co-authored-by: Su, Xiaomeng <suxiaomeng1@huawei.com> Co-committed-by: Su, Xiaomeng <suxiaomeng1@huawei.com>
212 lines
28 KiB
HTML
212 lines
28 KiB
HTML
<a name="dli_08_15086"></a><a name="dli_08_15086"></a>
|
|
|
|
<h1 class="topictitle1">Comparison Functions</h1>
|
|
<div id="body0000001262815702">
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_15086__dli_08_0191_t16c03594f4e14f9b890b3229307ab86f" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Comparison functions</caption><thead align="left"><tr id="dli_08_15086__dli_08_0191_rc07dc50d385e4a0287267186b5b63e57"><th align="left" class="cellrowborder" valign="top" width="24.759999999999998%" id="mcps1.3.1.2.4.1.1"><p id="dli_08_15086__dli_08_0191_a0ee4290fcd314b09a5a6d66b0a236b23"><strong id="dli_08_15086__b3195217114216">SQL Function</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.08%" id="mcps1.3.1.2.4.1.2"><p id="dli_08_15086__dli_08_0191_ad9e7fc1c9e204c1cabf0f10c3e7cf55b"><strong id="dli_08_15086__b6852719104211">Return Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="62.160000000000004%" id="mcps1.3.1.2.4.1.3"><p id="dli_08_15086__dli_08_0191_a18ab0502ac5542eca5cf2968f2c7d800"><strong id="dli_08_15086__dli_08_0191_afa0f9e3f95de477f98956aa08e2db5d2">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_15086__dli_08_0191_rd72d22e709cc4d52a1092a3feaf6de3d"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__dli_08_0191_acb21d1d3e69945569716443cff6dff06">value1 = value2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_en-us_topic_0060575883_p557514232513">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p176272534123">Returns <strong id="dli_08_15086__b187854341727">TRUE</strong> if <strong id="dli_08_15086__b179966371821">value1</strong> equals <strong id="dli_08_15086__b542511393212">value2</strong>;</p>
|
|
<p id="dli_08_15086__dli_08_0191_aad9ebcc4c9db4bbb86e24b96be492c70">returns <strong id="dli_08_15086__b163941464817">UNKNOWN</strong> if either <strong id="dli_08_15086__b33951561819">value1</strong> or <strong id="dli_08_15086__b53951761982">value2</strong> is <strong id="dli_08_15086__b15395665810">NULL</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_rff79c33cc7a84d66a9915fed77e5ad70"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__p87419422379">value1 <> value2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_en-us_topic_0060575883_p15751239511">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p7782195216128">Returns <strong id="dli_08_15086__b71211424731">TRUE</strong> if <strong id="dli_08_15086__b512219241433">value1</strong> does not equal <strong id="dli_08_15086__b412392413310">value2</strong>;</p>
|
|
<p id="dli_08_15086__p391611471371">returns <strong id="dli_08_15086__b2048244617310">UNKNOWN</strong> if either <strong id="dli_08_15086__b10483104615318">value1</strong> or <strong id="dli_08_15086__b1148474615310">value2</strong> is <strong id="dli_08_15086__b1948519468315">NULL</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__row148231285383"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__p16824586388">value1 > value2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__p1482498113819">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p1390716513121">Returns <strong id="dli_08_15086__b2072731514611">TRUE</strong> if <strong id="dli_08_15086__b672712151615">value1</strong> is greater than <strong id="dli_08_15086__b872810151566">value2</strong>;</p>
|
|
<p id="dli_08_15086__p13824178103812">returns <strong id="dli_08_15086__b14246839960">UNKNOWN</strong> if either <strong id="dli_08_15086__b924719392619">value1</strong> or <strong id="dli_08_15086__b1224713911618">value2</strong> is <strong id="dli_08_15086__b17247173917611">NULL</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__row19950101018388"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__p8950191011381">value1 >= value2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__p19950810123811">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p87810515121">Returns <strong id="dli_08_15086__b626215459618">TRUE</strong> if <strong id="dli_08_15086__b7263845267">value1</strong> is greater than or equal to <strong id="dli_08_15086__b18263114514618">value2</strong>;</p>
|
|
<p id="dli_08_15086__p1795091017384">returns <strong id="dli_08_15086__b1921961274">UNKNOWN</strong> if either <strong id="dli_08_15086__b15921565717">value1</strong> or <strong id="dli_08_15086__b149225617718">value2</strong> is <strong id="dli_08_15086__b14922156272">NULL</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_r3f096306f8b94a3b9bd265890082339f"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__p10880113903918">value1 < value2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_a45e360804471497aa383f120f6f60184">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p228164931216">Returns <strong id="dli_08_15086__b44931690717">TRUE</strong> if <strong id="dli_08_15086__b349339779">value1</strong> is less than <strong id="dli_08_15086__b1749415919710">value2</strong>;</p>
|
|
<p id="dli_08_15086__dli_08_0191_en-us_topic_0060575883_p857662318515">returns <strong id="dli_08_15086__b2161731972">UNKNOWN</strong> if either <strong id="dli_08_15086__b116213118717">value1</strong> or <strong id="dli_08_15086__b4162143119711">value2</strong> is <strong id="dli_08_15086__b416216311775">NULL</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_r57da6dfcb9f946bbb34907bb0b59a1cc"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__p6414184843914">value1 <= value2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_en-us_topic_0060575883_p357611238516">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p52961348171211">Returns <strong id="dli_08_15086__b13131536979">TRUE</strong> if <strong id="dli_08_15086__b51423613710">value1</strong> is less than or equal to <strong id="dli_08_15086__b14140365716">value2</strong>;</p>
|
|
<p id="dli_08_15086__dli_08_0191_en-us_topic_0060575883_p05764231511">returns <strong id="dli_08_15086__b724311401098">UNKNOWN</strong> if either <strong id="dli_08_15086__b824310406911">value1</strong> or <strong id="dli_08_15086__b172441440791">value2</strong> is <strong id="dli_08_15086__b20244540595">NULL</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_r84f216f5c94a4356872678c7414b0f43"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__dli_08_0191_a6b3d2cfe3b0e400086d2dfb57dab9111">value IS NULL</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_a33567d71c3fb42caa4433a83e2587a51">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__dli_08_0191_a484e575324da43f0958d5e45c6e3f4d0">Returns <strong id="dli_08_15086__b2626104215492">TRUE</strong> if <strong id="dli_08_15086__b2750056154918">value</strong> is <strong id="dli_08_15086__b1262784244910">NULL</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_rf1bc8789e59349c88bd2f9271ab4afda"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__dli_08_0191_a770c15b9ae5d47f7be5887a984c1985d">value IS NOT NULL</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_a494b498d368b44a3acb2bb2b5f18d2a9">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__dli_08_0191_a82e6b54364be4dee8128683ea6a14a49">Returns <strong id="dli_08_15086__b966431155012">TRUE</strong> if <strong id="dli_08_15086__b73659516509">value</strong> is not <strong id="dli_08_15086__b56659114509">NULL</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_r691feb86a99d4f8ca8717a4a8e4b97db"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__dli_08_0191_en-us_topic_0060575883_p219991119220">value1 IS DISTINCT FROM value2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_en-us_topic_0060575883_p61981111226">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p1296215361119">Returns <strong id="dli_08_15086__b184221885216">TRUE</strong> if <strong id="dli_08_15086__b18796210525">value1</strong> and <strong id="dli_08_15086__b1874152419522">value2</strong> have different data types or values;</p>
|
|
<p id="dli_08_15086__p16422173812119">returns <strong id="dli_08_15086__b85721050135210">FALSE</strong> if they have the same data types and values.</p>
|
|
<p id="dli_08_15086__p77861817101117">Treats <strong id="dli_08_15086__b2631442698">NULL</strong> as the same.</p>
|
|
<p id="dli_08_15086__p586923611219">For example:</p>
|
|
<p id="dli_08_15086__p3442204151214"><strong id="dli_08_15086__b860890151012">1 IS DISTINCT FROM NULL</strong> returns <strong id="dli_08_15086__b1631911216107">TRUE</strong>;</p>
|
|
<p id="dli_08_15086__dli_08_0191_aeb7fa934a1ba4518980c5b39d871ed01"><strong id="dli_08_15086__b792511913107">NULL IS DISTINCT FROM NULL</strong> returns <strong id="dli_08_15086__b19718101117100">FALSE</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_r2d4f9d8d31dc4b689227cfeb375e13f7"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__dli_08_0191_a17177705f90a41f0ac6cd398c92610cb">value1 IS NOT DISTINCT FROM value2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_en-us_topic_0060575883_p419621142220">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p6791424171120">Returns <strong id="dli_08_15086__b1381284415535">TRUE</strong> if they have the same data types and values;</p>
|
|
<p id="dli_08_15086__p1456692601113">returns <strong id="dli_08_15086__b5836145712533">FALSE</strong> if <strong id="dli_08_15086__b584025735317">value1</strong> and <strong id="dli_08_15086__b12844457145318">value2</strong> have different data types or values.</p>
|
|
<p id="dli_08_15086__p194156291113">Treats <strong id="dli_08_15086__b11921513131015">NULL</strong> as the same.</p>
|
|
<p id="dli_08_15086__p1777263341212">For example:</p>
|
|
<p id="dli_08_15086__p1350554416127"><strong id="dli_08_15086__b283422316106">1 IS NOT DISTINCT FROM NULL</strong> returns <strong id="dli_08_15086__b17642152591018">FALSE</strong>;</p>
|
|
<p id="dli_08_15086__dli_08_0191_en-us_topic_0060575883_p619510114220"><strong id="dli_08_15086__b1089864316106">NULL IS NOT DISTINCT FROM NULL</strong> returns <strong id="dli_08_15086__b8469114914102">TRUE</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_raa74c26b03a84364a1f63e6628211c9e"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__dli_08_0191_a457536264ed442de8a2f5e19665ebb24">value1 BETWEEN [ ASYMMETRIC | SYMMETRIC ] value2 AND value3</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_a051e8395754c4c67b801de77d4f3dd38">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p2077754751114">Returns <strong id="dli_08_15086__b5311635125610">TRUE</strong> if <strong id="dli_08_15086__b6839173855618">value1</strong> is greater than or equal to <strong id="dli_08_15086__b1663294213569">value2</strong> and less than or equal to <strong id="dli_08_15086__b817564845619">value3</strong>, using the default or <strong id="dli_08_15086__b1092814095714">ASYMMETRIC</strong> keyword.</p>
|
|
<p id="dli_08_15086__p671685121111">If <strong id="dli_08_15086__b4171173814306">SYMMETRIC</strong> is used, returns <strong id="dli_08_15086__b1517263811306">TRUE</strong> if <strong id="dli_08_15086__b1217316384305">value1</strong> is inclusively between <strong id="dli_08_15086__b141743382303">value2</strong> and <strong id="dli_08_15086__b1917518384304">value3</strong>.</p>
|
|
<p id="dli_08_15086__p291119523111">Returns <strong id="dli_08_15086__b47514591107">FALSE</strong> or <strong id="dli_08_15086__b4751559101016">UNKNOWN</strong> if <strong id="dli_08_15086__b17612594106">value2</strong> or <strong id="dli_08_15086__b4761459201020">value3</strong> is <strong id="dli_08_15086__b15769597107">NULL</strong>.</p>
|
|
<p id="dli_08_15086__p102871881213">For example:</p>
|
|
<ul id="dli_08_15086__ul9394611181217"><li id="dli_08_15086__li13394191110128"><strong id="dli_08_15086__b6825131917113">12 BETWEEN 15 AND 12</strong> returns <strong id="dli_08_15086__b268617216113">FALSE</strong>;</li><li id="dli_08_15086__li139411141219"><strong id="dli_08_15086__b389403011116">12 BETWEEN SYMMETRIC 15 AND 12</strong> returns <strong id="dli_08_15086__b15568163221113">TRUE</strong>;</li><li id="dli_08_15086__li1039441171219"><strong id="dli_08_15086__b92546415114">12 BETWEEN 10 AND NULL</strong> returns <strong id="dli_08_15086__b19850154361115">UNKNOWN</strong>;</li><li id="dli_08_15086__li039471161219"><strong id="dli_08_15086__b065813541118">12 BETWEEN NULL AND 10</strong> returns <strong id="dli_08_15086__b1025815681110">FALSE</strong>;</li><li id="dli_08_15086__li1439461112127"><strong id="dli_08_15086__b13341981213">12 BETWEEN SYMMETRIC NULL AND 12</strong> returns <strong id="dli_08_15086__b1226711116128">UNKNOWN</strong>.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_rfc3f6e47b85d42c997c6935a33d9d3aa"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__p6941043194311">value1 NOT BETWEEN [ ASYMMETRIC | SYMMETRIC ] value2 AND value3</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_ace0010a88eb745b289f405829d015105">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p136402588122">Returns <strong id="dli_08_15086__b161022038275">TRUE</strong> if <strong id="dli_08_15086__b78581552716">value1</strong> is less than <strong id="dli_08_15086__b1180610813272">value2</strong> or greater than <strong id="dli_08_15086__b18311411162716">value3</strong>, using the default or <strong id="dli_08_15086__b9442161719278">ASYMMETRIC</strong> keyword.</p>
|
|
<p id="dli_08_15086__p1490413041311">If <strong id="dli_08_15086__b586934353015">SYMMETRIC</strong> is used, returns <strong id="dli_08_15086__b14870194383016">TRUE</strong> if <strong id="dli_08_15086__b17871204313303">value1</strong> is not between <strong id="dli_08_15086__b08721843143011">value2</strong> and <strong id="dli_08_15086__b1387204312300">value3</strong>.</p>
|
|
<p id="dli_08_15086__p1324414971310">Returns <strong id="dli_08_15086__b689718168128">TRUE</strong> or <strong id="dli_08_15086__b15898816191212">UNKNOWN</strong> if <strong id="dli_08_15086__b889971619128">value2</strong> or <strong id="dli_08_15086__b789991661214">value3</strong> is <strong id="dli_08_15086__b1889911612128">NULL</strong>.</p>
|
|
<p id="dli_08_15086__p336919236134">For example:</p>
|
|
<ul id="dli_08_15086__ul1176192611132"><li id="dli_08_15086__li37642681312"><strong id="dli_08_15086__b117259480127">12 NOT BETWEEN 15 AND 12</strong> returns <strong id="dli_08_15086__b2644125081218">TRUE</strong>;</li><li id="dli_08_15086__li476132641314"><strong id="dli_08_15086__b135951659161210">12 NOT BETWEEN SYMMETRIC 15 AND 12</strong> returns <strong id="dli_08_15086__b458719191314">FALSE</strong>;</li><li id="dli_08_15086__li67702621314"><strong id="dli_08_15086__b15863171011319">12 NOT BETWEEN NULL AND 15</strong> returns <strong id="dli_08_15086__b196802012161311">UNKNOWN</strong>;</li><li id="dli_08_15086__li1377162613137"><strong id="dli_08_15086__b2782224121311">12 NOT BETWEEN 15 AND NULL</strong> returns <strong id="dli_08_15086__b150022615136">TRUE</strong>;</li><li id="dli_08_15086__li20770267132"><strong id="dli_08_15086__b757523671312">12 NOT BETWEEN SYMMETRIC 12 AND NULL</strong> returns <strong id="dli_08_15086__b1339416381135">UNKNOWN</strong>.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_r33c7340c758d40f3a18f2744e687da40"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__dli_08_0191_a451adcbe23f9410aa345221a4411acf8">string1 LIKE string2 [ ESCAPE char ]</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_en-us_topic_0060575883_p578913717362">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p1434133915154">Returns <strong id="dli_08_15086__b174082158154">TRUE</strong> if <strong id="dli_08_15086__b1867171819150">string1</strong> matches <strong id="dli_08_15086__b72101420181520">string2</strong>;</p>
|
|
<p id="dli_08_15086__p08953415157">returns <strong id="dli_08_15086__b02991133111515">UNKNOWN</strong> if either <strong id="dli_08_15086__b16638436161514">string1</strong> or <strong id="dli_08_15086__b11731139111512">string2</strong> is <strong id="dli_08_15086__b94401409152">NULL</strong>.</p>
|
|
<p id="dli_08_15086__dli_08_0191_a5392d7bf2c5c4f2986008a9e4a24fcaf">Escape characters can be defined if needed, but they are not currently supported.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_r9a06fbefc0be4d8cb30d83ab9c25e37e"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__p8841192315449">string1 NOT LIKE string2 [ ESCAPE char ]</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_a528a7ea5612949eba8f4d892f7826f48">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p5379194501515">Returns <strong id="dli_08_15086__b1144712019164">TRUE</strong> if <strong id="dli_08_15086__b19550310165">string1</strong> does not match <strong id="dli_08_15086__b1738110617165">string2</strong>;</p>
|
|
<p id="dli_08_15086__p4126194791518">returns <strong id="dli_08_15086__b6225211181614">UNKNOWN</strong> if either <strong id="dli_08_15086__b32311411101619">string1</strong> or <strong id="dli_08_15086__b14234181121617">string2</strong> is <strong id="dli_08_15086__b423515118163">NULL</strong>.</p>
|
|
<p id="dli_08_15086__dli_08_0191_en-us_topic_0060575883_p978413783619">Escape characters can be defined if needed, but they are not currently supported.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_rc479b7e0ba1f46659736db6f7673eb70"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__p820203616442">string1 SIMILAR TO string2 [ ESCAPE char ]</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_a5ea9a288c19546ae8ca447159a74207a">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p12117648201512">Returns <strong id="dli_08_15086__b872013433163">TRUE</strong> if <strong id="dli_08_15086__b23806476168">string1</strong> matches the SQL regular expression <strong id="dli_08_15086__b115809555168">string2</strong>;</p>
|
|
<p id="dli_08_15086__p154811749131510">returns <strong id="dli_08_15086__b666043911619">UNKNOWN</strong> if either <strong id="dli_08_15086__b12660103918163">string1</strong> or <strong id="dli_08_15086__b1566013391169">string2</strong> is <strong id="dli_08_15086__b16660143917165">NULL</strong>.</p>
|
|
<p id="dli_08_15086__dli_08_0191_aa04f3cd785574e86938ea12985798eac">Escape characters can be defined if needed, but they are not currently supported.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_r3d65f3aca94948818a5ccda32de2cb89"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__dli_08_0191_en-us_topic_0060575883_p378083733614">string1 NOT SIMILAR TO string2 [ ESCAPE char ]</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_a93c18d7cdbe94462a2252c21c2fbe29b">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p5213951151516">Returns <strong id="dli_08_15086__b19195112721719">TRUE</strong> if <strong id="dli_08_15086__b18798132971714">string1</strong> does not match the SQL regular expression <strong id="dli_08_15086__b95793571719">string2</strong>;</p>
|
|
<p id="dli_08_15086__p1363010528151">returns <strong id="dli_08_15086__b445533710174">UNKNOWN</strong> if either <strong id="dli_08_15086__b11456737181713">string1</strong> or <strong id="dli_08_15086__b84568378176">string2</strong> is <strong id="dli_08_15086__b11456133718173">NULL</strong>.</p>
|
|
<p id="dli_08_15086__dli_08_0191_a5b91b68334a24941a3a81c0c3a7f0f63">Escape characters can be defined if needed, but they are not currently supported.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_r309a232ef09f4f15a1cbcccd8aea80a1"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__p8731153104517">value1 IN (value2 [, value3]* )</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_ac0e2aa975fa84750b0479c9bddb4a292">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p2867553131519">Returns <strong id="dli_08_15086__b101691943111720">TRUE</strong> if <strong id="dli_08_15086__b1516934318173">value1</strong> exists in the given list (value2, value3, …);</p>
|
|
<p id="dli_08_15086__p07781256121519">returns <strong id="dli_08_15086__b149376452178">TRUE</strong> if the list contains <strong id="dli_08_15086__b11938145151714">NULL</strong> and <strong id="dli_08_15086__b11938164521718">value1</strong> can be found, otherwise returns <strong id="dli_08_15086__b1593984510178">UNKNOWN</strong>.</p>
|
|
<p id="dli_08_15086__p144991819164">Always returns <strong id="dli_08_15086__b191521255131710">UNKNOWN</strong> if <strong id="dli_08_15086__b7152105591712">value1</strong> is <strong id="dli_08_15086__b18152125515179">NULL</strong>.</p>
|
|
<p id="dli_08_15086__p25221313131616">For example:</p>
|
|
<ul id="dli_08_15086__ul68907196168"><li id="dli_08_15086__li10890419161614"><strong id="dli_08_15086__b159539131818">4 IN (1, 2, 3)</strong> returns <strong id="dli_08_15086__b10861171011185">FALSE</strong>;</li><li id="dli_08_15086__li14890181941610"><strong id="dli_08_15086__b1746161831818">1 IN (1, 2, NULL)</strong> returns <strong id="dli_08_15086__b39391220101810">TRUE</strong>;</li><li id="dli_08_15086__li1789061951613"><strong id="dli_08_15086__b1952717312189">4 IN (1, 2, NULL)</strong> returns <strong id="dli_08_15086__b1140093321811">UNKNOWN</strong>.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__dli_08_0191_rb4e78c16b3864122a3161313e0899484"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__p43101316194513">value1 NOT IN (value2 [, value3]* )</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__dli_08_0191_en-us_topic_0060575883_p252141415217">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p204681122151620">Returns <strong id="dli_08_15086__b766233517185">TRUE</strong> if <strong id="dli_08_15086__b6663103511815">value1</strong> does not exist in the given list (value2, value3, …);</p>
|
|
<p id="dli_08_15086__p8555202651612">returns <strong id="dli_08_15086__b2823639171817">FALSE</strong> if the list contains <strong id="dli_08_15086__b78242390185">NULL</strong> and <strong id="dli_08_15086__b19824173981815">value1</strong> can be found, otherwise returns <strong id="dli_08_15086__b1482553941812">UNKNOWN</strong>.</p>
|
|
<p id="dli_08_15086__p17684203215163">Always returns <strong id="dli_08_15086__b690344311184">UNKNOWN</strong> if <strong id="dli_08_15086__b390310433181">value1</strong> is <strong id="dli_08_15086__b179041843121815">NULL</strong>.</p>
|
|
<p id="dli_08_15086__p334023481611">For example:</p>
|
|
<ul id="dli_08_15086__ul4399174017169"><li id="dli_08_15086__li239920401167"><strong id="dli_08_15086__b14767205661817">4 NOT IN (1, 2, 3)</strong> returns <strong id="dli_08_15086__b6489558181819">TRUE</strong>;</li><li id="dli_08_15086__li1399124016162"><strong id="dli_08_15086__b13144117121914">1 NOT IN (1, 2, NULL)</strong> returns <strong id="dli_08_15086__b9561981911">FALSE</strong>;</li><li id="dli_08_15086__li8399194018163"><strong id="dli_08_15086__b1955161881910">4 NOT IN (1, 2, NULL)</strong> returns <strong id="dli_08_15086__b7163020161919">UNKNOWN</strong>.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__row730865164719"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__p3525122910457">EXISTS (sub-query)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__p430815113476">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p157332418171">Returns <strong id="dli_08_15086__b266416204620">TRUE</strong> if the subquery returns at least one row.</p>
|
|
<p id="dli_08_15086__p10655202810177">Only operations that can be overridden in join and grouping operations are supported. For streaming queries, this operation is rewritten in joins and grouping. The calculation of the query result required state may increase indefinitely based on the number of input rows.</p>
|
|
<p id="dli_08_15086__p20308125164711">Provide a query configuration with effective retention intervals to prevent excessive state.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__row18797057144714"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__p16879194314512">value IN (sub-query)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__p19797105719474">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p18797155713479">Returns <strong id="dli_08_15086__b12900411282">TRUE</strong> if <strong id="dli_08_15086__b69111475810">value</strong> is equal to one row in the subquery result set.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_15086__row1799035994710"><td class="cellrowborder" valign="top" width="24.759999999999998%" headers="mcps1.3.1.2.4.1.1 "><p id="dli_08_15086__p17807135414516">value NOT IN (sub-query)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.08%" headers="mcps1.3.1.2.4.1.2 "><p id="dli_08_15086__p11990175994712">BOOLEAN</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="62.160000000000004%" headers="mcps1.3.1.2.4.1.3 "><p id="dli_08_15086__p09904591479">Returns <strong id="dli_08_15086__b1951071193">TRUE</strong> if <strong id="dli_08_15086__b22171811998">value</strong> is not contained in the rows returned by the subquery.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_08_15085.html">Built-In Functions</a></div>
|
|
</div>
|
|
</div>
|
|
|