vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/tool/dws_mt_0137.html
Lu, Huayi 27019c2991 DWS TOOL 830.201 version 
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
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:35:25 +00:00

223 lines
40 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001772536612"></a><a name="EN-US_TOPIC_0000001772536612"></a>
<h1 class="topictitle1">String Functions</h1>
<div id="body8662426"><p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p1314323315110">This section describes the following string functions:</p>
<ul id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_ul14646237318"><li id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_li764613373111"><a href="#EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section19572182825420">LISTAGG</a></li><li id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_li14921194220117"><a href="#EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section1645916521546">STRAGG</a></li><li id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_li136842047113"><a href="#EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section266693805512">WM_CONCAT</a></li><li id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_li62821952612"><a href="#EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section11995195695518">NVL2 and REPLACE</a></li><li id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_li2917114724"><a href="#EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section866063713564">QUOTE</a></li></ul>
<div class="section" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section19572182825420"><a name="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section19572182825420"></a><a name="en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section19572182825420"></a><h4 class="sectiontitle">LISTAGG</h4><p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p1349391614404"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b42351215163759">LISTAGG</strong> is used to order data in columns within each group specified in the <strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b93691969578">ORDER BY</strong> clause and concatenates the order results.</p>
<div class="fignone" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_fig42932995202534"><span class="figcap"><b>Figure 1 </b>Input - Listagg</span><br><span><img id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_image55020556202534" src="figure/en-us_image_0000001658025274.png"></span></div>
<div class="fignone" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_fig27480050202534"><span class="figcap"><b>Figure 2 </b>Output - Listagg</span><br><span><img id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_image11291548202534" src="figure/en-us_image_0000001706105385.png"></span></div>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p286914517540">LISTAGG can be migrated after <strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b165948914193">MigSupportForListAgg </strong>is set to <strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b75941692196">false</strong>.</p>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p7870051195415"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b20996175915317">Input- LISTAGG</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_screen8870751155412"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">LISTAGG</span><span class="p">(</span><span class="n">BRANCH_ID</span><span class="p">,</span><span class="w"> </span><span class="s1">','</span><span class="p">)</span><span class="w"> </span><span class="n">WITHIN</span><span class="w"> </span><span class="k">GROUP</span><span class="p">(</span><span class="k">ORDER</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="n">AREA_ORDER</span><span class="p">)</span><span class="w"> </span><span class="n">PRODUCTRANGE</span>
<span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="p">(</span><span class="k">SELECT</span><span class="w"> </span><span class="k">DISTINCT</span><span class="w"> </span><span class="n">VB</span><span class="p">.</span><span class="n">BRANCH_ID</span><span class="p">,</span>
<span class="w"> </span><span class="n">VB</span><span class="p">.</span><span class="n">VER_ID</span><span class="p">,</span>
<span class="w"> </span><span class="n">VB</span><span class="p">.</span><span class="n">AREA_ORDER</span>
<span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">SPMS_VERSION_BRANCH</span><span class="w"> </span><span class="n">VB</span><span class="p">,</span><span class="w"> </span><span class="n">SPMS_NODE_SET</span><span class="w"> </span><span class="n">NS</span>
<span class="w"> </span><span class="k">WHERE</span><span class="w"> </span><span class="n">VB</span><span class="p">.</span><span class="n">BRANCH_TYPE</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="p">(</span><span class="s1">'1'</span><span class="p">,</span><span class="w"> </span><span class="s1">'3'</span><span class="p">)</span>
<span class="w"> </span><span class="k">AND</span><span class="w"> </span><span class="n">VB</span><span class="p">.</span><span class="n">AGENCY_BRANCH</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">NS</span><span class="p">.</span><span class="n">BRANCH_ID</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p14870051135412"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b7997759115317">Output</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_screen5870751125419"><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>
<span class="normal">12</span>
<span class="normal">13</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">LISTAGG</span><span class="w"> </span><span class="p">(</span><span class="n">BRANCH_ID</span><span class="p">,</span><span class="s1">','</span><span class="p">)</span><span class="w"> </span><span class="n">WITHIN</span><span class="w"> </span><span class="k">GROUP</span><span class="w"> </span><span class="p">(</span>
<span class="w"> </span><span class="k">ORDER</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="n">AREA_ORDER</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="n">PRODUCTRANGE</span>
<span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="k">SELECT</span>
<span class="w"> </span><span class="k">DISTINCT</span><span class="w"> </span><span class="n">VB</span><span class="p">.</span><span class="n">BRANCH_ID</span>
<span class="w"> </span><span class="p">,</span><span class="n">VB</span><span class="p">.</span><span class="n">VER_ID</span>
<span class="w"> </span><span class="p">,</span><span class="n">VB</span><span class="p">.</span><span class="n">AREA_ORDER</span>
<span class="w"> </span><span class="k">FROM</span>
<span class="w"> </span><span class="n">SPMS_VERSION_BRANCH</span><span class="w"> </span><span class="n">VB</span>
<span class="w"> </span><span class="p">,</span><span class="n">SPMS_NODE_SET</span><span class="w"> </span><span class="n">NS</span>
<span class="w"> </span><span class="k">WHERE</span><span class="w"> </span><span class="n">VB</span><span class="p">.</span><span class="n">BRANCH_TYPE</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="p">(</span>
<span class="w"> </span><span class="s1">'1'</span><span class="p">,</span><span class="s1">'3'</span><span class="p">)</span>
<span class="w"> </span><span class="k">AND</span><span class="w"> </span><span class="n">VB</span><span class="p">.</span><span class="n">AGENCY_BRANCH</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">NS</span><span class="p">.</span><span class="n">BRANCH_ID</span><span class="p">)</span>
<span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section1645916521546"><a name="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section1645916521546"></a><a name="en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section1645916521546"></a><h4 class="sectiontitle">STRAGG</h4><p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p44023661222650"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b1026774012710">STRAGG</strong> is a string aggregate function used to collect values from multiple rows into a comma-separated string.</p>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p117110112117"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_b1315203317208"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_b1315183342015">Input-</strong>STRAGG</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_screen1471408213"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">DEPTNO</span><span class="p">,</span><span class="n">ENAME</span><span class="p">,</span><span class="n">STRAGG</span><span class="p">(</span><span class="n">ename</span><span class="p">)</span><span class="w"> </span><span class="n">over</span><span class="w"> </span><span class="p">(</span><span class="n">partition</span><span class="w"> </span><span class="k">by</span><span class="w"> </span><span class="n">deptno</span><span class="w"> </span><span class="k">order</span><span class="w"> </span><span class="k">by</span>
<span class="w"> </span><span class="n">ename</span><span class="w"> </span><span class="n">RANGE</span><span class="w"> </span><span class="k">BETWEEN</span><span class="w"> </span><span class="n">UNBOUNDED</span><span class="w"> </span><span class="n">PRECEDING</span><span class="w"> </span><span class="k">AND</span><span class="w"> </span><span class="n">UNBOUNDED</span><span class="w"> </span><span class="n">FOLLOWING</span><span class="p">)</span><span class="w"> </span>
<span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="n">ENAME_STR</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">EMP</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p771707214"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_b208657485">Output</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_screen4715022110"><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="n">DEPTNO</span><span class="p">,</span><span class="n">ENAME</span><span class="p">,</span><span class="n">STRING_AGG</span><span class="w"> </span><span class="p">(</span>
<span class="w"> </span><span class="n">ename</span><span class="p">,</span><span class="s1">','</span><span class="p">)</span><span class="w"> </span><span class="n">over</span><span class="p">(</span><span class="w"> </span><span class="n">partition</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="n">deptno</span><span class="w"> </span><span class="k">ORDER</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span>
<span class="w"> </span><span class="n">ename</span><span class="w"> </span><span class="n">RANGE</span><span class="w"> </span><span class="k">BETWEEN</span><span class="w"> </span><span class="n">UNBOUNDED</span><span class="w"> </span><span class="n">PRECEDING</span><span class="w"> </span><span class="k">AND</span><span class="w"> </span><span class="n">UNBOUNDED</span><span class="w"> </span>
<span class="w"> </span><span class="n">FOLLOWING</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="n">ENAME_STR</span>
<span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">EMP</span>
<span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section266693805512"><a name="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section266693805512"></a><a name="en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section266693805512"></a><h4 class="sectiontitle">WM_CONCAT</h4><p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p26788861222559"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b64913096163754">WM_CONCAT</strong> is used to aggregate data from a number of rows into a single row, giving a list of data associated with a specific value.</p>
<div class="fignone" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_fig26866048202739"><span class="figcap"><b>Figure 3 </b>Input - WM_Concat</span><br><span><img id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_image28666250202739" src="figure/en-us_image_0000001706224629.png"></span></div>
<div class="fignone" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_fig40264896202739"><span class="figcap"><b>Figure 4 </b>Output - WM_Concat</span><br><span><img id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_image40231180202739" src="figure/en-us_image_0000001657865950.png"></span></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section11995195695518"><a name="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section11995195695518"></a><a name="en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section11995195695518"></a><h4 class="sectiontitle">NVL2 and REPLACE</h4><p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p5453750614596"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b1272151205212">NVL2</strong>( expression, value1, value2) is a function used to determine the value returned by a query based on whether a specified expression is null or not. If the expression is not null, then NVL2 returns value1. If the expression is null, then NVL2 returns value2.</p>
</div>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p568125110123"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_b15445408212">Input - <strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_b184459092118">NVL2</strong></strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_screen197065112126"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">NVL2</span><span class="p">(</span><span class="n">Expr1</span><span class="p">,</span><span class="w"> </span><span class="n">Expr2</span><span class="p">,</span><span class="w"> </span><span class="n">Expr3</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p872105191215"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b115307271387">Output</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_screen197605161218"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">DECODE</span><span class="p">(</span><span class="n">Expr1</span><span class="p">,</span><span class="w"> </span><span class="k">NULL</span><span class="p">,</span><span class="w"> </span><span class="n">Expr3</span><span class="p">,</span><span class="w"> </span><span class="n">Expr2</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p1879951161219">The <strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b8198526162011">REPLACE </strong>function is used to return char with every occurrence of search_string replaced with replacement_string. If replacement_string is omitted or null, then all occurrences of search_string are removed.</p>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p579851121214">The <strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_b168714715469">REPLACE</strong> function in Oracle contains two mandatory parameters and one optional parameter. The <strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_b10206187194710">REPLACE</strong> function in <span id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_text1958020141713">GaussDB(DWS)</span> contains three mandatory parameters.</p>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p883251181212"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b111191559111014">Input - Nested <strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b101192596108">REPLACE</strong></strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_screen6119115961010"><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">CREATE</span>
<span class="w"> </span><span class="k">OR</span><span class="w"> </span><span class="k">REPLACE</span><span class="w"> </span><span class="k">FUNCTION</span><span class="w"> </span><span class="n">F_REPLACE_COMMA</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">IS_STR</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="n">VARCHAR2</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="k">RETURN</span><span class="w"> </span><span class="n">VARCHAR2</span><span class="w"> </span><span class="k">IS</span><span class="w"> </span><span class="k">BEGIN</span>
<span class="w"> </span><span class="k">IF</span>
<span class="w"> </span><span class="n">IS_STR</span><span class="w"> </span><span class="k">IS</span><span class="w"> </span><span class="k">NULL</span>
<span class="w"> </span><span class="k">THEN</span><span class="w"> </span><span class="k">RETURN</span><span class="w"> </span><span class="k">NULL</span><span class="w"> </span><span class="p">;</span>
<span class="w"> </span><span class="k">ELSE</span>
<span class="w"> </span><span class="k">RETURN</span><span class="w"> </span><span class="k">REPLACE</span><span class="p">(</span><span class="w"> </span><span class="k">REPLACE</span><span class="p">(</span><span class="w"> </span><span class="n">IS_STR</span><span class="w"> </span><span class="p">,</span><span class="s1">'a'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="n">CHR</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="mi">10</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">;</span>
<span class="w"> </span><span class="k">END</span><span class="w"> </span><span class="k">IF</span><span class="w"> </span><span class="p">;</span>
<span class="k">END</span><span class="w"> </span><span class="n">F_REPLACE_COMMA</span><span class="w"> </span><span class="p">;</span>
<span class="o">/</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p812235971014"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b13122175911103">Output</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_screen16122185918108"><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">CREATE</span>
<span class="w"> </span><span class="k">OR</span><span class="w"> </span><span class="k">REPLACE</span><span class="w"> </span><span class="k">FUNCTION</span><span class="w"> </span><span class="n">F_REPLACE_COMMA</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">IS_STR</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="n">VARCHAR2</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="k">RETURN</span><span class="w"> </span><span class="n">VARCHAR2</span><span class="w"> </span><span class="k">IS</span><span class="w"> </span><span class="k">BEGIN</span>
<span class="w"> </span><span class="k">IF</span>
<span class="w"> </span><span class="n">IS_STR</span><span class="w"> </span><span class="k">IS</span><span class="w"> </span><span class="k">NULL</span>
<span class="w"> </span><span class="k">THEN</span><span class="w"> </span><span class="k">RETURN</span><span class="w"> </span><span class="k">NULL</span><span class="w"> </span><span class="p">;</span>
<span class="w"> </span><span class="k">ELSE</span>
<span class="w"> </span><span class="k">RETURN</span><span class="w"> </span><span class="k">REPLACE</span><span class="p">(</span><span class="w"> </span><span class="k">REPLACE</span><span class="p">(</span><span class="w"> </span><span class="n">IS_STR</span><span class="w"> </span><span class="p">,</span><span class="s1">'a'</span><span class="w"> </span><span class="p">,</span><span class="s1">''</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="n">CHR</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="mi">10</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="s1">''</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">;</span>
<span class="w"> </span><span class="k">END</span><span class="w"> </span><span class="k">IF</span><span class="w"> </span><span class="p">;</span>
<span class="k">end</span><span class="w"> </span><span class="p">;</span>
<span class="o">/</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p191823519129"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b19763132114140">Input - More than one <strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b476311216141">REPLACE</strong></strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_screen618915518128"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span>
<span class="w"> </span><span class="k">REPLACE</span><span class="p">(</span><span class="w"> </span><span class="s1">'JACK and JUE'</span><span class="w"> </span><span class="p">,</span><span class="s1">'J'</span><span class="p">,</span><span class="w"> </span><span class="s1">''</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="ss">&quot;Changes&quot;</span>
<span class="w"> </span><span class="p">,</span><span class="k">REPLACE</span><span class="p">(</span><span class="w"> </span><span class="s1">'JACK1 and JUE'</span><span class="w"> </span><span class="p">,</span><span class="s1">'J'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="ss">&quot;Changes1&quot;</span>
<span class="w"> </span><span class="p">,</span><span class="k">REPLACE</span><span class="p">(</span><span class="w"> </span><span class="s1">'JACK2 and JUE'</span><span class="w"> </span><span class="p">,</span><span class="s1">'J'</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="ss">&quot;Changes2&quot;</span>
<span class="w"> </span><span class="k">FROM</span>
<span class="w"> </span><span class="n">DUAL</span>
<span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p13199145151215"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b1078342118145">Output</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_screen15202551191216"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span>
<span class="w"> </span><span class="k">REPLACE</span><span class="p">(</span><span class="w"> </span><span class="s1">'JACK and JUE'</span><span class="w"> </span><span class="p">,</span><span class="s1">'J'</span><span class="w"> </span><span class="p">,</span><span class="s1">''</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="ss">&quot;Changes&quot;</span>
<span class="w"> </span><span class="p">,</span><span class="k">REPLACE</span><span class="p">(</span><span class="w"> </span><span class="s1">'JACK1 and JUE'</span><span class="w"> </span><span class="p">,</span><span class="s1">'J'</span><span class="w"> </span><span class="p">,</span><span class="s1">''</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="ss">&quot;Changes1&quot;</span>
<span class="w"> </span><span class="p">,</span><span class="k">REPLACE</span><span class="p">(</span><span class="w"> </span><span class="s1">'JACK2 and JUE'</span><span class="w"> </span><span class="p">,</span><span class="s1">'J'</span><span class="w"> </span><span class="p">,</span><span class="s1">''</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="ss">&quot;Changes2&quot;</span>
<span class="w"> </span><span class="k">FROM</span>
<span class="w"> </span><span class="n">DUAL</span>
<span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p1521235161215"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b5683131771613">Input - <strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b1768421716162">REPLACE</strong></strong><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b340893416162"> with Three parameters</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_screen821710517120"><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="k">REPLACE</span><span class="p">(</span><span class="w"> </span><span class="s1">'123tech123'</span><span class="w"> </span><span class="p">,</span><span class="s1">'123'</span><span class="p">,</span><span class="w"> </span><span class="s1">'1'</span><span class="p">)</span>
<span class="w"> </span><span class="k">FROM</span>
<span class="w"> </span><span class="n">dual</span>
<span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p169420001537"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_b1295405665">Output</strong></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_screen301247461537"><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="k">REPLACE</span><span class="p">(</span><span class="w"> </span><span class="s1">'123tech123'</span><span class="w"> </span><span class="p">,</span><span class="s1">'123'</span><span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="s1">'1'</span><span class="w"> </span><span class="p">)</span>
<span class="w"> </span><span class="k">FROM</span>
<span class="w"> </span><span class="n">dual</span>
<span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section866063713564"><a name="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section866063713564"></a><a name="en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_section866063713564"></a><h4 class="sectiontitle">QUOTE</h4><p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p18964659221627"><strong id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0237712489_b60034685174416">QUOTE</strong> allows the user to embed single-quotes in literal strings without having to resort to double quotes. That is, you can use single quotes to specify a literal string.</p>
<p id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_p103801939135812">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_screen18442738174435"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">q</span><span class="s1">'[I'</span><span class="n">m</span><span class="w"> </span><span class="k">using</span><span class="w"> </span><span class="n">quote</span><span class="w"> </span><span class="k">operator</span><span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="k">SQL</span><span class="w"> </span><span class="k">statement</span><span class="p">]</span><span class="err">'</span><span class="w"> </span><span class="ss">&quot;Quote (q) Operator&quot;</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">dual</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<div class="fignone" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_fig38044913203010"><span class="figcap"><b>Figure 5 </b>Input - Quote</span><br><span><img id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_image61739150203010" src="figure/en-us_image_0000001657865946.png"></span></div>
<div class="fignone" id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_fig34815243203010"><span class="figcap"><b>Figure 6 </b>Output - Quote</span><br><span><img id="EN-US_TOPIC_0000001772536612__en-us_topic_0000001706224237_en-us_topic_0238518398_en-us_topic_0237362203_en-us_topic_0202727281_image40743791111347" src="figure/en-us_image_0000001706105389.png"></span></div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_mt_0133.html">System Functions</a></div>
</div>
</div>
View Git Blame Copy Permalink