youjiageng1/doc-exports
1
0
Fork 0
forked from laiweijian4/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/dev/dws_06_0044.html
Lu, Huayi a24ca60074 DWS DEVELOPER 811 version 
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2023-01-19 13:37:49 +00:00

388 lines
53 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001099150888"></a><a name="EN-US_TOPIC_0000001099150888"></a>
<h1 class="topictitle1">Array Functions and Operators</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001099150888__s3540331929ff4448813cb66d4e219418"><h4 class="sectiontitle">Array Operators</h4><ul id="EN-US_TOPIC_0000001099150888__u9fa2d7a6541a403196f3d189142ac9d7"><li id="EN-US_TOPIC_0000001099150888__lec1c5dba749b4191b0e84f68c4b7ce71">=<p id="EN-US_TOPIC_0000001099150888__a35a69c24ac314b7a833387e3e4105597"><a name="EN-US_TOPIC_0000001099150888__lec1c5dba749b4191b0e84f68c4b7ce71"></a><a name="lec1c5dba749b4191b0e84f68c4b7ce71"></a>Description: Specifies whether two arrays are equal.</p>
<p id="EN-US_TOPIC_0000001099150888__a0537403c90484609a7d04fb266ae2d72">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__see826785af054f61a9b7e474c3b96faf"><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">ARRAY</span><span class="p">[</span><span class="mi">1</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="mi">1</span><span class="p">]::</span><span class="nb">int</span><span class="p">[]</span><span class="w"> </span><span class="o">=</span><span class="w"> </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="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="w"> </span><span class="p">;</span><span class="w"></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">t</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__l2a2b9d1970f1417fb5633f965e24f20e">&lt;&gt;<p id="EN-US_TOPIC_0000001099150888__a1d626c88b99045ba8b4f0bda7acbaad7"><a name="EN-US_TOPIC_0000001099150888__l2a2b9d1970f1417fb5633f965e24f20e"></a><a name="l2a2b9d1970f1417fb5633f965e24f20e"></a>Description: Specifies whether two arrays are not equal.</p>
<p id="EN-US_TOPIC_0000001099150888__afe4b912d125841d681e2eeeaf368efeb">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s4f47871c2c20489388227d9373a710e9"><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">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="o">&lt;&gt;</span><span class="w"> </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="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="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__l063d696101844bcda0cae1e5fb4d036e">&lt;<p id="EN-US_TOPIC_0000001099150888__aff54f0417be44186b4f1b459cd50c3c3"><a name="EN-US_TOPIC_0000001099150888__l063d696101844bcda0cae1e5fb4d036e"></a><a name="l063d696101844bcda0cae1e5fb4d036e"></a>Description: Specifies whether an array is less than another.</p>
<p id="EN-US_TOPIC_0000001099150888__a291293668eb84fd283f3ce188f548270">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s5e085877f7e54d4d9e5d05247cdcf569"><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">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="o">&lt;</span><span class="w"> </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="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="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__l4def883b110447c5929c0540ae541f4f">&gt;<p id="EN-US_TOPIC_0000001099150888__a8859abe23f5a44c093c9eaee8b45cf4a"><a name="EN-US_TOPIC_0000001099150888__l4def883b110447c5929c0540ae541f4f"></a><a name="l4def883b110447c5929c0540ae541f4f"></a>Description: Specifies whether an array is greater than another.</p>
<p id="EN-US_TOPIC_0000001099150888__a1808c82a44ea4459900ec1acaef5c217">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s8fa84b40ad814b109029b3ce978bae1d"><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">ARRAY</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">4</span><span class="p">,</span><span class="mi">3</span><span class="p">]</span><span class="w"> </span><span class="o">&gt;</span><span class="w"> </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="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="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__l3c46e579a9fd4a0084d0de175c2588d2">&lt;=<p id="EN-US_TOPIC_0000001099150888__af0caf0b68e9a44dc94f5fe7f14557338"><a name="EN-US_TOPIC_0000001099150888__l3c46e579a9fd4a0084d0de175c2588d2"></a><a name="l3c46e579a9fd4a0084d0de175c2588d2"></a>Description: Specifies whether an array is less than another.</p>
<p id="EN-US_TOPIC_0000001099150888__a03489e256f0f46d8b8fc3585a2ad6bd3">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__se4f180740b8345a5a3e569c084b3d8a2"><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">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="o">&lt;=</span><span class="w"> </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="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span><span class="w"></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">t</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__l98c970f070f14bc9a56f5222cf5ab24a">&gt;=<p id="EN-US_TOPIC_0000001099150888__a9f230089786645539eb3891058beae16"><a name="EN-US_TOPIC_0000001099150888__l98c970f070f14bc9a56f5222cf5ab24a"></a><a name="l98c970f070f14bc9a56f5222cf5ab24a"></a>Description: Specifies whether an array is greater than or equal to another.</p>
<p id="EN-US_TOPIC_0000001099150888__a78b232158b5945bbbfa79cb214e7333a">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s2fc887dd90e544e992c42c0fb7a25ef1"><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">ARRAY</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">4</span><span class="p">,</span><span class="mi">3</span><span class="p">]</span><span class="w"> </span><span class="o">&gt;=</span><span class="w"> </span><span class="nb">ARRAY</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">4</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="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__l9e43f96437c64ff1884b5fe387bb8c7a">@&gt;<p id="EN-US_TOPIC_0000001099150888__ad705af1d19354834bc86103cac912bcc"><a name="EN-US_TOPIC_0000001099150888__l9e43f96437c64ff1884b5fe387bb8c7a"></a><a name="l9e43f96437c64ff1884b5fe387bb8c7a"></a>Description: Specifies whether an array contains another.</p>
<p id="EN-US_TOPIC_0000001099150888__a3287b9a073cb4e118cbd0b20a441fefc">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s331eecec82fa41c8b1a9aa8f7fff351f"><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">ARRAY</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">4</span><span class="p">,</span><span class="mi">3</span><span class="p">]</span><span class="w"> </span><span class="o">@&gt;</span><span class="w"> </span><span class="nb">ARRAY</span><span class="p">[</span><span class="mi">3</span><span class="p">,</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="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__l73fdd603fc644f47a5032a03d8d68c46">&lt;@<p id="EN-US_TOPIC_0000001099150888__a02291832c4d54980a5e1f3555ffb2994"><a name="EN-US_TOPIC_0000001099150888__l73fdd603fc644f47a5032a03d8d68c46"></a><a name="l73fdd603fc644f47a5032a03d8d68c46"></a>Description: Specifies whether an array is contained in another.</p>
<p id="EN-US_TOPIC_0000001099150888__ac98d2ac7ee8446138bc4bcab7350d5c0">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s508b85d479184a2cb7f18efe484af096"><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">ARRAY</span><span class="p">[</span><span class="mi">2</span><span class="p">,</span><span class="mi">7</span><span class="p">]</span><span class="w"> </span><span class="o">&lt;@</span><span class="w"> </span><span class="nb">ARRAY</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">7</span><span class="p">,</span><span class="mi">4</span><span class="p">,</span><span class="mi">2</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="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__l589832191c2a47688b55122e9ca3ee6a">&amp;&amp;<p id="EN-US_TOPIC_0000001099150888__ae31a9b8958c6442fbfcc4297d7f1740c"><a name="EN-US_TOPIC_0000001099150888__l589832191c2a47688b55122e9ca3ee6a"></a><a name="l589832191c2a47688b55122e9ca3ee6a"></a>Description: Specifies whether an array overlaps another (have common elements).</p>
<p id="EN-US_TOPIC_0000001099150888__aa32463e2ce5a44eda25b3dc104814363">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__sede2813fb31749c398434c73356a7b49"><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">ARRAY</span><span class="p">[</span><span class="mi">1</span><span class="p">,</span><span class="mi">4</span><span class="p">,</span><span class="mi">3</span><span class="p">]</span><span class="w"> </span><span class="o">&amp;&amp;</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">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="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__lbea220e3e90648aa8f88a45cfd3426e4">||<p id="EN-US_TOPIC_0000001099150888__a79c2333bf2044e16bb1086054046501a"><a name="EN-US_TOPIC_0000001099150888__lbea220e3e90648aa8f88a45cfd3426e4"></a><a name="lbea220e3e90648aa8f88a45cfd3426e4"></a>Description: Array-to-array concatenation</p>
<p id="EN-US_TOPIC_0000001099150888__a05ef3b151c0445789f3284efc0316de1">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s1e4b07bfd0ba4e62b929fb5d4b0b4e7f"><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">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="o">||</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="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="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="p">,</span><span class="mi">6</span><span class="err">}</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s15c76363f25b4e8db9ba28135b86e82d"><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">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="o">||</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="mi">6</span><span class="p">],[</span><span class="mi">7</span><span class="p">,</span><span class="mi">8</span><span class="p">,</span><span class="mi">9</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="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="err">{</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="err">}</span><span class="p">,</span><span class="err">{</span><span class="mi">7</span><span class="p">,</span><span class="mi">8</span><span class="p">,</span><span class="mi">9</span><span class="err">}}</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__laa90c0929b0c4ca8badf146d9669e007">||<p id="EN-US_TOPIC_0000001099150888__a182b15cf2ebf4b27adeae26120cd9237"><a name="EN-US_TOPIC_0000001099150888__laa90c0929b0c4ca8badf146d9669e007"></a><a name="laa90c0929b0c4ca8badf146d9669e007"></a>Description: Element-to-array concatenation</p>
<p id="EN-US_TOPIC_0000001099150888__a4304073fcb6c4230aa1c39f1ac5cf0f4">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s9cd724a1aea142369997c2f0017be628"><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="mi">3</span><span class="w"> </span><span class="o">||</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="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="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">3</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="err">}</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__l3a55d33aec0049dcb5cad0d294a72fb9">||<p id="EN-US_TOPIC_0000001099150888__a9d909869f6eb4c30abbdfbbd42754586"><a name="EN-US_TOPIC_0000001099150888__l3a55d33aec0049dcb5cad0d294a72fb9"></a><a name="l3a55d33aec0049dcb5cad0d294a72fb9"></a>Description: Array-to-element concatenation</p>
<p id="EN-US_TOPIC_0000001099150888__a3f594c5d8c8d42688710985c582a1b32">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__sc83cd94a082a4dcfb34fe2a4376e175d"><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">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="mi">6</span><span class="p">]</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="mi">7</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="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">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="mi">7</span><span class="err">}</span><span class="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<p id="EN-US_TOPIC_0000001099150888__a6a5ed8398b4144509ea26d324e1686d2">Array comparisons compare the array contents element-by-element, using the default B-tree comparison function for the element data type. In multidimensional arrays, the elements are accessed in row-major order. If the contents of two arrays are equal but the dimensionality is different, the first difference in the dimensionality information determines the sort order.</p>
<div class="section" id="EN-US_TOPIC_0000001099150888__s6e73bbaea63a4844b7e0c9207ff67dbf"><h4 class="sectiontitle">Array Functions</h4><ul id="EN-US_TOPIC_0000001099150888__u593a3848961c4b5fae9a017f1e8916b5"><li id="EN-US_TOPIC_0000001099150888__lddf2573db4d14b089a2acfe2b9944e41">array_append(anyarray, anyelement)<p id="EN-US_TOPIC_0000001099150888__a18befa664fe84b17b6e61441f763b5f6"><a name="EN-US_TOPIC_0000001099150888__lddf2573db4d14b089a2acfe2b9944e41"></a><a name="lddf2573db4d14b089a2acfe2b9944e41"></a>Description: Appends an element to the end of an array, and only supports dimension-1 arrays.</p>
<p id="EN-US_TOPIC_0000001099150888__abb75bd0c63f14efabdc873afdd7d2695">Return type: anyarray</p>
<p id="EN-US_TOPIC_0000001099150888__a7e1830be437a49b88fd0328d679ce10d">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__saa4d445d36d445ea94f865da1e904aec"><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="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="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__l4bf1f5db81dc4a39b68b409e5abd50c3">array_prepend(anyelement, anyarray)<p id="EN-US_TOPIC_0000001099150888__afeec27871b384948b97ce2bd6e4e7eed"><a name="EN-US_TOPIC_0000001099150888__l4bf1f5db81dc4a39b68b409e5abd50c3"></a><a name="l4bf1f5db81dc4a39b68b409e5abd50c3"></a>Description: Appends an element to the beginning of an array, and only supports dimension-1 arrays.</p>
<p id="EN-US_TOPIC_0000001099150888__ab9523c0ed2774a2680cf65f28bf98ce6">Return type: anyarray</p>
<p id="EN-US_TOPIC_0000001099150888__a479a9ff1baee491c80c67a45379bfe79">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s95e4d0a866004a44a4970544b56afe01"><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="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="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__la621e0233abf42a88afd862a9515021a">array_cat(anyarray, anyarray)<p id="EN-US_TOPIC_0000001099150888__a0e157dd329f44e6e8833968a10713eb8"><a name="EN-US_TOPIC_0000001099150888__la621e0233abf42a88afd862a9515021a"></a><a name="la621e0233abf42a88afd862a9515021a"></a>Description: Concatenates two arrays, and supports multi-dimensional arrays.</p>
<p id="EN-US_TOPIC_0000001099150888__a84c380792e174cb1b8329f9e11082151">Return type: anyarray</p>
<p id="EN-US_TOPIC_0000001099150888__abf265b039b7847dd859a7beea835a108">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s10d89264efcc427ba6e9dcb754665d96"><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="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="w"></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="w"></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="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="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__lfcd8d808c9684327bce9cc22e752aec8">array_ndims(anyarray)<p id="EN-US_TOPIC_0000001099150888__adfd854d1d94347eb9cb5d68aab8c0b7d"><a name="EN-US_TOPIC_0000001099150888__lfcd8d808c9684327bce9cc22e752aec8"></a><a name="lfcd8d808c9684327bce9cc22e752aec8"></a>Description: Returns the number of dimensions of the array.</p>
<p id="EN-US_TOPIC_0000001099150888__a75c05eb4ab5f4541b123ad3a95382083">Return type: int</p>
<p id="EN-US_TOPIC_0000001099150888__ac01fbae9b0184b488c61c32dcff52fe6">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s828536a580e14f53b780b80f45ea63cb"><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="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="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__lcebde0aeef58401d9efa990ca46ead13">array_dims(anyarray)<p id="EN-US_TOPIC_0000001099150888__a87aa6ee8b2214c19938bd97b77b7a01a"><a name="EN-US_TOPIC_0000001099150888__lcebde0aeef58401d9efa990ca46ead13"></a><a name="lcebde0aeef58401d9efa990ca46ead13"></a>Description: Returns a text representation of array's dimensions.</p>
<p id="EN-US_TOPIC_0000001099150888__a84a2731474ea43da94efb92deb673719">Return type: text</p>
<p id="EN-US_TOPIC_0000001099150888__a35cf9f010b224c7f92b8b67836c23013">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s8508fcae5eb94f61bbe44f1ad872a59f"><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="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="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__laa37510d1fe943fcae575bd6baa7bdc2">array_length(anyarray, int)<p id="EN-US_TOPIC_0000001099150888__a62c46b47905f4137a227adfc782570da"><a name="EN-US_TOPIC_0000001099150888__laa37510d1fe943fcae575bd6baa7bdc2"></a><a name="laa37510d1fe943fcae575bd6baa7bdc2"></a>Description: Returns the length of the requested array dimension.</p>
<p id="EN-US_TOPIC_0000001099150888__a442bd8de704e40d9939a2e4e6458fd84">Return type: int</p>
<p id="EN-US_TOPIC_0000001099150888__ab24eec2b23574233adef5cf1217966da">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s02cf8b9375014cef899e701315548c6c"><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="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="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__l93b52f2eb2494583b3331edabac5a3e9">array_lower(anyarray, int)<p id="EN-US_TOPIC_0000001099150888__a7f8f5df612f748519a2855c143ebdf44"><a name="EN-US_TOPIC_0000001099150888__l93b52f2eb2494583b3331edabac5a3e9"></a><a name="l93b52f2eb2494583b3331edabac5a3e9"></a>Description: Returns lower bound of the requested array dimension.</p>
<p id="EN-US_TOPIC_0000001099150888__a3066980f85914ec58391fe13a8fa24f5">Return type: int</p>
<p id="EN-US_TOPIC_0000001099150888__ad4eefb0cbc7c4aa0aeb43ec39bbd081a">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s02f297c2fa554da9ab1ae26a2d40e523"><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="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="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__l855f29d3c36e4c7fabf59a5f9b5490d1">array_upper(anyarray, int)<p id="EN-US_TOPIC_0000001099150888__ac090bdb9587c4a6aabf2ea0e3679c3f8"><a name="EN-US_TOPIC_0000001099150888__l855f29d3c36e4c7fabf59a5f9b5490d1"></a><a name="l855f29d3c36e4c7fabf59a5f9b5490d1"></a>Description: Returns upper bound of the requested array dimension.</p>
<p id="EN-US_TOPIC_0000001099150888__a0bdd8be3a6f141918326b83635f798fc">Return type: int</p>
<p id="EN-US_TOPIC_0000001099150888__ac5cb7dad2ebd41a1aa972a4cc4b770e1">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__scff4ce858bfc4cb3904f548fd608f964"><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="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="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__la9cc682a31694431b668eb8293985bbc">array_to_string(anyarray, text [, text])<p id="EN-US_TOPIC_0000001099150888__ae546b8ebe8a44a75b9a3654e0ec3a352"><a name="EN-US_TOPIC_0000001099150888__la9cc682a31694431b668eb8293985bbc"></a><a name="la9cc682a31694431b668eb8293985bbc"></a>Description: Uses the first <strong id="EN-US_TOPIC_0000001099150888__b84235270617226">text</strong> as the new delimiter and the second <strong id="EN-US_TOPIC_0000001099150888__b84235270617250">text</strong> to replace <strong id="EN-US_TOPIC_0000001099150888__b20592526115714">NULL</strong> values.</p>
<p id="EN-US_TOPIC_0000001099150888__af715b788ff9f4da7a3fa5b3e35bfefad">Return type: text</p>
<p id="EN-US_TOPIC_0000001099150888__ae88d26d5df654a23aa8c46e039be3da5">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__s01bed07e27344f8d9b1a719dc6ad4d08"><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="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="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__lebc83b04e36744ca9d5693dcb13ef9b7">string_to_array(text, text [, text])<p id="EN-US_TOPIC_0000001099150888__p1198415418537"><a name="EN-US_TOPIC_0000001099150888__lebc83b04e36744ca9d5693dcb13ef9b7"></a><a name="lebc83b04e36744ca9d5693dcb13ef9b7"></a>Description: Uses the second <strong id="EN-US_TOPIC_0000001099150888__b15557151311222">text</strong> as the new delimiter and the third <strong id="EN-US_TOPIC_0000001099150888__b1444901710318">text</strong> as the substring to be replaced by <strong id="EN-US_TOPIC_0000001099150888__b6724851134911">NULL</strong> values. A substring can be replaced by <strong id="EN-US_TOPIC_0000001099150888__b7531112501">NULL</strong> values only when it is the same as the third <strong id="EN-US_TOPIC_0000001099150888__b16389553125918">text</strong>.</p>
<p id="EN-US_TOPIC_0000001099150888__a361fc05615f046c289a113c689211000">Return type: text[]</p>
<p id="EN-US_TOPIC_0000001099150888__a2e21749971fb46b883ba54592d1dbb66">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__sa1ea7b692e78451ea5abbf867a78ea44"><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="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="w"></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="w"></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="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="w"></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="w"></span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001099150888__l7a33944ccbd345bc9951e891b0e1dda2">unnest(anyarray)<p id="EN-US_TOPIC_0000001099150888__a4620bbb128f548e28a18229c078eab0a"><a name="EN-US_TOPIC_0000001099150888__l7a33944ccbd345bc9951e891b0e1dda2"></a><a name="l7a33944ccbd345bc9951e891b0e1dda2"></a>Description: Expands an array to a set of rows.</p>
<p id="EN-US_TOPIC_0000001099150888__a08d374ca0da2404d86e2a6d1e3a8a715">Return type: setof anyelement</p>
<p id="EN-US_TOPIC_0000001099150888__ab52307f767f8455992e31d164a8ca464">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001099150888__sd64cfe8b5bba43569813ae8776049a41"><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="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="w"> </span><span class="mi">2</span><span class="w"></span>
<span class="p">(</span><span class="mi">2</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<p id="EN-US_TOPIC_0000001099150888__aed8d05c59d6145ea95edb66f9140d0cb">In <strong id="EN-US_TOPIC_0000001099150888__b842352706101929">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>
<p id="EN-US_TOPIC_0000001099150888__a8a00a5a315344f1d98f56cb70190d4cc">In <strong id="EN-US_TOPIC_0000001099150888__b842352706102048">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_0000001099150888__a83e2c552273347e68ed444a42d2bbc55">In <strong id="EN-US_TOPIC_0000001099150888__b842352706102155">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 class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0027.html">Functions and Operators</a></div>
</div>
</div>
View Git Blame Copy Permalink