vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/dev/dws_06_0333.html
Lu, Huayi e6fa411af0 DWS DEV 830.201 version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2024-05-16 07:24:04 +00:00

234 lines
26 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001495502029"></a><a name="EN-US_TOPIC_0000001495502029"></a>
<h1 class="topictitle1">Array Functions</h1>
<div id="body0000001495502029"><div class="section" id="EN-US_TOPIC_0000001495502029__section87471154133410"><h4 class="sectiontitle">array_append(anyarray, anyelement)</h4><p id="EN-US_TOPIC_0000001495502029__p1174005463413">Description: Appends an element to the end of an array, and only supports dimension-1 arrays.</p>
<p id="EN-US_TOPIC_0000001495502029__p1574085415341">Return type: anyarray</p>
<p id="EN-US_TOPIC_0000001495502029__p1674085417343">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495502029__screen16741195443415"><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_0000001495502029__section83982018355"><h4 class="sectiontitle">array_prepend(anyelement, anyarray)</h4><p id="EN-US_TOPIC_0000001495502029__p1039019033513">Description: Appends an element to the beginning of an array, and only supports dimension-1 arrays.</p>
<p id="EN-US_TOPIC_0000001495502029__p1339013033514">Return type: anyarray</p>
<p id="EN-US_TOPIC_0000001495502029__p1039016073517">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495502029__screen9391107350"><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_0000001495502029__section15516315358"><h4 class="sectiontitle">array_cat(anyarray, anyarray)</h4><p id="EN-US_TOPIC_0000001495502029__p9545183183517">Description: Concatenates two arrays, and supports multi-dimensional arrays.</p>
<p id="EN-US_TOPIC_0000001495502029__p354517319353">Return type: anyarray</p>
<p id="EN-US_TOPIC_0000001495502029__p8545153143514">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495502029__screen45461433352"><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_0000001495502029__section14744969352"><h4 class="sectiontitle">array_ndims(anyarray)</h4><p id="EN-US_TOPIC_0000001495502029__p373916673512">Description: Returns the number of dimensions of the array.</p>
<p id="EN-US_TOPIC_0000001495502029__p6740146123512">Return type: int</p>
<p id="EN-US_TOPIC_0000001495502029__p1740969353">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495502029__screen17740106113510"><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_0000001495502029__section228711911358"><h4 class="sectiontitle">array_dims(anyarray)</h4><p id="EN-US_TOPIC_0000001495502029__p152811993511">Description: Returns a text representation of array's dimensions.</p>
<p id="EN-US_TOPIC_0000001495502029__p18281189133513">Return type: text</p>
<p id="EN-US_TOPIC_0000001495502029__p16281139113512">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495502029__screen162825943520"><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_0000001495502029__section115618128354"><h4 class="sectiontitle">array_length(anyarray, int)</h4><p id="EN-US_TOPIC_0000001495502029__p455631217357">Description: Returns the length of the requested array dimension.</p>
<p id="EN-US_TOPIC_0000001495502029__p955641233511">Return type: int</p>
<p id="EN-US_TOPIC_0000001495502029__p9556201243513">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495502029__screen105571120351"><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_0000001495502029__section524914167353"><h4 class="sectiontitle">array_lower(anyarray, int)</h4><p id="EN-US_TOPIC_0000001495502029__p142451416163512">Description: Returns lower bound of the requested array dimension.</p>
<p id="EN-US_TOPIC_0000001495502029__p1424616164352">Return type: int</p>
<p id="EN-US_TOPIC_0000001495502029__p17246161611350">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495502029__screen8246316193513"><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_0000001495502029__section22767193359"><h4 class="sectiontitle">array_upper(anyarray, int)</h4><p id="EN-US_TOPIC_0000001495502029__p1927341918359">Description: Returns upper bound of the requested array dimension.</p>
<p id="EN-US_TOPIC_0000001495502029__p8273111919358">Return type: int</p>
<p id="EN-US_TOPIC_0000001495502029__p12736195358">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495502029__screen1427351917357"><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_0000001495502029__section132102243518"><h4 class="sectiontitle">array_to_string(anyarray, text [, text])</h4><p id="EN-US_TOPIC_0000001495502029__p181622243517">Description: Uses the first <strong id="EN-US_TOPIC_0000001495502029__b85330135593923">text</strong> as the new delimiter and the second <strong id="EN-US_TOPIC_0000001495502029__b108135770593923">text</strong> to replace <strong id="EN-US_TOPIC_0000001495502029__b45851301393923">NULL</strong> values.</p>
<p id="EN-US_TOPIC_0000001495502029__p13165226355">Return type: text</p>
<p id="EN-US_TOPIC_0000001495502029__p8161822153512">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495502029__screen1917162211352"><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_0000001495502029__note11902293515"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001495502029__p161952214358">In <strong id="EN-US_TOPIC_0000001495502029__b131905600293923">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_0000001495502029__section19248132503516"><h4 class="sectiontitle">string_to_array(text, text [, text])</h4><p id="EN-US_TOPIC_0000001495502029__p824612255356">Description: Uses the second <strong id="EN-US_TOPIC_0000001495502029__b43183075093923">text</strong> as the new delimiter and the third <strong id="EN-US_TOPIC_0000001495502029__b66685256293923">text</strong> as the substring to be replaced by <strong id="EN-US_TOPIC_0000001495502029__b131273146893923">NULL</strong> values. A substring can be replaced by <strong id="EN-US_TOPIC_0000001495502029__b46686596593923">NULL</strong> values only when it is the same as the third <strong id="EN-US_TOPIC_0000001495502029__b180617249593923">text</strong>.</p>
<p id="EN-US_TOPIC_0000001495502029__p5246182583513">Return type: text[]</p>
<p id="EN-US_TOPIC_0000001495502029__p62461125193513">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495502029__screen182471925203511"><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_0000001495502029__note82471525113515"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001495502029__ul19247182510356"><li id="EN-US_TOPIC_0000001495502029__li32471525113517">In <strong id="EN-US_TOPIC_0000001495502029__b35130220893923">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.</li><li id="EN-US_TOPIC_0000001495502029__li02471325173512">In <strong id="EN-US_TOPIC_0000001495502029__b109747943793923">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.</li></ul>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001495502029__section893152873511"><h4 class="sectiontitle">unnest(anyarray)</h4><p id="EN-US_TOPIC_0000001495502029__p99311328193517">Description: Expands an array to a set of rows.</p>
<p id="EN-US_TOPIC_0000001495502029__p39311328103519">Return type: setof anyelement</p>
<p id="EN-US_TOPIC_0000001495502029__p1893192816357">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001495502029__screen89314283350"><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_0000001495502029__p9672141117">The <strong id="EN-US_TOPIC_0000001495502029__b1249410236171">unnest</strong> function is used together with the <strong id="EN-US_TOPIC_0000001495502029__b749492331720">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_0000001495502029__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>
<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