forked from docs/doc-exports
Su, Xiaomeng
76a5b1ee83
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>
65 lines
7.8 KiB
HTML
65 lines
7.8 KiB
HTML
<a name="dli_spark_keyvalue"></a><a name="dli_spark_keyvalue"></a>
|
|
|
|
<h1 class="topictitle1">keyvalue</h1>
|
|
<div id="body8662426"><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p1662914651016">This function is used to split str by split1, convert each group into a key-value pair by split2, and return the value corresponding to the key.</p>
|
|
<div class="section" id="dli_spark_keyvalue__en-us_topic_0000001647939934_section45291954203217"><h4 class="sectiontitle">Syntax</h4><pre class="screen" id="dli_spark_keyvalue__en-us_topic_0000001647939934_screen1164981619226">keyvalue(string <str>,[string <split1>,string <split2>,] string <key>)</pre>
|
|
</div>
|
|
<div class="section" id="dli_spark_keyvalue__en-us_topic_0000001647939934_section992014913317"><h4 class="sectiontitle">Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_spark_keyvalue__en-us_topic_0000001647939934_table1829154762513" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters</caption><thead align="left"><tr id="dli_spark_keyvalue__en-us_topic_0000001647939934_row8830104792517"><th align="left" class="cellrowborder" valign="top" width="19.220000000000002%" id="mcps1.3.3.2.2.5.1.1"><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p983074711252">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.420000000000002%" id="mcps1.3.3.2.2.5.1.2"><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p6830124732517">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.590000000000002%" id="mcps1.3.3.2.2.5.1.3"><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p13318164512614">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="51.77%" id="mcps1.3.3.2.2.5.1.4"><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p08301547132513">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_spark_keyvalue__en-us_topic_0000001647939934_row2826191220118"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p58771645125213">str</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.420000000000002%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p14826312111113">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.590000000000002%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p18826101211118">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.77%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p026862711252">String to be split</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_spark_keyvalue__en-us_topic_0000001647939934_row1082954961819"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p582920492181">split1, split2</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.420000000000002%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p1982912495184">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.590000000000002%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p482994921815">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.77%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p412117557217">Strings used as separators to split the source string. If these two separators are not specified in the expression, the default values are <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b146559343318">;</strong> for <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b146811539143116">split1</strong> and <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b249544519311">:</strong> for <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b1708480313">split2</strong>. If there are multiple occurrences of split2 within a string that has been split by split1, the result is undefined.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_spark_keyvalue__en-us_topic_0000001647939934_row19785145451818"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p20785154101811">key</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.420000000000002%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p18785254171815">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.590000000000002%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p1778517546181">BIGINT</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.77%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p4785954151811">The corresponding value when the string is split using <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b137631017103314">split1</strong> and <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b16485141993318">split2</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_spark_keyvalue__en-us_topic_0000001647939934_section210162513312"><h4 class="sectiontitle">Return Values</h4><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p92514338222">The return value is of the STRING type.</p>
|
|
<div class="note" id="dli_spark_keyvalue__en-us_topic_0000001647939934_note1542519149539"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dli_spark_keyvalue__en-us_topic_0000001647939934_ul170315442224"><li id="dli_spark_keyvalue__en-us_topic_0000001647939934_li17032442224">If the value of <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b17253151218479">split1</strong> or <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b16254121244712">split2</strong> is <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b11254312164719">NULL</strong>, <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b62547121474">NULL</strong> is returned.</li><li id="dli_spark_keyvalue__en-us_topic_0000001647939934_li470314411223">If the value of <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b10349738194711">str</strong> or <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b1975119418476">key</strong> is <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b27892447472">NULL</strong> or no matching key is found, <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b01546563473">NULL</strong> is returned.</li><li id="dli_spark_keyvalue__en-us_topic_0000001647939934_li07037444227">If multiple key-value pairs are matched, the value corresponding to the first matched key is returned.</li></ul>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="dli_spark_keyvalue__en-us_topic_0000001647939934_section13277192233920"><h4 class="sectiontitle">Example Code</h4><p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p1268835715712">The value <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b50834313114011">2</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_keyvalue__en-us_topic_0000001647939934_screen129381058816">select keyvalue('a:1;b:2', 'b');</pre>
|
|
<p id="dli_spark_keyvalue__en-us_topic_0000001647939934_p1668819571972">The value <strong id="dli_spark_keyvalue__en-us_topic_0000001647939934_b938971141114011">2</strong> is returned.</p>
|
|
<pre class="screen" id="dli_spark_keyvalue__en-us_topic_0000001647939934_screen20256310882">select keyvalue("\;abc:1\;def:2","\;",":","def");</pre>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_08_0472.html">String Functions</a></div>
|
|
</div>
|
|
</div>
|
|
|