yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
03e77f3e5b0080047fdcb72efdfd3333dd3bcf92
doc-exports/docs/dws/dev/dws_06_0333.html
luhuayi 177cd61a57 DWS DEVG 910.211 version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: luhuayi <luhuayi@huawei.com>
Co-committed-by: luhuayi <luhuayi@huawei.com>
2025-05-05 07:44:03 +00:00

263 lines
31 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001811634621"></a><a name="EN-US_TOPIC_0000001811634621"></a>
<h1 class="topictitle1">Array Functions</h1>
<div id="body0000001503479345"><div class="section" id="EN-US_TOPIC_0000001811634621__section1828214072919"><h4 class="sectiontitle">array_append(anyarray, anyelement)</h4><p id="EN-US_TOPIC_0000001811634621__p7275540172914">Description: Appends an element to the end of an array, and only supports dimension-1 arrays.</p>
<p id="EN-US_TOPIC_0000001811634621__p132751740122914">Return type: anyarray</p>
<p id="EN-US_TOPIC_0000001811634621__p3275104062914">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen527534017296"><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">array_append</span><span class="p">(</span><span class="nb">ARRAY</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">],</span><span class="w"> </span><span class="mi">3</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="err">{</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="err">}</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_0000001811634621__section546414434297"><h4 class="sectiontitle">array_prepend(anyelement, anyarray)</h4><p id="EN-US_TOPIC_0000001811634621__p14581743172912">Description: Appends an element to the beginning of an array, and only supports dimension-1 arrays.</p>
<p id="EN-US_TOPIC_0000001811634621__p17458343112913">Return type: anyarray</p>
<p id="EN-US_TOPIC_0000001811634621__p1458184342917">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen204582043182919"><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">array_prepend</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="nb">ARRAY</span><span class="p">[</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</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="err">{</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="err">}</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_0000001811634621__section5545124717296"><h4 class="sectiontitle">array_cat(anyarray, anyarray)</h4><p id="EN-US_TOPIC_0000001811634621__p2540144712292">Description: Concatenates two arrays, and supports multi-dimensional arrays.</p>
<p id="EN-US_TOPIC_0000001811634621__p195401847162916">Return type: anyarray</p>
<p id="EN-US_TOPIC_0000001811634621__p554084710292">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen7541194762912"><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>
<span class="normal">11</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">array_cat</span><span class="p">(</span><span class="nb">ARRAY</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">],</span><span class="w"> </span><span class="nb">ARRAY</span><span class="p">[</span><span class="mi">4</span><span class="p">,</span><span class="mi">5</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="err">{</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">,</span><span class="mi">4</span><span class="p">,</span><span class="mi">5</span><span class="err">}</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="n">array_cat</span><span class="p">(</span><span class="nb">ARRAY</span><span class="p">[[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">],[</span><span class="mi">4</span><span class="p">,</span><span class="mi">5</span><span class="p">]],</span><span class="w"> </span><span class="nb">ARRAY</span><span class="p">[</span><span class="mi">6</span><span class="p">,</span><span class="mi">7</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="err">{{</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="err">}</span><span class="p">,</span><span class="err">{</span><span class="mi">4</span><span class="p">,</span><span class="mi">5</span><span class="err">}</span><span class="p">,</span><span class="err">{</span><span class="mi">6</span><span class="p">,</span><span class="mi">7</span><span class="err">}}</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_0000001811634621__section918165132917"><h4 class="sectiontitle">array_ndims(anyarray)</h4><p id="EN-US_TOPIC_0000001811634621__p8175205114290">Description: Returns the number of dimensions of the array.</p>
<p id="EN-US_TOPIC_0000001811634621__p19175145162912">Return type: int</p>
<p id="EN-US_TOPIC_0000001811634621__p18175155112295">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen1217565182919"><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">array_ndims</span><span class="p">(</span><span class="nb">ARRAY</span><span class="p">[[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">],</span><span class="w"> </span><span class="p">[</span><span class="mi">4</span><span class="p">,</span><span class="mi">5</span><span class="p">,</span><span class="mi">6</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="mi">2</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_0000001811634621__section21931754122915"><h4 class="sectiontitle">array_dims(anyarray)</h4><p id="EN-US_TOPIC_0000001811634621__p718815402911">Description: Returns a text representation of array's dimensions.</p>
<p id="EN-US_TOPIC_0000001811634621__p4189155415290">Return type: text</p>
<p id="EN-US_TOPIC_0000001811634621__p7189175402911">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen318925412911"><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">array_dims</span><span class="p">(</span><span class="nb">ARRAY</span><span class="p">[[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">],</span><span class="w"> </span><span class="p">[</span><span class="mi">4</span><span class="p">,</span><span class="mi">5</span><span class="p">,</span><span class="mi">6</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="p">[</span><span class="mi">1</span><span class="p">:</span><span class="mi">2</span><span class="p">][</span><span class="mi">1</span><span class="p">:</span><span class="mi">3</span><span class="p">]</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_0000001811634621__section7232105742910"><h4 class="sectiontitle">array_length(anyarray, int)</h4><p id="EN-US_TOPIC_0000001811634621__p222655702912">Description: Returns the length of the requested array dimension.</p>
<p id="EN-US_TOPIC_0000001811634621__p12226185732920">Return type: int</p>
<p id="EN-US_TOPIC_0000001811634621__p8226175714295">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen1022714578299"><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">array_length</span><span class="p">(</span><span class="nb">array</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">],</span><span class="w"> </span><span class="mi">1</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="mi">3</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_0000001811634621__section8761306303"><h4 class="sectiontitle">array_lower(anyarray, int)</h4><p id="EN-US_TOPIC_0000001811634621__p5713083014">Description: Returns lower bound of the requested array dimension.</p>
<p id="EN-US_TOPIC_0000001811634621__p97180143013">Return type: int</p>
<p id="EN-US_TOPIC_0000001811634621__p47116019303">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen207118013309"><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">array_lower</span><span class="p">(</span><span class="s1">'[0:2]={1,2,3}'</span><span class="p">::</span><span class="nb">int</span><span class="p">[],</span><span class="w"> </span><span class="mi">1</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="mi">0</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_0000001811634621__section107618283018"><h4 class="sectiontitle">array_upper(anyarray, int)</h4><p id="EN-US_TOPIC_0000001811634621__p137587211309">Description: Returns upper bound of the requested array dimension.</p>
<p id="EN-US_TOPIC_0000001811634621__p1475818211304">Return type: int</p>
<p id="EN-US_TOPIC_0000001811634621__p8758202103020">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen975913233016"><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">array_upper</span><span class="p">(</span><span class="nb">ARRAY</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">8</span><span class="p">,</span><span class="mi">3</span><span class="p">,</span><span class="mi">7</span><span class="p">],</span><span class="w"> </span><span class="mi">1</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="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_0000001811634621__section20497185133015"><h4 class="sectiontitle">array_to_string(anyarray, text [, text])</h4><p id="EN-US_TOPIC_0000001811634621__p1849416563014">Description: Uses the first <strong id="EN-US_TOPIC_0000001811634621__b739595950101620">text</strong> as the new delimiter and the second <strong id="EN-US_TOPIC_0000001811634621__b1907554895101620">text</strong> to replace <strong id="EN-US_TOPIC_0000001811634621__b637349803101620">NULL</strong> values.</p>
<p id="EN-US_TOPIC_0000001811634621__p15494205203015">Return type: text</p>
<p id="EN-US_TOPIC_0000001811634621__p12495125103019">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen24951756302"><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">array_to_string</span><span class="p">(</span><span class="nb">ARRAY</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w"> </span><span class="k">NULL</span><span class="p">,</span><span class="w"> </span><span class="mi">5</span><span class="p">],</span><span class="w"> </span><span class="s1">','</span><span class="p">,</span><span class="w"> </span><span class="s1">'*'</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="mi">1</span><span class="p">,</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">,</span><span class="o">*</span><span class="p">,</span><span class="mi">5</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 class="note" id="EN-US_TOPIC_0000001811634621__note15904154113120"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001811634621__p1794104211317">In <strong id="EN-US_TOPIC_0000001811634621__b919419347101620">string_to_array</strong>, if the null-string parameter is omitted or NULL, none of the substrings of the input will be replaced by NULL.</p>
<p id="EN-US_TOPIC_0000001811634621__p1579474273119">In <strong id="EN-US_TOPIC_0000001811634621__b212094920101620">array_to_string</strong>, if the null-string parameter is omitted or NULL, any null elements in the array are simply skipped and not represented in the output string.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001811634621__section1191158173016"><h4 class="sectiontitle">string_to_array(text, text [, text])</h4><p id="EN-US_TOPIC_0000001811634621__p19906843016">Description: Uses the second <strong id="EN-US_TOPIC_0000001811634621__b438860269101620">text</strong> as the new delimiter and the third <strong id="EN-US_TOPIC_0000001811634621__b1409185761101620">text</strong> as the substring to be replaced by <strong id="EN-US_TOPIC_0000001811634621__b1099211416101620">NULL</strong> values. A substring can be replaced by <strong id="EN-US_TOPIC_0000001811634621__b191059739101620">NULL</strong> values only when it is the same as the third <strong id="EN-US_TOPIC_0000001811634621__b1390260363101620">text</strong>.</p>
<p id="EN-US_TOPIC_0000001811634621__p7902813308">Return type: text[]</p>
<p id="EN-US_TOPIC_0000001811634621__p59020833016">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen8908816301"><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="n">string_to_array</span><span class="p">(</span><span class="s1">'xx~^~yy~^~zz'</span><span class="p">,</span><span class="w"> </span><span class="s1">'~^~'</span><span class="p">,</span><span class="w"> </span><span class="s1">'yy'</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="err">{</span><span class="n">xx</span><span class="p">,</span><span class="k">NULL</span><span class="p">,</span><span class="n">zz</span><span class="err">}</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="n">string_to_array</span><span class="p">(</span><span class="s1">'xx~^~yy~^~zz'</span><span class="p">,</span><span class="w"> </span><span class="s1">'~^~'</span><span class="p">,</span><span class="w"> </span><span class="s1">'y'</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="err">{</span><span class="n">xx</span><span class="p">,</span><span class="n">yy</span><span class="p">,</span><span class="n">zz</span><span class="err">}</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 class="note" id="EN-US_TOPIC_0000001811634621__note14272287316"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001811634621__p7427162816317">In <strong id="EN-US_TOPIC_0000001811634621__b1128802884101620">string_to_array</strong>, if the delimiter parameter is NULL, each character in the input string will become a separate element in the resulting array. If the delimiter is an empty string, then the entire input string is returned as a one-element array. Otherwise the input string is split at each occurrence of the delimiter string.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001811634621__section16222141123011"><h4 class="sectiontitle">unnest(anyarray)</h4><p id="EN-US_TOPIC_0000001811634621__p10222131111306">Description: Expands an array to a set of rows.</p>
<p id="EN-US_TOPIC_0000001811634621__p1622261143010">Return type: setof anyelement</p>
<p id="EN-US_TOPIC_0000001811634621__p1222171153016">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen142224117307"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">unnest</span><span class="p">(</span><span class="nb">ARRAY</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">2</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="mi">1</span>
<span class="w"> </span><span class="mi">2</span>
<span class="p">(</span><span class="mi">2</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001811634621__p9672141117">The <strong id="EN-US_TOPIC_0000001811634621__b1742023279103829">unnest</strong> function is used together with the <strong id="EN-US_TOPIC_0000001811634621__b1448741543103829">string_to_array</strong> array. To convert an array to columns, the statement first splits a string into arrays by comma, and then converts the arrays into columns.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen199051028523"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">unnest</span><span class="p">(</span><span class="n">string_to_array</span><span class="p">(</span><span class="s1">'a,b,c,d'</span><span class="p">,</span><span class="s1">','</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="c1">--------</span>
<span class="w"> </span><span class="n">a</span>
<span class="w"> </span><span class="n">b</span>
<span class="w"> </span><span class="k">c</span>
<span class="w"> </span><span class="n">d</span>
<span class="p">(</span><span class="mi">4</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001811634621__section197871051103016"><h4 class="sectiontitle">interval(N, N1, N2, N3 ... )</h4><p id="EN-US_TOPIC_0000001811634621__p828812162571">Description: Searches for the last array index that is less than or equal to the target parameter <strong id="EN-US_TOPIC_0000001811634621__b1886722673101620">n</strong> from the input integer array. If n is NULL, <strong id="EN-US_TOPIC_0000001811634621__b434725769101620">-1</strong> is returned. The <strong id="EN-US_TOPIC_0000001811634621__b1649857649101620">interval()</strong> function does not support the interval(N, N1) scenario. This function is supported by version 8.2.0 or later clusters.</p>
<p id="EN-US_TOPIC_0000001811634621__p44364246588">Return type: int</p>
<p id="EN-US_TOPIC_0000001811634621__p7541816105917">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen1554233215920"><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="nb">INTERVAL</span><span class="p">(</span><span class="mi">10</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w"> </span><span class="mi">5</span><span class="p">,</span><span class="w"> </span><span class="mi">6</span><span class="p">,</span><span class="w"> </span><span class="mi">7</span><span class="p">,</span><span class="w"> </span><span class="mi">8</span><span class="p">,</span><span class="w"> </span><span class="mi">9</span><span class="p">,</span><span class="w"> </span><span class="mi">10</span><span class="p">,</span><span class="w"> </span><span class="mi">10</span><span class="p">,</span><span class="w"> </span><span class="mi">11</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="mi">11</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_0000001811634621__section1866518595300"><h4 class="sectiontitle">split(string, delim)</h4><p id="EN-US_TOPIC_0000001811634621__p128123710213">Description: Separates strings by a delimiter and returns an array. This function is supported by version 8.2.0 or later clusters.</p>
<p id="EN-US_TOPIC_0000001811634621__p76212591725">Return type: text[]</p>
<p id="EN-US_TOPIC_0000001811634621__p455119556311">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001811634621__screen1266218493110"><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="n">SPLIT</span><span class="p">(</span><span class="s1">'a-b-c-d-e'</span><span class="p">,</span><span class="w"> </span><span class="s1">'-'</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="err">{</span><span class="n">a</span><span class="p">,</span><span class="n">b</span><span class="p">,</span><span class="k">c</span><span class="p">,</span><span class="n">d</span><span class="p">,</span><span class="n">e</span><span class="err">}</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="n">SPLIT</span><span class="p">(</span><span class="s1">'a-b-c-d-e'</span><span class="p">,</span><span class="w"> </span><span class="s1">'-'</span><span class="p">)[</span><span class="mi">4</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">d</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>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0044.html">Array Functions and Operators</a></div>
</div>
</div>
View Git Blame Copy Permalink