vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/dev/dws_06_0067.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

389 lines
56 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001145910847"></a><a name="EN-US_TOPIC_0000001145910847"></a>
<h1 class="topictitle1">XML Functions</h1>
<div id="body1597307016136"><div class="section" id="EN-US_TOPIC_0000001145910847__section173086132256"><h4 class="sectiontitle">Generating XML Content</h4><ul id="EN-US_TOPIC_0000001145910847__ul14646208114210"><li id="EN-US_TOPIC_0000001145910847__li36479810423">XMLPARSE ( { DOCUMENT | CONTENT } <em id="EN-US_TOPIC_0000001145910847__i1628825164212">value</em>)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p9299230204212">Description: Generates an XML value from character data.</p>
<p id="EN-US_TOPIC_0000001145910847__p05845154217">Return type: XML</p>
<p id="EN-US_TOPIC_0000001145910847__p593434519441">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen8671747191910"><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">xmlparse</span><span class="p">(</span><span class="n">document</span><span class="w"> </span><span class="s1">'&lt;foo&gt;bar&lt;/foo&gt;'</span><span class="p">);</span><span class="w"></span>
<span class="n">xmlparse</span><span class="w"></span>
<span class="c1">----------------</span>
<span class="o">&lt;</span><span class="n">foo</span><span class="o">&gt;</span><span class="n">bar</span><span class="o">&lt;/</span><span class="n">foo</span><span class="o">&gt;</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>
<ul id="EN-US_TOPIC_0000001145910847__ul9819193210449"><li id="EN-US_TOPIC_0000001145910847__li88191032144411">XMLSERIALIZE ( { DOCUMENT | CONTENT } value AS type</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p14292225174912">Description: Generates a string from XML values.</p>
<p id="EN-US_TOPIC_0000001145910847__p108321758154912">Return type: type, which can be character, character varying, or text (or its alias)</p>
<p id="EN-US_TOPIC_0000001145910847__p122081447165813">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen1393591683910"><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">xmlserialize</span><span class="p">(</span><span class="n">content</span><span class="w"> </span><span class="s1">'good'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="nb">CHAR</span><span class="p">(</span><span class="mi">10</span><span class="p">));</span><span class="w"></span>
<span class="n">xmlserialize</span><span class="w"></span>
<span class="c1">--------------</span>
<span class="n">good</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>
<ul id="EN-US_TOPIC_0000001145910847__ul1142819512553"><li id="EN-US_TOPIC_0000001145910847__li1942875175511">xmlcomment(text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p13229733185514">Description: Creates an XML note that uses the specified text as the content. The text cannot contain two consecutive hyphens (--) or end with a hyphen (-). If the parameter is null, the result is also null.</p>
<p id="EN-US_TOPIC_0000001145910847__p852882816576">Return type: XML</p>
<p id="EN-US_TOPIC_0000001145910847__p1984334545711">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen58061034132013"><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">xmlcomment</span><span class="p">(</span><span class="s1">'hello'</span><span class="p">);</span><span class="w"></span>
<span class="n">xmlcomment</span><span class="w"></span>
<span class="c1">--------------</span>
<span class="o">&lt;!</span><span class="c1">--hello--&gt;</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>
<ul id="EN-US_TOPIC_0000001145910847__ul135957177519"><li id="EN-US_TOPIC_0000001145910847__li25959179518">xmlconcat(xml[, ...])</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p1740915111520">Description: Concatenates a list of XML values into a single value. Null values are ignored. If all parameters are null, the result is also null.</p>
<p id="EN-US_TOPIC_0000001145910847__p1729184014719">Return type: XML</p>
<p id="EN-US_TOPIC_0000001145910847__p1895217511276">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen18543149102017"><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">xmlconcat</span><span class="p">(</span><span class="s1">'&lt;abc/&gt;'</span><span class="p">,</span><span class="w"> </span><span class="s1">'&lt;bar&gt;foo&lt;/bar&gt;'</span><span class="p">);</span><span class="w"></span>
<span class="n">xmlconcat</span><span class="w"></span>
<span class="c1">----------------------</span>
<span class="o">&lt;</span><span class="n">abc</span><span class="o">/&gt;&lt;</span><span class="n">bar</span><span class="o">&gt;</span><span class="n">foo</span><span class="o">&lt;/</span><span class="n">bar</span><span class="o">&gt;</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>
<p id="EN-US_TOPIC_0000001145910847__p8372102591111">Note: If XML declarations exist and they are the same XML version, the result will use the version. Otherwise, the result does not use any version. If all XML values have the <strong id="EN-US_TOPIC_0000001145910847__b585013216814">standalone</strong> attribute whose status is <strong id="EN-US_TOPIC_0000001145910847__b975815541010">yes</strong>, the <strong id="EN-US_TOPIC_0000001145910847__b6673011109">standalone</strong> attribute in the result is <strong id="EN-US_TOPIC_0000001145910847__b19051644181016">yes</strong>. If at least one XML value's <strong id="EN-US_TOPIC_0000001145910847__b95751416151119">standalone</strong> attribute is <strong id="EN-US_TOPIC_0000001145910847__b126642319114">no</strong>, the <strong id="EN-US_TOPIC_0000001145910847__b1721153621113">standalone</strong> attribute in the result is <strong id="EN-US_TOPIC_0000001145910847__b47424991113">no</strong>. Otherwise, the result does not contain the <strong id="EN-US_TOPIC_0000001145910847__b112083771216">standalone</strong> attribute.</p>
<p id="EN-US_TOPIC_0000001145910847__p810212438816">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen8724145811208"><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">xmlconcat</span><span class="p">(</span><span class="s1">'&lt;?xml version=&quot;1.1&quot;?&gt;&lt;foo/&gt;'</span><span class="p">,</span><span class="w"> </span><span class="s1">'&lt;?xml version=&quot;1.1&quot; standalone=&quot;no&quot;?&gt;&lt;bar/&gt;'</span><span class="p">);</span><span class="w"></span>
<span class="n">xmlconcat</span><span class="w"></span>
<span class="c1">-----------------------------------</span>
<span class="o">&lt;?</span><span class="n">xml</span><span class="w"> </span><span class="k">version</span><span class="o">=</span><span class="ss">&quot;1.1&quot;</span><span class="o">?&gt;&lt;</span><span class="n">foo</span><span class="o">/&gt;&lt;</span><span class="n">bar</span><span class="o">/&gt;</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>
<ul id="EN-US_TOPIC_0000001145910847__ul12696820133"><li id="EN-US_TOPIC_0000001145910847__li369610241312">xmlelement(name name [, xmlattributes(value [AS attname] [, ... ])] [, content, ...])</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p890144317126">Description: Generates an XML element with the given name, attribute, and content.</p>
<p id="EN-US_TOPIC_0000001145910847__p1290110434122">Return type: XML</p>
<p id="EN-US_TOPIC_0000001145910847__p490164310125">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen11491184213"><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">xmlelement</span><span class="p">(</span><span class="n">name</span><span class="w"> </span><span class="n">foo</span><span class="p">,</span><span class="w"> </span><span class="n">xmlattributes</span><span class="p">(</span><span class="k">current_date</span><span class="w"> </span><span class="k">as</span><span class="w"> </span><span class="n">bar</span><span class="p">),</span><span class="w"> </span><span class="s1">'cont'</span><span class="p">,</span><span class="w"> </span><span class="s1">'ent'</span><span class="p">);</span><span class="w"></span>
<span class="n">xmlelement</span><span class="w"></span>
<span class="c1">-------------------------------------</span>
<span class="o">&lt;</span><span class="n">foo</span><span class="w"> </span><span class="n">bar</span><span class="o">=</span><span class="ss">&quot;2020-08-15&quot;</span><span class="o">&gt;</span><span class="n">content</span><span class="o">&lt;/</span><span class="n">foo</span><span class="o">&gt;</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>
<ul id="EN-US_TOPIC_0000001145910847__ul14935518191320"><li id="EN-US_TOPIC_0000001145910847__li29357186131">xmlforest(content [AS name] [, ...])</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p727292819244">Description: Generates an XML forest (sequence) of an element with a given name and content.</p>
<p id="EN-US_TOPIC_0000001145910847__p6901134316125">Return type: XML</p>
<p id="EN-US_TOPIC_0000001145910847__p99018432128">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen17506172642116"><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">xmlforest</span><span class="p">(</span><span class="s1">'abc'</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="n">foo</span><span class="p">,</span><span class="w"> </span><span class="mi">123</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="n">bar</span><span class="p">);</span><span class="w"></span>
<span class="n">xmlforest</span><span class="w"></span>
<span class="c1">------------------------------</span>
<span class="o">&lt;</span><span class="n">foo</span><span class="o">&gt;</span><span class="n">abc</span><span class="o">&lt;/</span><span class="n">foo</span><span class="o">&gt;&lt;</span><span class="n">bar</span><span class="o">&gt;</span><span class="mi">123</span><span class="o">&lt;/</span><span class="n">bar</span><span class="o">&gt;</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>
<ul id="EN-US_TOPIC_0000001145910847__ul14395331121318"><li id="EN-US_TOPIC_0000001145910847__li1039533115139">xmlpi(name target [, content])</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p1790164314120">Description: Creates an XML processing instruction. The content cannot contain the character sequence of <strong id="EN-US_TOPIC_0000001145910847__b7772305153">?&gt;</strong>.</p>
<p id="EN-US_TOPIC_0000001145910847__p6901543141212">Return type: XML</p>
<p id="EN-US_TOPIC_0000001145910847__p1390144321218">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen29873344213"><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">xmlpi</span><span class="p">(</span><span class="n">name</span><span class="w"> </span><span class="n">php</span><span class="p">,</span><span class="w"> </span><span class="s1">'echo &quot;hello world&quot;;'</span><span class="p">);</span><span class="w"></span>
<span class="n">xmlpi</span><span class="w"></span>
<span class="c1">-----------------------------</span>
<span class="o">&lt;?</span><span class="n">php</span><span class="w"> </span><span class="n">echo</span><span class="w"> </span><span class="ss">&quot;hello world&quot;</span><span class="p">;</span><span class="o">?&gt;</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>
<ul id="EN-US_TOPIC_0000001145910847__ul4780195319135"><li id="EN-US_TOPIC_0000001145910847__li1378095341315">xmlroot(xml, version text | no value [, standalone yes|no|no value])</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p16901134321215">Description: Modifies the attributes of the root node of an XML value. If a version is specified, it replaces the value in the version declaration of the root node. If a <strong id="EN-US_TOPIC_0000001145910847__b16388141901618">standalone</strong> value is specified, it replaces the <strong id="EN-US_TOPIC_0000001145910847__b116491341163">standalone</strong> value in the root node.</p>
<p id="EN-US_TOPIC_0000001145910847__p129011143121212">Return type: XML</p>
<p id="EN-US_TOPIC_0000001145910847__p179011643101218">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen101443433219"><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">xmlroot</span><span class="p">(</span><span class="n">xmlparse</span><span class="p">(</span><span class="n">document</span><span class="w"> </span><span class="s1">'&lt;?xml version=&quot;1.0&quot; standalone=&quot;no&quot;?&gt;&lt;content&gt;abc&lt;/content&gt;'</span><span class="p">),</span><span class="w"> </span><span class="k">version</span><span class="w"> </span><span class="s1">'1.1'</span><span class="p">,</span><span class="w"> </span><span class="n">standalone</span><span class="w"> </span><span class="n">yes</span><span class="p">);</span><span class="w"></span>
<span class="n">xmlroot</span><span class="w"></span>
<span class="c1">--------------------------------------------------------------</span>
<span class="o">&lt;?</span><span class="n">xml</span><span class="w"> </span><span class="k">version</span><span class="o">=</span><span class="ss">&quot;1.1&quot;</span><span class="w"> </span><span class="n">standalone</span><span class="o">=</span><span class="ss">&quot;yes&quot;</span><span class="o">?&gt;&lt;</span><span class="n">content</span><span class="o">&gt;</span><span class="n">abc</span><span class="o">&lt;/</span><span class="n">content</span><span class="o">&gt;</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>
<ul id="EN-US_TOPIC_0000001145910847__ul53141891149"><li id="EN-US_TOPIC_0000001145910847__li16314159171411">xmlagg(xml)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p1590134341213">Description: The <strong id="EN-US_TOPIC_0000001145910847__b785318353177">xmlagg</strong> function is an aggregate function that concatenates input values.</p>
<p id="EN-US_TOPIC_0000001145910847__p14901164321212">Return type: XML</p>
<p id="EN-US_TOPIC_0000001145910847__p14901194341214">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen1063405562116"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span>
<span class="normal">6</span>
<span class="normal">7</span>
<span class="normal">8</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">test</span><span class="w"> </span><span class="p">(</span><span class="n">y</span><span class="w"> </span><span class="nb">int</span><span class="p">,</span><span class="w"> </span><span class="n">x</span><span class="w"> </span><span class="n">xml</span><span class="p">);</span><span class="w"></span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">test</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="s1">'&lt;foo&gt;abc&lt;/foo&gt;'</span><span class="p">);</span><span class="w"></span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">test</span><span class="w"> </span><span class="k">VALUES</span><span class="w"> </span><span class="p">(</span><span class="mi">2</span><span class="p">,</span><span class="w"> </span><span class="s1">'&lt;bar/&gt;'</span><span class="p">);</span><span class="w"></span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">xmlagg</span><span class="p">(</span><span class="n">x</span><span class="p">)</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">test</span><span class="p">;</span><span class="w"></span>
<span class="n">xmlagg</span><span class="w"></span>
<span class="c1">----------------------</span>
<span class="o">&lt;</span><span class="n">foo</span><span class="o">&gt;</span><span class="n">abc</span><span class="o">&lt;/</span><span class="n">foo</span><span class="o">&gt;&lt;</span><span class="n">bar</span><span class="o">/&gt;</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>
<p id="EN-US_TOPIC_0000001145910847__p139011438124">To determine the concatenation sequence, you can add an ORDER BY clause for an aggregate call, for example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen395317172220"><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">xmlagg</span><span class="p">(</span><span class="n">x</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">y</span><span class="w"> </span><span class="k">DESC</span><span class="p">)</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">test</span><span class="p">;</span><span class="w"></span>
<span class="n">xmlagg</span><span class="w"></span>
<span class="c1">----------------------</span>
<span class="o">&lt;</span><span class="n">bar</span><span class="o">/&gt;&lt;</span><span class="n">foo</span><span class="o">&gt;</span><span class="n">abc</span><span class="o">&lt;/</span><span class="n">foo</span><span class="o">&gt;</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="section" id="EN-US_TOPIC_0000001145910847__section1924210249241"><h4 class="sectiontitle">XML Predicates</h4><ul id="EN-US_TOPIC_0000001145910847__ul3213182242319"><li id="EN-US_TOPIC_0000001145910847__li1213202219235">xml IS DOCUMENT</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p381051152320">Description: IS DOCUMENT returns true if the XML value of the parameter is a correct XML document; if the XML document is incorrect, false is returned. If the parameter is null, a null value is returned.</p>
<p id="EN-US_TOPIC_0000001145910847__p6810171111239">Return type: bool</p>
</div>
<ul id="EN-US_TOPIC_0000001145910847__ul113616386238"><li id="EN-US_TOPIC_0000001145910847__li31363387232">xml IS NOT DOCUMENT</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p781071182316">Description: Returns <strong id="EN-US_TOPIC_0000001145910847__b104781144106">true</strong> if the XML value of the parameter is not a correct XML document. If the XML document is correct, <strong id="EN-US_TOPIC_0000001145910847__b51013209107">false</strong> is returned. If the parameter is null, a null value is returned.</p>
<p id="EN-US_TOPIC_0000001145910847__p138106119238">Return type: bool</p>
<ul id="EN-US_TOPIC_0000001145910847__ul68186132417"><li id="EN-US_TOPIC_0000001145910847__li1581814116243">XMLEXISTS(text PASSING [BY REF] xml [BY REF])</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p8811101111230">Description: If the <strong id="EN-US_TOPIC_0000001145910847__b5251146288">xpath</strong> expression in the first parameter returns any node, the <strong id="EN-US_TOPIC_0000001145910847__b388921319286">XMLEXISTS</strong> function returns true. Otherwise, the function returns false. (If any parameter is null, the result is null.) The BY REF clause is invalid and is used to maintain SQL compatibility.</p>
<p id="EN-US_TOPIC_0000001145910847__p198110114233">Return type: bool</p>
<p id="EN-US_TOPIC_0000001145910847__p15811191192310">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen978142582211"><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">xmlexists</span><span class="p">(</span><span class="s1">'//town[text() = ''Toronto'']'</span><span class="w"> </span><span class="n">PASSING</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="k">REF</span><span class="w"> </span><span class="s1">'&lt;towns&gt;&lt;town&gt;Toronto&lt;/town&gt;&lt;town&gt;Ottawa&lt;/town&gt;&lt;/towns&gt;'</span><span class="p">);</span><span class="w"></span>
<span class="n">xmlexists</span><span class="w"></span>
<span class="c1">-----------</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>
<ul id="EN-US_TOPIC_0000001145910847__ul3304131411251"><li id="EN-US_TOPIC_0000001145910847__li43052143257">xml_is_well_formed(text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p345213109258">Description: Checks whether a text string is a well-formatted XML value and returns a Boolean result. If the <strong id="EN-US_TOPIC_0000001145910847__b1111165615250">xmloption</strong> parameter is set to <strong id="EN-US_TOPIC_0000001145910847__b586914192613">DOCUMENT</strong>, the document is checked. If the <strong id="EN-US_TOPIC_0000001145910847__b14506117142618">xmloption</strong> parameter is set to<strong id="EN-US_TOPIC_0000001145910847__b9986139152614"> CONTENT</strong>, the content is checked.</p>
<p id="EN-US_TOPIC_0000001145910847__p3452210122514">Return type: bool</p>
<p id="EN-US_TOPIC_0000001145910847__p181724249250">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen68831933182210"><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">xml_is_well_formed</span><span class="p">(</span><span class="s1">'&lt;abc/&gt;'</span><span class="p">);</span><span class="w"></span>
<span class="n">xml_is_well_formed</span><span class="w"></span>
<span class="c1">--------------------</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>
<ul id="EN-US_TOPIC_0000001145910847__ul3288651162520"><li id="EN-US_TOPIC_0000001145910847__li1328865192517">xml_is_well_formed_document(text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p6762125515253">Description: Checks whether a text string is a well-formatted text and returns a Boolean result.</p>
<p id="EN-US_TOPIC_0000001145910847__p1276235511251">Return type: bool</p>
<p id="EN-US_TOPIC_0000001145910847__p173462046192615">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen1754194232215"><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">xml_is_well_formed_document</span><span class="p">(</span><span class="s1">'&lt;test:foo xmlns:test=&quot;http://test.com/test&quot;&gt;bar&lt;/test:foo&gt;'</span><span class="p">);</span><span class="w"></span>
<span class="n">xml_is_well_formed_document</span><span class="w"></span>
<span class="c1">-----------------------------</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>
<ul id="EN-US_TOPIC_0000001145910847__ul128298277266"><li id="EN-US_TOPIC_0000001145910847__li1082917278267">xml_is_well_formed_content(text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p198113117234">Description: Checks whether a text string is a well-formatted content and returns a Boolean result.</p>
<p id="EN-US_TOPIC_0000001145910847__p12811211102310">Return type: bool</p>
<p id="EN-US_TOPIC_0000001145910847__p030451062716">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen34293278130"><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">xml_is_well_formed_content</span><span class="p">(</span><span class="s1">'content'</span><span class="p">);</span><span class="w"></span>
<span class="n">xml_is_well_formed_content</span><span class="w"></span>
<span class="c1">----------------------------</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>
<div class="section" id="EN-US_TOPIC_0000001145910847__section1995144182413"><h4 class="sectiontitle">Processing XML</h4><ul id="EN-US_TOPIC_0000001145910847__ul1437011718149"><li id="EN-US_TOPIC_0000001145910847__li33700710148">xpath(xpath, xml [, nsarray])</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p337110711420">Description: Returns an array of XML values corresponding to the set of nodes produced by the <strong id="EN-US_TOPIC_0000001145910847__b52935457273">xpath</strong> expression. If the <strong id="EN-US_TOPIC_0000001145910847__b1796582117289">xpath</strong> expression returns a scalar value instead of a set of nodes, an array of individual elements is returned. The second parameter <strong id="EN-US_TOPIC_0000001145910847__b914110267291">xml</strong> must be a complete XML document, which must have a root node element. The third parameter is an array map of a namespace. The array should be a two-dimensional text array, and the length of the second dimension should be <strong id="EN-US_TOPIC_0000001145910847__b5645171533014">2</strong>. (It should be an array of arrays, each containing exactly two elements). The first element of each array item is the alias of the namespace name, and the second element is the namespace URI. The alias provided in this array does not have to be the same as the alias used in the XML document itself. In other words, in the context of both XML documents and <strong id="EN-US_TOPIC_0000001145910847__b18272102719315">xpath</strong> functions, aliases are local.</p>
<p id="EN-US_TOPIC_0000001145910847__p8371779146">Return type: XML value array</p>
<p id="EN-US_TOPIC_0000001145910847__p637116761420">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen10371127131415"><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">xpath</span><span class="p">(</span><span class="s1">'/my:a/text()'</span><span class="p">,</span><span class="w"> </span><span class="s1">'&lt;my:a xmlns:my=&quot;http://example.com&quot;&gt;test&lt;/my:a&gt;'</span><span class="p">,</span><span class="w"> </span><span class="nb">ARRAY</span><span class="p">[</span><span class="nb">ARRAY</span><span class="p">[</span><span class="s1">'my'</span><span class="p">,</span><span class="w"> </span><span class="s1">'http://example.com'</span><span class="p">]]);</span><span class="w"></span>
<span class="n">xpath</span><span class="w"></span>
<span class="c1">--------</span>
<span class="err">{</span><span class="n">test</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>
<ul id="EN-US_TOPIC_0000001145910847__ul1310701816345"><li id="EN-US_TOPIC_0000001145910847__li510791811340">xpath_exists(xpath, xml [, nsarray])</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p197174611342">Description: The <strong id="EN-US_TOPIC_0000001145910847__b62703584316">xpath_exists</strong> function is a special form of the <strong id="EN-US_TOPIC_0000001145910847__b2630111193210">xpath</strong> function. This function does not return an XML value that satisfies the <strong id="EN-US_TOPIC_0000001145910847__b120810409334">xpath</strong> function; it returns a Boolean value indicating whether the query is satisfied. This function is equivalent to the standard <strong id="EN-US_TOPIC_0000001145910847__b848726135415">XMLEXISTS</strong> predicate, but it also provides support for a namespace mapping parameter.</p>
<p id="EN-US_TOPIC_0000001145910847__p1371776133416">Return type: bool</p>
<p id="EN-US_TOPIC_0000001145910847__p10717196183411">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen15771546231"><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">xpath_exists</span><span class="p">(</span><span class="s1">'/my:a/text()'</span><span class="p">,</span><span class="w"> </span><span class="s1">'&lt;my:a xmlns:my=&quot;http://example.com&quot;&gt;test&lt;/my:a&gt;'</span><span class="p">,</span><span class="w"> </span><span class="nb">ARRAY</span><span class="p">[</span><span class="nb">ARRAY</span><span class="p">[</span><span class="s1">'my'</span><span class="p">,</span><span class="w"> </span><span class="s1">'http://example.com'</span><span class="p">]]);</span><span class="w"></span>
<span class="n">xpath_exists</span><span class="w"></span>
<span class="c1">--------------</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>
<ul id="EN-US_TOPIC_0000001145910847__ul377316596493"><li id="EN-US_TOPIC_0000001145910847__li67731159104912">xmltable</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p02334345017">Description: Generates a table based on the input XML data, <strong id="EN-US_TOPIC_0000001145910847__b11115201285017">XPath</strong> expression, and column definition. An <strong id="EN-US_TOPIC_0000001145910847__b116306283580">xmltable</strong> is similar to a function in syntax, but it can appear only as a table in the FROM clause of a query.</p>
<p id="EN-US_TOPIC_0000001145910847__p1742014417352">Return value: setof record</p>
<p id="EN-US_TOPIC_0000001145910847__p198723352549">Syntax:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen9322411181211"><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="n">XMLTABLE</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="n">XMLNAMESPACES</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">namespace_uri</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="n">namespace_name</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="p">]</span><span class="w"></span>
<span class="w"> </span><span class="n">row_expression</span><span class="w"> </span><span class="n">PASSING</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="k">REF</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">VALUE</span><span class="w"> </span><span class="err">}</span><span class="w"> </span><span class="p">]</span><span class="w"></span>
<span class="n">document_expression</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="k">REF</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">VALUE</span><span class="w"> </span><span class="err">}</span><span class="w"> </span><span class="p">]</span><span class="w"></span>
<span class="n">COLUMNS</span><span class="w"> </span><span class="n">name</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="k">type</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="n">PATH</span><span class="w"> </span><span class="n">column_expression</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">DEFAULT</span><span class="w"> </span><span class="n">default_expression</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">NOT</span><span class="w"> </span><span class="k">NULL</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">NULL</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">FOR</span><span class="w"> </span><span class="k">ORDINALITY</span><span class="w"> </span><span class="err">}</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>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001145910847__p1961072865612">Parameter:</p>
<ul id="EN-US_TOPIC_0000001145910847__ul10402114141410"><li id="EN-US_TOPIC_0000001145910847__li84021314151417">The optional XMLNAMESPACES clause is a comma-separated list of namespace definitions, where each <strong id="EN-US_TOPIC_0000001145910847__b11410546115820">namespace_uri</strong> is a text-type expression and each <strong id="EN-US_TOPIC_0000001145910847__b17414124645815">namespace_name</strong> is a simple identifier. XMLNAMESPACES specifies the XML namespaces used in the document and their aliases. The default namespace declaration is not supported.</li><li id="EN-US_TOPIC_0000001145910847__li2210857111518">The mandatory parameter <strong id="EN-US_TOPIC_0000001145910847__b340871635913">row_expression</strong> is an <strong id="EN-US_TOPIC_0000001145910847__b12412111645913">XPath</strong> 1.0 expression. This expression calculates the sequence of XML nodes based on the provided XML document <strong id="EN-US_TOPIC_0000001145910847__b18413191665919">document_expression</strong>. The sequence is the sequence of converting <strong id="EN-US_TOPIC_0000001145910847__b16413216135914">xmltable</strong> to output lines. If the <strong id="EN-US_TOPIC_0000001145910847__b18783129185919">document_expression</strong> value is <strong id="EN-US_TOPIC_0000001145910847__b207875297599">NULL</strong> or an empty node set generated by <strong id="EN-US_TOPIC_0000001145910847__b578852955919">row_expression</strong>, no line is returned.</li><li id="EN-US_TOPIC_0000001145910847__li12973125082912">The <strong id="EN-US_TOPIC_0000001145910847__b17826136145912">document_expression</strong> parameter is used to input an XML document. The input document must be in the XML format. XML fragment data or XML documents in incorrect format are not accepted. The BY REF and BY VALUE clauses do not take effect. They are used only to implement SQL standard compatibility.</li><li id="EN-US_TOPIC_0000001145910847__li164031356102920">The COLUMNS clause specifies the column list definition in the output table. The column name and column data type are mandatory, and the path, default value, and whether the clause is empty are optional.<ul id="EN-US_TOPIC_0000001145910847__ul10535447124015"><li id="EN-US_TOPIC_0000001145910847__li19874163534019"><strong id="EN-US_TOPIC_0000001145910847__b1374413316012">column_expression</strong> of a column is an <strong id="EN-US_TOPIC_0000001145910847__b1674912315014">XPath</strong> 1.0 expression used to calculate the value of the column extracted from the current row based on <strong id="EN-US_TOPIC_0000001145910847__b1574983204">row_expression</strong>. If <strong id="EN-US_TOPIC_0000001145910847__b113211201505">column_expression</strong> is not specified, the field name is used as an implicit path.</li><li id="EN-US_TOPIC_0000001145910847__li88761835114019">A column can be marked as <strong id="EN-US_TOPIC_0000001145910847__b21294271702">NOT NULL</strong>. If <strong id="EN-US_TOPIC_0000001145910847__b1813352715013">column_expression</strong> in the <strong id="EN-US_TOPIC_0000001145910847__b21348271909">NOT NULL</strong> column does not return any data, and there is no DEFAULT clause or the calculation result of <strong id="EN-US_TOPIC_0000001145910847__b18134162716011">default_expression</strong> is <strong id="EN-US_TOPIC_0000001145910847__b19134172715012">NULL</strong>, an error is reported.</li><li id="EN-US_TOPIC_0000001145910847__li98782358404">The columns marked as <strong id="EN-US_TOPIC_0000001145910847__b86313423011">FOR ORDINALITY</strong> are filled with row numbers starting from <strong id="EN-US_TOPIC_0000001145910847__b10636194218018">1</strong>. The sequence is the node sequence retrieved from the <strong id="EN-US_TOPIC_0000001145910847__b116362421608">row_expression</strong> result set. A maximum of one column can be marked as <strong id="EN-US_TOPIC_0000001145910847__b1163617420013">FOR ORDINALITY</strong>.<div class="notice" id="EN-US_TOPIC_0000001145910847__note1259264119306"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001145910847__p1543254743012"><strong id="EN-US_TOPIC_0000001145910847__b6253116813">XPath</strong> 1.0 does not specify the order for nodes, so the order in which results are returned depends on the order in which data is obtained.</p>
</div></div>
</li></ul>
</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p786371111112">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145910847__screen98981294448"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">XMLTABLE</span><span class="p">(</span><span class="s1">'/ROWS/ROW'</span><span class="w"></span>
<span class="n">PASSING</span><span class="w"> </span><span class="s1">'&lt;ROWS&gt;&lt;ROW id=&quot;1&quot;&gt;&lt;COUNTRY_ID&gt;AU&lt;/COUNTRY_ID&gt;&lt;COUNTRY_NAME&gt;Australia&lt;/COUNTRY_NAME&gt;&lt;/ROW&gt;&lt;ROW id=&quot;2&quot;&gt;&lt;COUNTRY_ID&gt;FR&lt;/COUNTRY_ID&gt;&lt;COUNTRY_NAME&gt;France&lt;/COUNTRY_NAME&gt;&lt;/ROW&gt;&lt;ROW id=&quot;3&quot;&gt;&lt;COUNTRY_ID&gt;SG&lt;/COUNTRY_ID&gt;&lt;COUNTRY_NAME&gt;Singapore&lt;/COUNTRY_NAME&gt;&lt;/ROW&gt;&lt;/ROWS&gt;'</span><span class="w"></span>
<span class="n">COLUMNS</span><span class="w"> </span><span class="n">id</span><span class="w"> </span><span class="nb">INT</span><span class="w"> </span><span class="n">PATH</span><span class="w"> </span><span class="s1">'@id'</span><span class="p">,</span><span class="w"></span>
<span class="n">_id</span><span class="w"> </span><span class="k">FOR</span><span class="w"> </span><span class="k">ORDINALITY</span><span class="p">,</span><span class="w"></span>
<span class="n">country_id</span><span class="w"> </span><span class="nb">TEXT</span><span class="w"> </span><span class="n">PATH</span><span class="w"> </span><span class="s1">'COUNTRY_ID'</span><span class="p">,</span><span class="w"></span>
<span class="n">country_name</span><span class="w"> </span><span class="nb">TEXT</span><span class="w"> </span><span class="n">PATH</span><span class="w"> </span><span class="s1">'COUNTRY_NAME'</span><span class="w"> </span><span class="k">NOT</span><span class="w"> </span><span class="k">NULL</span><span class="p">);</span><span class="w"></span>
<span class="n">id</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">_id</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">country_id</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">country_name</span><span class="w"></span>
<span class="c1">----+-----+---------------+--------------</span>
<span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">AU</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">Australia</span><span class="w"></span>
<span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">FR</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">France</span><span class="w"></span>
<span class="w"> </span><span class="mi">3</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">3</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">SG</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">Singapore</span><span class="w"></span>
<span class="p">(</span><span class="mi">3</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>
<div class="section" id="EN-US_TOPIC_0000001145910847__section13522850152419"><h4 class="sectiontitle">Mapping a Table to XML</h4><ul id="EN-US_TOPIC_0000001145910847__ul164971131164512"><li id="EN-US_TOPIC_0000001145910847__li64971431174515">table_to_xml(tbl regclass, nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p11878236459">Description: Maps the contents of a table to XML values.</p>
<p id="EN-US_TOPIC_0000001145910847__p118752394517">Return type: XML</p>
</div>
<ul id="EN-US_TOPIC_0000001145910847__ul670163564516"><li id="EN-US_TOPIC_0000001145910847__li1570116355458">table_to_xmlschema(tbl regclass, nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p108718236458">Description: Maps a relational table schema to an XML schema document.</p>
<p id="EN-US_TOPIC_0000001145910847__p178722314512">Return type: XML</p>
<ul id="EN-US_TOPIC_0000001145910847__ul2458173915457"><li id="EN-US_TOPIC_0000001145910847__li1145843964520">table_to_xml_and_xmlschema(tbl regclass, nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p78713234453">Description: Maps a relational table to XML values and schema documents.</p>
<p id="EN-US_TOPIC_0000001145910847__p1687523164519">Return type: XML</p>
<ul id="EN-US_TOPIC_0000001145910847__ul14409174324516"><li id="EN-US_TOPIC_0000001145910847__li1740944364515">query_to_xml(query text, nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p12871223164512">Description: Maps the contents of an SQL query to XML values.</p>
<p id="EN-US_TOPIC_0000001145910847__p38762319453">Return type: XML</p>
<ul id="EN-US_TOPIC_0000001145910847__ul1070654614515"><li id="EN-US_TOPIC_0000001145910847__li4707154614516">query_to_xmlschema(query text, nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p198718235458">Description: Maps an SQL query into an XML schema document.</p>
<p id="EN-US_TOPIC_0000001145910847__p3871923124513">Return type: XML</p>
<ul id="EN-US_TOPIC_0000001145910847__ul1799413522457"><li id="EN-US_TOPIC_0000001145910847__li169941052164515">query_to_xml_and_xmlschema(query text, nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p387823204512">Description: Maps SQL queries to XML values and schema documents.</p>
<p id="EN-US_TOPIC_0000001145910847__p1687202384518">Return type: XML</p>
<ul id="EN-US_TOPIC_0000001145910847__ul1338175764520"><li id="EN-US_TOPIC_0000001145910847__li1338155734511">cursor_to_xml(cursor refcursor, count int, nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p198792314457">Description: Maps a cursor query to an XML value.</p>
<p id="EN-US_TOPIC_0000001145910847__p128872310459">Return type: XML</p>
<ul id="EN-US_TOPIC_0000001145910847__ul135059019464"><li id="EN-US_TOPIC_0000001145910847__li105051609468">cursor_to_xmlschema(cursor refcursor, nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p188820239459">Description: Maps a cursor query to an XML schema document.</p>
<p id="EN-US_TOPIC_0000001145910847__p288192364515">Return type: XML</p>
<ul id="EN-US_TOPIC_0000001145910847__ul421418844618"><li id="EN-US_TOPIC_0000001145910847__li142141387460">schema_to_xml(schema name, nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p16881223184516">Description: Maps a table in a schema to an XML value.</p>
<p id="EN-US_TOPIC_0000001145910847__p1588723124516">Return type: XML</p>
<ul id="EN-US_TOPIC_0000001145910847__ul1888781116462"><li id="EN-US_TOPIC_0000001145910847__li1788741112468">schema_to_xmlschema(schema name, nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p688172364510">Description: Maps a table in a schema to an XML schema document.</p>
<p id="EN-US_TOPIC_0000001145910847__p788142311455">Return type: XML</p>
<ul id="EN-US_TOPIC_0000001145910847__ul124725165460"><li id="EN-US_TOPIC_0000001145910847__li18472191604618">schema_to_xml_and_xmlschema(schema name, nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p19881923174519">Description: Maps a table in a schema to an XML value and a schema document.</p>
<p id="EN-US_TOPIC_0000001145910847__p788323174514">Return type: XML</p>
<ul id="EN-US_TOPIC_0000001145910847__ul171226203467"><li id="EN-US_TOPIC_0000001145910847__li412212209461">database_to_xml(nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p16881623164510">Description: Maps a database table to an XML value.</p>
<p id="EN-US_TOPIC_0000001145910847__p78862394512">Return type: XML</p>
<ul id="EN-US_TOPIC_0000001145910847__ul11645223164613"><li id="EN-US_TOPIC_0000001145910847__li18645823144612">database_to_xmlschema(nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p3881923124516">Description: Maps a database table to an XML schema document.</p>
<p id="EN-US_TOPIC_0000001145910847__p98819237454">Return type: XML</p>
<ul id="EN-US_TOPIC_0000001145910847__ul12522142715465"><li id="EN-US_TOPIC_0000001145910847__li17522102714461">database_to_xml_and_xmlschema(nulls boolean, tableforest boolean, targetns text)</li></ul>
<p id="EN-US_TOPIC_0000001145910847__p9881423124514">Description: Maps database tables to XML values and schema documents.</p>
<p id="EN-US_TOPIC_0000001145910847__p1388122317454">Return type: XML</p>
<div class="note" id="EN-US_TOPIC_0000001145910847__note8984143162815"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001145910847__p4660202812812">The parameters for mapping a table to an XML value are described as follows:</p>
<ul id="EN-US_TOPIC_0000001145910847__ul10231132316295"><li id="EN-US_TOPIC_0000001145910847__li11231112372919"><strong id="EN-US_TOPIC_0000001145910847__b37785517118">tbl</strong>: table name.</li><li id="EN-US_TOPIC_0000001145910847__li142311923192912"><strong id="EN-US_TOPIC_0000001145910847__b93231121227">nulls</strong>: indicates whether the output contains null values. If the value is <strong id="EN-US_TOPIC_0000001145910847__b25821011221">true</strong>, the null value in the column is <strong id="EN-US_TOPIC_0000001145910847__b1810502714216">&lt;columnname xsi:nil="true"/&gt;</strong>. If the value is <strong id="EN-US_TOPIC_0000001145910847__b7938732125">false</strong>, the columns containing null values are omitted from the output.</li><li id="EN-US_TOPIC_0000001145910847__li1523152315299"><strong id="EN-US_TOPIC_0000001145910847__b54926411122">tableforest</strong>: If this parameter is set to <strong id="EN-US_TOPIC_0000001145910847__b7418164612219">true</strong>, XML fragments are generated. If this parameter is set to <strong id="EN-US_TOPIC_0000001145910847__b184349535214">false</strong>, XML files are generated.</li><li id="EN-US_TOPIC_0000001145910847__li1231122310293"><strong id="EN-US_TOPIC_0000001145910847__b822713010314">targetns</strong>: specifies the XML namespace of the desired result. If this parameter is not specified, an empty string is passed.</li><li id="EN-US_TOPIC_0000001145910847__li1833602214330"><strong id="EN-US_TOPIC_0000001145910847__b8689625339">query</strong>: SQL query statement</li><li id="EN-US_TOPIC_0000001145910847__li2058211438337"><strong id="EN-US_TOPIC_0000001145910847__b13508535834">cursor</strong>: cursor name</li><li id="EN-US_TOPIC_0000001145910847__li1135343910339"><strong id="EN-US_TOPIC_0000001145910847__b8514163812311">count</strong>: amount of data obtained from the cursor</li><li id="EN-US_TOPIC_0000001145910847__li5271191218346"><strong id="EN-US_TOPIC_0000001145910847__b1957118491934">schema</strong>: schema name</li></ul>
</div></div>
</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