forked from docs/doc-exports
Su, Xiaomeng
04d4597cf3
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>
78 lines
10 KiB
HTML
78 lines
10 KiB
HTML
<a name="dli_08_0335"></a><a name="dli_08_0335"></a>
|
|
|
|
<h1 class="topictitle1">Conditional Functions</h1>
|
|
<div id="body8662426"><div class="section" id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_section175296263348"><h4 class="sectiontitle">Description</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_table593115413344" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Conditional functions</caption><thead align="left"><tr id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_row139321154103412"><th align="left" class="cellrowborder" valign="top" width="35.260000000000005%" id="mcps1.3.1.2.2.3.1.1"><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p3932185403416">Function</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="64.74%" id="mcps1.3.1.2.2.3.1.2"><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p13932125414344">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_row6932185433418"><td class="cellrowborder" valign="top" width="35.260000000000005%" headers="mcps1.3.1.2.2.3.1.1 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p11986526193519">CASE value</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p1998652615359">WHEN value1_1 [, value1_2 ]* THEN result1</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p15986426113515">[ WHEN value2_1 [, value2_2 ]* THEN result2 ]*</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p169869268353">[ ELSE resultZ ]</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p159861326203517">END</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.74%" headers="mcps1.3.1.2.2.3.1.2 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p189321854163410">Returns <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b06741333387">resultX</strong> when the value is contained in (valueX_1, valueX_2, …).</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p08581858114413">Only the first matched value is returned.</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p17849124611372">When no value matches, returns <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b7492191620382">resultZ</strong> if it is provided and returns <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b10313171920384">NULL</strong> otherwise.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_row4932195473415"><td class="cellrowborder" valign="top" width="35.260000000000005%" headers="mcps1.3.1.2.2.3.1.1 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p51794393415">CASE</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p417983904110">WHEN condition1 THEN result1</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p11179739134119">[ WHEN condition2 THEN result2 ]*</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p117923974114">[ ELSE resultZ ]</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p1217973934115">END</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.74%" headers="mcps1.3.1.2.2.3.1.2 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p3932165418343">Returns <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b1071242215389">resultX</strong> when the first <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b1658218276389">conditionX</strong> is met.</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p880612435484">Only the first matched value is returned.</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p156698526484">When no condition is met, returns <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b1154433415381">resultZ</strong> if it is provided and returns <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b20652183711382">NULL</strong> otherwise.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_row993211549344"><td class="cellrowborder" valign="top" width="35.260000000000005%" headers="mcps1.3.1.2.2.3.1.1 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p10932554153411">NULLIF(value1, value2)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.74%" headers="mcps1.3.1.2.2.3.1.2 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p193255414343">Returns NULL if value1 is equal to value2; returns value1 otherwise.</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p1475662712519">For example, <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b128071711133918">NullIF (5, 5)</strong> returns <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b49026147394">NULL</strong>.</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p190355105020"><strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b1776511352395">NULLIF(5, 0)</strong> returns <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b671133411395">5</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_row293205420347"><td class="cellrowborder" valign="top" width="35.260000000000005%" headers="mcps1.3.1.2.2.3.1.1 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p5932854103411">COALESCE(value1, value2 [, value3 ]* )</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.74%" headers="mcps1.3.1.2.2.3.1.2 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p18932454133420">Returns the first value (from left to right) that is not NULL from value1, value2, ….</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p2062982355211">For example, <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b8501112864010">COALESCE(NULL, 5)</strong> returns <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b82325269405">5</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_row12932145413414"><td class="cellrowborder" valign="top" width="35.260000000000005%" headers="mcps1.3.1.2.2.3.1.1 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p09321754123413">IF(condition, true_value, false_value)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.74%" headers="mcps1.3.1.2.2.3.1.2 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p8932454133411">Returns the <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b1914912392407">true_value</strong> if condition is met, otherwise <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b1671194414407">false_value</strong>.</p>
|
|
<p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p9273429105315">For example, <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b172821595400">IF(5 > 3, 5, 3)</strong> returns <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b242175312405">5</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_row093225416342"><td class="cellrowborder" valign="top" width="35.260000000000005%" headers="mcps1.3.1.2.2.3.1.1 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p4932145483411">IS_ALPHA(string)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.74%" headers="mcps1.3.1.2.2.3.1.2 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p1932205453416">Returns <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b722052854119">TRUE</strong> if all characters in the string are letters, otherwise <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b1928622184115">FALSE</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_row1493211549344"><td class="cellrowborder" valign="top" width="35.260000000000005%" headers="mcps1.3.1.2.2.3.1.1 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p1932115412346">IS_DECIMAL(string)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.74%" headers="mcps1.3.1.2.2.3.1.2 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p1893215417349">Returns <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b164934117413">TRUE</strong> if string can be parsed to a valid numeric, otherwise <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b376915438411">FALSE</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_row1693285413343"><td class="cellrowborder" valign="top" width="35.260000000000005%" headers="mcps1.3.1.2.2.3.1.1 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p1593245483418">IS_DIGIT(string)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="64.74%" headers="mcps1.3.1.2.2.3.1.2 "><p id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_p10932155413349">Returns <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b195281654114117">TRUE</strong> if all characters in the string are digits, otherwise <strong id="dli_08_0335__en-us_topic_0000001119072208_en-us_topic_0000001084521660_b83075579419">FALSE</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_08_0331.html">Built-In Functions</a></div>
|
|
</div>
|
|
</div>
|
|
|