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>
142 lines
13 KiB
HTML
142 lines
13 KiB
HTML
<a name="dli_08_0356"></a><a name="dli_08_0356"></a>
|
|
|
|
<h1 class="topictitle1">string_split</h1>
|
|
<div id="body8662426"><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p8060118">The <strong id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_b1853222141712">string_split</strong> function splits a target string into substrings based on the specified separator and returns a substring list.</p>
|
|
<div class="section" id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_section119977579256"><h4 class="sectiontitle">Description</h4><pre class="screen" id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_screen1265101518263">string_split(target, separator)</pre>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_table343016642713" frame="border" border="1" rules="all"><caption><b>Table 1 </b>string_split parameters</caption><thead align="left"><tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row843114615273"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.3.2.4.1.1"><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p1643176142717">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.3.2.4.1.2"><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p164312682715">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.2.3.2.4.1.3"><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p143111662712">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row6431767278"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.4.1.1 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p154315611276">target</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.4.1.2 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p17431166102716">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.4.1.3 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p194311463278">Target string to be processed</p>
|
|
<div class="note" id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_note11538021162815"><span class="notetitle"> NOTE: </span><div class="notebody"><ul id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_ul1534973892810"><li id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_li143492038102812">If <strong id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_b1585624219116">target </strong>is <strong id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_b8763144012">NULL</strong>, an empty line is returned.</li><li id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_li384713910285">If <strong id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_b185412351014">target</strong> contains two or more consecutive separators, an empty substring is returned.</li><li id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_li1546714518283">If <strong id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_b1486310393111">target</strong> does not contain a specified separator, the original string passed to <strong id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_b1573218281529">target</strong> is returned.</li></ul>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row943118619270"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.4.1.1 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p13431156192714">separator</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.4.1.2 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p84318620278">VARCHAR</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.2.3.2.4.1.3 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p14431166182710">Delimiter. Currently, only single-character delimiters are supported.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_section1492821012311"><h4 class="sectiontitle">Example</h4><ol id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_ol1785543173212"><li id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_li9785174333216">Prepare test input data.
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_table564073111353" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Source table disSource</caption><thead align="left"><tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row2064033115350"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.1.1.2.3.1.1"><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p6640831153514">target (STRING)</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.1.1.2.3.1.2"><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p18640143113356">separator (VARCHAR)</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row166401431183513"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.1.1.2.3.1.1 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p176401231203510">test-flink</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.1.1.2.3.1.2 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p15640931143513">-</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row3640123103514"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.1.1.2.3.1.1 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p0640431113512">flink</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.1.1.2.3.1.2 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p164012318356">-</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row35201593611"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.1.1.2.3.1.1 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p105211514362">one-two-ww-three</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.1.1.2.3.1.2 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p1452215143617">-</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_li18696115423211">Write test SQL statements.<pre class="screen" id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_screen1011916354366">create table disSource(
|
|
target STRING,
|
|
separator VARCHAR
|
|
) with (
|
|
"connector.type" = "dis",
|
|
"connector.region" = "<em id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_i1225514256376">xxx</em>",
|
|
"connector.channel" = "ygj-dis-in",
|
|
"format.type" = 'csv'
|
|
);
|
|
|
|
create table disSink(
|
|
target STRING,
|
|
item STRING
|
|
) with (
|
|
'connector.type' = 'dis',
|
|
'connector.region' = '<em id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_i153482917371">xxx</em>',
|
|
'connector.channel' = 'ygj-dis-out',
|
|
'format.type' = 'csv'
|
|
);
|
|
|
|
insert into
|
|
disSink
|
|
select
|
|
target,
|
|
item
|
|
from
|
|
disSource,
|
|
<strong id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_b78261849183714">lateral table(string_split(target, separator)) as T(item)</strong>;</pre>
|
|
</li><li id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_li165891447334">Check test results.
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_table1224792612384" frame="border" border="1" rules="all"><caption><b>Table 3 </b>disSink result table</caption><thead align="left"><tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row3248142673812"><th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.3.1.2.3.1.1"><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p132483264384">target (STRING)</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.3.2.3.1.2.3.1.2"><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p2024812663815">item (STRING)</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row52487268382"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.1 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p18248126193810">test-flink</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.2 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p524862612382">test</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row182481265381"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.1 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p2073410286408">test-flink</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.2 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p132481265389">flink</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row1724882673820"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.1 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p132487269382">flink</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.2 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p824812264386">flink</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row324812673811"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.1 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p12481526203810">one-two-ww-three</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.2 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p192481326113811">one</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row7248142615382"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.1 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p5349749114019">one-two-ww-three</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.2 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p122481526123810">two</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row1534343574111"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.1 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p634316358417">one-two-ww-three</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.2 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p3343535194115">ww</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_row112301746104113"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.1 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p14231194634112">one-two-ww-three</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.3.2.3.1.2.3.1.2 "><p id="dli_08_0356__en-us_topic_0000001214500927_en-us_topic_0000001168912384_p1323154694113">three</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ol>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_08_0342.html">Table-Valued Functions</a></div>
|
|
</div>
|
|
</div>
|
|
|