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

871 lines
90 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001188482120"></a><a name="EN-US_TOPIC_0000001188482120"></a>
<h1 class="topictitle1">DBMS_LOB</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001188482120__s080dcd1b865a4790a1cb1e01d97881fa"><h4 class="sectiontitle">Related Interfaces</h4><p id="EN-US_TOPIC_0000001188482120__acf2195bfe8e140a0a8e90be93f06fa85"><a href="#EN-US_TOPIC_0000001188482120__t652a1b67fb4746cb846f73477c3bb77f">Table 1</a> provides all interfaces supported by the <strong id="EN-US_TOPIC_0000001188482120__a5f636381dd3b40bc9ac28d36a7544101">DBMS_LOB</strong> package.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001188482120__t652a1b67fb4746cb846f73477c3bb77f"></a><a name="t652a1b67fb4746cb846f73477c3bb77f"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__t652a1b67fb4746cb846f73477c3bb77f" frame="border" border="1" rules="all"><caption><b>Table 1 </b>DBMS_LOB</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__ra8fed743a29a4a93b59df7290943e45a"><th align="left" class="cellrowborder" valign="top" width="35.93%" id="mcps1.3.1.3.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__a27e782ef645746f9a6799725262f84d7">API</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="64.07000000000001%" id="mcps1.3.1.3.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__a9f984fc445054d33b65f458014bf1ecf">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__rdebc41f5a9f94f84a653e9fe250e514d"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__af664c7e75e2c495fad51d4c7d02730c9"><a href="#EN-US_TOPIC_0000001188482120__l112821beeb424f68a87f11bbcb23ba8c">DBMS_LOB.GETLENGTH</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a2ab368538c2949418c5a71c62359c398">Obtains and returns the specified length of a LOB object.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row1487315436182"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p158745430183"><a href="#EN-US_TOPIC_0000001188482120__li7581543191913">DBMS_LOB.OPEN</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p787414318189">Opens a LOB and returns a LOB descriptor.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__r2f660ee5122940b995c3a719c7412fb0"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__ae0a1562b20a54ceca04ca1a599486cd9"><a href="#EN-US_TOPIC_0000001188482120__l48e5b599124e4753818164902a609713">DBMS_LOB.READ</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a03b0d67f945a4d1a911680647ad5f580">Loads a part of LOB contents to BUFFER area according to the specified length and initial position offset.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__racb03609fd294099808455355137f64e"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a9e6ffeb782b74281a8b8b09bf217395c"><a href="#EN-US_TOPIC_0000001188482120__l1fd7a1bbcff5458890a384d2f8152a31">DBMS_LOB.WRITE</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__af7cd791c0c9c49f2bab02d156e8c3107">Copies contents in BUFFER area to LOB according to the specified length and initial position offset.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__r361fc8fd34fb49d4a1e9088941849191"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a968a6655ba5849a9b16eeefa14fb0320"><a href="#EN-US_TOPIC_0000001188482120__lfcc14fd73f834169bb03ceb2e832f817">DBMS_LOB.WRITEAPPEND</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__aa66ed9da1a73465b9aef6180f611434f">Copies contents in BUFFER area to the end part of LOB according to the specified length.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__r8a5d245db221497581296c51c3f64e4c"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a044a7cd93c114a29b827c5f9e9d60a06"><a href="#EN-US_TOPIC_0000001188482120__l2af2f8b7366643ca91559e18eaea4692">DBMS_LOB.COPY</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a92a6beb2d9034d3393a1903323d85acb">Copies contents in BLOB to another BLOB according to the specified length and initial position offset.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__ra19d17015a924c048215a5ab98ba642a"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__abe6d42debe90428db553a2973fe6de5a"><a href="#EN-US_TOPIC_0000001188482120__l8d03841cf8fb4c4b899a356efcb34f0e">DBMS_LOB.ERASE</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a923a926b557c428d87fca249e272b80e">Deletes contents in BLOB according to the specified length and initial position offset.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__rbd1fa83a207747a6b31a48fa49fcaa3c"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a5b2ed1876afe4897912ace4162fbb9af"><a href="#EN-US_TOPIC_0000001188482120__ta292aad6be2b4dfcb2cc8efe0c540879">DBMS_LOB.CLOSE</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a833a6268570346a5aca8b356028aca34">Closes a LOB descriptor.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row68011725104"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p108021628103"><a href="#EN-US_TOPIC_0000001188482120__li1442318419148">DBMS_LOB.INSTR</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p1680210261014">Returns the position of the Nth occurrence of a character string in LOB.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row076195215166"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p1676155281616"><a href="#EN-US_TOPIC_0000001188482120__li19579245181414">DBMS_LOB.COMPARE</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p976852141611">Compares two LOBs or a certain part of two LOBs.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row6889194715168"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p108892479161"><a href="#EN-US_TOPIC_0000001188482120__li381175591417">DBMS_LOB.SUBSTR</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p78891347191615">Reads the substring of a LOB and returns the number of read bytes or the number of characters.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row2672173512167"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p1267263519162"><a href="#EN-US_TOPIC_0000001188482120__li374125861411">DBMS_LOB.TRIM</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p11672435151613">Truncates the LOB of a specified length. After the execution is complete, the length of the LOB is set to the length specified by the <strong id="EN-US_TOPIC_0000001188482120__b922155233917">newlen</strong> parameter.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row235685818184"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p113563582185"><a href="#EN-US_TOPIC_0000001188482120__li145817213157">DBMS_LOB.CREATETEMPORARY</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p1928175419583">Creates a temporary BLOB or CLOB.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row54322157196"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p15433815161912"><a href="#EN-US_TOPIC_0000001188482120__li194203411159">DBMS_LOB.APPEND</a></p>
</td>
<td class="cellrowborder" valign="top" width="64.07000000000001%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p112141156125815">Adds the content of a LOB to another LOB.</p>
</td>
</tr>
</tbody>
</table>
</div>
<ul id="EN-US_TOPIC_0000001188482120__u87b6db02269849c4b9bafc27433c89c4"><li id="EN-US_TOPIC_0000001188482120__l112821beeb424f68a87f11bbcb23ba8c"><a name="EN-US_TOPIC_0000001188482120__l112821beeb424f68a87f11bbcb23ba8c"></a><a name="l112821beeb424f68a87f11bbcb23ba8c"></a>DBMS_LOB.GETLENGTH<p id="EN-US_TOPIC_0000001188482120__ab10b7ee75a174fdf9f369603e3a13478"><a name="EN-US_TOPIC_0000001188482120__l112821beeb424f68a87f11bbcb23ba8c"></a><a name="l112821beeb424f68a87f11bbcb23ba8c"></a>Specifies the length of a LOB type object obtained and returned by the stored procedure <strong id="EN-US_TOPIC_0000001188482120__a820c601054714549a59f68ec90a0d404">GETLENGTH</strong>.</p>
<p id="EN-US_TOPIC_0000001188482120__ab8acf399f35c4047b29dd8f851485ab9">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__ad130a3b9fe404b3c8bf69fe537096dfb">DBMS_LOB.GETLENGTH</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__s2e57ea6ce7594ff3be8f9517bad1b9f3"><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="n">DBMS_LOB</span><span class="p">.</span><span class="n">GETLENGTH</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">)</span>
<span class="k">RETURN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">;</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">GETLENGTH</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">CLOB</span><span class="p">)</span>
<span class="k">RETURN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__t8661cf002e2b4462a953913bce609ea6" frame="border" border="1" rules="all"><caption><b>Table 2 </b>DBMS_LOB.GETLENGTH interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__rb7c72a20ccb341c79496b8227e424ccf"><th align="left" class="cellrowborder" valign="top" width="23.05%" id="mcps1.3.1.4.1.4.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__a7f88abc08bc24e60b18000f9b15ce03e">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="76.95%" id="mcps1.3.1.4.1.4.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__ac5b9387a6a2443d8b37ce1dbb1fdb0bf">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__rd71bb0ad68254eb3970cfe672ae19763"><td class="cellrowborder" valign="top" width="23.05%" headers="mcps1.3.1.4.1.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a8ef73442a4764a36b5f467beb8902751">lob_loc</p>
</td>
<td class="cellrowborder" valign="top" width="76.95%" headers="mcps1.3.1.4.1.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__adc34e537abdc47379a46f9260b1291f1">LOB type object whose length is to be obtained</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001188482120__li7581543191913"><a name="EN-US_TOPIC_0000001188482120__li7581543191913"></a><a name="li7581543191913"></a>DBMS_LOB.OPEN<p id="EN-US_TOPIC_0000001188482120__p2581104315192"><a name="EN-US_TOPIC_0000001188482120__li7581543191913"></a><a name="li7581543191913"></a>A stored procedure opens a LOB and returns a LOB descriptor. This process is used only for compatibility.</p>
<p id="EN-US_TOPIC_0000001188482120__p1058120430190">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__b117322133410">DBMS_LOB.OPEN</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__screen858234321918"><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="n">DBMS_LOB</span><span class="p">.</span><span class="n">LOB</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">INOUT</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="n">open_mode</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="n">BINARY_INTEGER</span><span class="p">);</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">LOB</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">INOUT</span><span class="w"> </span><span class="k">CLOB</span><span class="p">,</span>
<span class="n">open_mode</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="n">BINARY_INTEGER</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__table11582943121914" frame="border" border="1" rules="all"><caption><b>Table 3 </b>DBMS_LOB.OPEN interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__row14582154351919"><th align="left" class="cellrowborder" valign="top" width="23.05%" id="mcps1.3.1.4.2.4.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__p165830438197">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="76.95%" id="mcps1.3.1.4.2.4.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__p175832434192">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__row125831143171914"><td class="cellrowborder" valign="top" width="23.05%" headers="mcps1.3.1.4.2.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p1458314311198">lob_loc</p>
</td>
<td class="cellrowborder" valign="top" width="76.95%" headers="mcps1.3.1.4.2.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p458364351913">BLOB or CLOB descriptor that is opened</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row136166465268"><td class="cellrowborder" valign="top" width="23.05%" headers="mcps1.3.1.4.2.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p56172464268">open_mode IN BINARY_INTEGER</p>
</td>
<td class="cellrowborder" valign="top" width="76.95%" headers="mcps1.3.1.4.2.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p106175463262">Open mode (currently, DBMS_LOB.LOB_READWRITE is supported)</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001188482120__l48e5b599124e4753818164902a609713"><a name="EN-US_TOPIC_0000001188482120__l48e5b599124e4753818164902a609713"></a><a name="l48e5b599124e4753818164902a609713"></a>DBMS_LOB.READ<p id="EN-US_TOPIC_0000001188482120__a17626ebffda6433b8d54f23b39bfd205"><a name="EN-US_TOPIC_0000001188482120__l48e5b599124e4753818164902a609713"></a><a name="l48e5b599124e4753818164902a609713"></a>The stored procedure <strong id="EN-US_TOPIC_0000001188482120__b16172771443">READ</strong> loads a part of LOB contents to BUFFER according to the specified length and initial position offset.</p>
<p id="EN-US_TOPIC_0000001188482120__afd0b8c8687e342a5ba29baf342564f40">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__aee03012f52a649a7948fc37169c1e3a2">DBMS_LOB.READ</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__sc310ba1ebf9e498d9adc511d40d8f4d9"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">DBMS_LOB</span><span class="p">.</span><span class="k">READ</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="n">amount</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="k">offset</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="n">buffer</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="n">RAW</span><span class="p">);</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="k">READ</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">CLOB</span><span class="p">,</span>
<span class="n">amount</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="k">offset</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="n">buffer</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="n">VARCHAR2</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__t60faec415f2443a5aa6dff33bf75778b" frame="border" border="1" rules="all"><caption><b>Table 4 </b>DBMS_LOB.READ interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__rdb52a3c8b4da49eab5d40640ef7152f2"><th align="left" class="cellrowborder" valign="top" width="24.16%" id="mcps1.3.1.4.3.4.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__a807c72b11876424db796ed048fb30d1b">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="75.84%" id="mcps1.3.1.4.3.4.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__a026cd2cd502d4ae8ba414e94c67ab69e">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__re070c2f040fc463b8a0998a98f845b81"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.3.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__ae7c3b4aaf265452e9c245d5ba09f9596">lob_loc</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.3.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__ad26eaeac1fb5476f96fab7f69f3090f9">LOB type object to be loaded</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__re748d0e7546f4afcb963474abb75b7f5"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.3.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a3c07870a60754ee699fdc4c5ed91512a">amount</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.3.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a679f110324994eaa93e033ca8e656f00">Load data length</p>
<div class="note" id="EN-US_TOPIC_0000001188482120__n0da6876bffce46d6858e249f25d4227d"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001188482120__p116171649250">If the read length is negative, the error message "ERROR: argument 2 is null, invalid, or out of range." is displayed.</p>
</div></div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__r42b7240add764f09afa49b10b9bc4982"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.3.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a7edade949b1b40cdbe7bd57d6f7aa23d">offset</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.3.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a86f3e13bab9d4764ac88704fccc6a7c9">Indicates where to start reading the LOB contents, that is, the offset bytes to initial position of LOB contents.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__r8a26597f40b84d959c0b851200045e17"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.3.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a27f37e8efea34c1faf04f3d604dcbcaa">buffer</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.3.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a51755e812fe741b0a0d466d8b5e72e7b">Target buffer to store the loaded LOB contents</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001188482120__l1fd7a1bbcff5458890a384d2f8152a31"><a name="EN-US_TOPIC_0000001188482120__l1fd7a1bbcff5458890a384d2f8152a31"></a><a name="l1fd7a1bbcff5458890a384d2f8152a31"></a>DBMS_LOB.WRITE<p id="EN-US_TOPIC_0000001188482120__afb1b8b7cc2b14886834516afb6c64316"><a name="EN-US_TOPIC_0000001188482120__l1fd7a1bbcff5458890a384d2f8152a31"></a><a name="l1fd7a1bbcff5458890a384d2f8152a31"></a>The stored procedure <strong id="EN-US_TOPIC_0000001188482120__b1686415684613">WRITE</strong> copies contents in BUFFER to LOB variables according to the specified length and initial position offset.</p>
<p id="EN-US_TOPIC_0000001188482120__ae031356210494a07b693384ef5d77d8f">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__a576212b089134053a2ca6fb11ab04726">DBMS_LOB.WRITE</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__s426c3f9147844f91916847f3e783cf34"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">DBMS_LOB</span><span class="p">.</span><span class="k">WRITE</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="n">amount</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="k">offset</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="n">buffer</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="n">RAW</span><span class="p">);</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="k">WRITE</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="k">CLOB</span><span class="p">,</span>
<span class="n">amount</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="k">offset</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="n">buffer</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="n">VARCHAR2</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__tf8736ba8f58c4b718da130c12e7e5dd4" frame="border" border="1" rules="all"><caption><b>Table 5 </b>DBMS_LOB.WRITE interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__r110ce47be2c84138a7260388a547f806"><th align="left" class="cellrowborder" valign="top" width="24.18%" id="mcps1.3.1.4.4.4.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__af2e6e30cc2a84de4a1555971f7b4f562">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="75.82%" id="mcps1.3.1.4.4.4.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__af1c8bca44c3a4ff785a101fe8ca468ea">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__rc341bdbc1e634484aa1547fd329ebb20"><td class="cellrowborder" valign="top" width="24.18%" headers="mcps1.3.1.4.4.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a89eb7b4dc1304035acbefac964c18b69">lob_loc</p>
</td>
<td class="cellrowborder" valign="top" width="75.82%" headers="mcps1.3.1.4.4.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a70591c40f69f493fab450f3d24b71c13">LOB type object to be written</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__r0c922dbc2ee041daab66edc6c401e889"><td class="cellrowborder" valign="top" width="24.18%" headers="mcps1.3.1.4.4.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a431193ad96a846b1b8bada8814168094">amount</p>
</td>
<td class="cellrowborder" valign="top" width="75.82%" headers="mcps1.3.1.4.4.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__aca42ac60f592421c98a6413042ae6995">Write data length</p>
<div class="note" id="EN-US_TOPIC_0000001188482120__naf65fc2ac5674bdbbe7df435b7c9d237"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001188482120__ae6fcc853940e48c08114298307b49f23">If the write data is shorter than 1 or longer than the contents to be written, an error is reported.</p>
</div></div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__rdcbbc27e8f844977852eb498a7196a40"><td class="cellrowborder" valign="top" width="24.18%" headers="mcps1.3.1.4.4.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__aee2d005af6bf422db618f40ae724e7de">offset</p>
</td>
<td class="cellrowborder" valign="top" width="75.82%" headers="mcps1.3.1.4.4.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a19d2bd9b73e04c66bfb11859fd13b943">Indicates where to start writing the LOB contents, that is, the offset bytes to initial position of LOB contents.</p>
<div class="note" id="EN-US_TOPIC_0000001188482120__n8472ef9e47cc48c791e24a38ca52df75"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001188482120__a32b3edf05c064328aaa538e679831138">If the offset is shorter than 1 or longer than the maximum length of LOB type contents, an error is reported.</p>
</div></div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__rf0bce5d009844a9299dd11485ad31bc1"><td class="cellrowborder" valign="top" width="24.18%" headers="mcps1.3.1.4.4.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a29771c07050f4e38a5b8f9724f8f9be9">buffer</p>
</td>
<td class="cellrowborder" valign="top" width="75.82%" headers="mcps1.3.1.4.4.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__ac1e43e4c6570487ab9f0b6b652302fce">Content to be written</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001188482120__lfcc14fd73f834169bb03ceb2e832f817"><a name="EN-US_TOPIC_0000001188482120__lfcc14fd73f834169bb03ceb2e832f817"></a><a name="lfcc14fd73f834169bb03ceb2e832f817"></a>DBMS_LOB.WRITEAPPEND<p id="EN-US_TOPIC_0000001188482120__afd44e2e2f5014b3896c5dd7ff68f5b26"><a name="EN-US_TOPIC_0000001188482120__lfcc14fd73f834169bb03ceb2e832f817"></a><a name="lfcc14fd73f834169bb03ceb2e832f817"></a>The stored procedure <strong id="EN-US_TOPIC_0000001188482120__b154678576474">WRITEAPPEND</strong> copies contents in BUFFER to the end part of LOB according to the specified length.</p>
<p id="EN-US_TOPIC_0000001188482120__a0eeb0c4302f64beba236951369ad6eb1">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__a33455a63bd81485db569431f1e017495">DBMS_LOB.WRITEAPPEND</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__sacbda05fe8b342c8a905a5e688d13d21"><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></pre></div></td><td class="code"><div><pre><span></span><span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">WRITEAPPEND</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="n">amount</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="n">buffer</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="n">RAW</span><span class="p">);</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">WRITEAPPEND</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="k">CLOB</span><span class="p">,</span>
<span class="n">amount</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="n">buffer</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="n">VARCHAR2</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__t08eb0fde908e4417b030d2738f67cac6" frame="border" border="1" rules="all"><caption><b>Table 6 </b>DBMS_LOB.WRITEAPPEND interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__r46757926a42d47e782f0623ad88e8324"><th align="left" class="cellrowborder" valign="top" width="23.93%" id="mcps1.3.1.4.5.4.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__ac6d8526bf7ca4409a23bee5affb0f711">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="76.07000000000001%" id="mcps1.3.1.4.5.4.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__a6c83a7927fdd452181af0360f4cb1ab5">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__rd8e4d52697724799bd540336b97c5b6d"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.5.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__ac78e7c6d966a4c63bba3c390377c7a70">lob_loc</p>
</td>
<td class="cellrowborder" valign="top" width="76.07000000000001%" headers="mcps1.3.1.4.5.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__abc71f7d8f9c94486b97242e31b14552b">LOB type object to be written</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__r4029aee3e41842a29b6bf817dad5ae60"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.5.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__ada860e516939429f862ecf380d076f9e">amount</p>
</td>
<td class="cellrowborder" valign="top" width="76.07000000000001%" headers="mcps1.3.1.4.5.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a11e3934658c1465da2ba13c1e52eae55">Write data length</p>
<div class="note" id="EN-US_TOPIC_0000001188482120__n295505e9c4c34d499b461dfd148f6c34"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001188482120__a7441401aaf1145948ee319e7c0c4f530">If the write data is shorter than 1 or longer than the contents to be written, an error is reported.</p>
</div></div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__raf2dba0ab791437dafe683ac6c081131"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.5.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a0c71973958094b119bca586cf5befd5b">buffer</p>
</td>
<td class="cellrowborder" valign="top" width="76.07000000000001%" headers="mcps1.3.1.4.5.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__ab3948f08fa6d40ef998d244df7b73dd0">Content to be written</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001188482120__l2af2f8b7366643ca91559e18eaea4692"><a name="EN-US_TOPIC_0000001188482120__l2af2f8b7366643ca91559e18eaea4692"></a><a name="l2af2f8b7366643ca91559e18eaea4692"></a>DBMS_LOB.COPY<p id="EN-US_TOPIC_0000001188482120__aeddff17507414155b35ecb86fad3481b"><a name="EN-US_TOPIC_0000001188482120__l2af2f8b7366643ca91559e18eaea4692"></a><a name="l2af2f8b7366643ca91559e18eaea4692"></a>The stored procedure <strong>COPY</strong> copies contents in BLOB to another BLOB according to the specified length and initial position offset.</p>
<p id="EN-US_TOPIC_0000001188482120__a049c8d607b7e4047ab51afe8955b91dd">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__a09b68c22036340fea8deeac57d648176">DBMS_LOB.COPY</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__s62418a28fda644c1bad6abf1636fb80f"><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">DBMS_LOB</span><span class="p">.</span><span class="k">COPY</span><span class="w"> </span><span class="p">(</span>
<span class="n">dest_lob</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="n">src_lob</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="n">amount</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="n">dest_offset</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="k">DEFAULT</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
<span class="n">src_offset</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="k">DEFAULT</span><span class="w"> </span><span class="mi">1</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__tb1410d84631e49baa564de90b2a27053" frame="border" border="1" rules="all"><caption><b>Table 7 </b>DBMS_LOB.COPY interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__r49f52e7274e24d25a9a6d9395a1e3ef0"><th align="left" class="cellrowborder" valign="top" width="24.060000000000002%" id="mcps1.3.1.4.6.4.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__a6e0e348ec5e54f13a714987073dec64f">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="75.94%" id="mcps1.3.1.4.6.4.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__a11438558ce794708951ab7c3d2c28ab3">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__r43b0f3447bd844ec9a22900c3cc1c030"><td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.3.1.4.6.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a8cf669e22dec4017aeca8241257ef503">dest_lob</p>
</td>
<td class="cellrowborder" valign="top" width="75.94%" headers="mcps1.3.1.4.6.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__ad89cd55fe83244aea3b60e403b8b0a66">BLOB type object to be pasted</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__rbb96e7e6ea884d8baec584fe48726e19"><td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.3.1.4.6.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a8ab72b6357c74afbaff2d4e48ed78e1b">src_lob</p>
</td>
<td class="cellrowborder" valign="top" width="75.94%" headers="mcps1.3.1.4.6.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__ac9789c6b5df64d5b951fe743b8121797">BLOB type object to be copied</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__r7eb29a2637cb4ec9b600c926893b1d77"><td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.3.1.4.6.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__ad5279cc2ee3e437e926f0527c89b45b8">amount</p>
</td>
<td class="cellrowborder" valign="top" width="75.94%" headers="mcps1.3.1.4.6.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__ae609994b5912489c95896c12ed4c21f7">Length of the copied data</p>
<div class="note" id="EN-US_TOPIC_0000001188482120__n1768087ed57f4de89208b9e990ce4bc3"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001188482120__a9cce788f3ccc4b0ebff5c1a7a9c2ed81">If the copied data is shorter than 1 or longer than the maximum length of BLOB type contents, an error is reported.</p>
</div></div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__r9a3b59e47a864c1f8d47ffb05ecc7643"><td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.3.1.4.6.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__ac96e733e55394a8ca53839c4c7ea9bdb">dest_offset</p>
</td>
<td class="cellrowborder" valign="top" width="75.94%" headers="mcps1.3.1.4.6.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a01f0852f29744b18840da754a402134c">Indicates where to start pasting the BLOB contents, that is, the offset bytes to initial position of BLOB contents.</p>
<div class="note" id="EN-US_TOPIC_0000001188482120__nb0cc1fe1abb0496991aa62e25d9f2ec8"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001188482120__a1b168550207348bb98b0181f64c55b8d">If the offset is shorter than 1 or longer than the maximum length of BLOB type contents, an error is reported.</p>
</div></div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__rf7576f65920c4d34a2490635c07756c0"><td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.3.1.4.6.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__aa10610b7c0c84b0b8dadd8ed7374af8f">src_offset</p>
</td>
<td class="cellrowborder" valign="top" width="75.94%" headers="mcps1.3.1.4.6.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a34225eba566d416b9aca5831e26e919d">Indicates where to start copying the BLOB contents, that is, the offset bytes to initial position of BLOB contents.</p>
<div class="note" id="EN-US_TOPIC_0000001188482120__n237ece9fea684023a01947bc0fcd3953"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001188482120__a22e94c7d7fc848c5be66e30715962d63">If the offset is shorter than 1 or longer than the length of source BLOB, an error is reported.</p>
</div></div>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001188482120__l8d03841cf8fb4c4b899a356efcb34f0e"><a name="EN-US_TOPIC_0000001188482120__l8d03841cf8fb4c4b899a356efcb34f0e"></a><a name="l8d03841cf8fb4c4b899a356efcb34f0e"></a>DBMS_LOB.ERASE<p id="EN-US_TOPIC_0000001188482120__ad8deed1369ec4fb6a047dfb77d8caa9e"><a name="EN-US_TOPIC_0000001188482120__l8d03841cf8fb4c4b899a356efcb34f0e"></a><a name="l8d03841cf8fb4c4b899a356efcb34f0e"></a>The stored procedure <strong>ERASE</strong> deletes contents in BLOB according to the specified length and initial position offset.</p>
<p id="EN-US_TOPIC_0000001188482120__ac5861a88427b44cc883193c598a5b5b8">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__a010532359755466eb2f13bc6fdf8a078">DBMS_LOB.ERASE</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__sbd242a9d108849388a7758f727932514"><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></pre></div></td><td class="code"><div><pre><span></span><span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">ERASE</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="n">amount</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="k">offset</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="k">DEFAULT</span><span class="w"> </span><span class="mi">1</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__t8a333b5393484014b8f8d74693630bd4" frame="border" border="1" rules="all"><caption><b>Table 8 </b>DBMS_LOB.ERASE interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__rcd78068eb2ba48199fcc7a8b574e32ec"><th align="left" class="cellrowborder" valign="top" width="23.93%" id="mcps1.3.1.4.7.4.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__aa1752f472adf488db30e798f396a8342">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="76.07000000000001%" id="mcps1.3.1.4.7.4.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__a60b950448dc1411eb1f0d17e77dedae2">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__r35af73ff612f48e88951ad76bfc534b9"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.7.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a45b82d632176464ba792d2672670974f">lob_loc</p>
</td>
<td class="cellrowborder" valign="top" width="76.07000000000001%" headers="mcps1.3.1.4.7.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a3e5d92c65dcb4baa8740e916ee4b84fc">BLOB type object whose contents are to be deleted</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__r460abd51477a4bf4a6338670c98c2035"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.7.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a680f1fe716004743ab0ab2fa1b7ec754">amount</p>
</td>
<td class="cellrowborder" valign="top" width="76.07000000000001%" headers="mcps1.3.1.4.7.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__aead7baf1f58c4b6cb8268f35a07d2460">Length of contents to be deleted</p>
<div class="note" id="EN-US_TOPIC_0000001188482120__nd0fdb260947c43868e91d639b0bc8eb3"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001188482120__a58bd5573cbeb4487a35bb3b30e11dcbe">If the deleted data is shorter than 1 or longer than the maximum length of BLOB type contents, an error is reported.</p>
</div></div>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__r55984a8fb7214e91a3025372895ab113"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.7.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a7d2547b4f48c429dbc45b23f62db6540">offset</p>
</td>
<td class="cellrowborder" valign="top" width="76.07000000000001%" headers="mcps1.3.1.4.7.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__a016cd1dea5aa49d19cbcc1c3a296ae77">Indicates where to start deleting the BLOB contents, that is, the offset bytes to initial position of BLOB contents.</p>
<div class="note" id="EN-US_TOPIC_0000001188482120__n998c736669ba46c982c0f78512a11809"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001188482120__a119d8d65005745fbabc32ac2291aa77b">If the offset is shorter than 1 or longer than the maximum length of BLOB type contents, an error is reported.</p>
</div></div>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001188482120__l7c19cc51b2fd4a87a5702b94aa19b53b">DBMS_LOB.CLOSE<p id="EN-US_TOPIC_0000001188482120__a4fd2de11d4c941b8aee36e4685c65393"><a name="EN-US_TOPIC_0000001188482120__l7c19cc51b2fd4a87a5702b94aa19b53b"></a><a name="l7c19cc51b2fd4a87a5702b94aa19b53b"></a>The procedure <strong id="EN-US_TOPIC_0000001188482120__b842352706103756">CLOSE</strong> disables the enabled contents of LOB according to the specified length and initial position offset.</p>
<p id="EN-US_TOPIC_0000001188482120__adf228fda3fb943378103fae049225296">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__en-us_topic_0027042944_b42498624164155">DBMS_LOB.CLOSE</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__s3e3c675fd4e644299e081cc11cb3f7e2"><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="n">DBMS_LOB</span><span class="p">.</span><span class="k">CLOSE</span><span class="p">(</span>
<span class="n">src_lob</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">);</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="k">CLOSE</span><span class="w"> </span><span class="p">(</span>
<span class="n">src_lob</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">CLOB</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001188482120__ta292aad6be2b4dfcb2cc8efe0c540879"></a><a name="ta292aad6be2b4dfcb2cc8efe0c540879"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__ta292aad6be2b4dfcb2cc8efe0c540879" frame="border" border="1" rules="all"><caption><b>Table 9 </b>DBMS_LOB.CLOSE interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__r71d819dc619e4e0882bb831c4053032b"><th align="left" class="cellrowborder" valign="top" width="23.93%" id="mcps1.3.1.4.8.4.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__acfa1bf9b97334074907978628125e35a">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="76.07000000000001%" id="mcps1.3.1.4.8.4.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__a505215963c214639b095d61ff79b793d">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__rc3796fc9fd19458eaecdcb0455f0b363"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.8.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__a6380493fb833489ab320bd006e0ca494">src_loc</p>
</td>
<td class="cellrowborder" valign="top" width="76.07000000000001%" headers="mcps1.3.1.4.8.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__ae36b3f8bcdb4404c8d758ce9f31b2458">LOB type object to be disabled</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001188482120__li1442318419148"><a name="EN-US_TOPIC_0000001188482120__li1442318419148"></a><a name="li1442318419148"></a>DBMS_LOB.INSTR<p id="EN-US_TOPIC_0000001188482120__p5673152213264"><a name="EN-US_TOPIC_0000001188482120__li1442318419148"></a><a name="li1442318419148"></a>This function returns the Nth occurrence position in LOB. If invalid values are entered, <strong id="EN-US_TOPIC_0000001188482120__b87571550824">NULL</strong> is returned. The invalid values include offset &lt; 1 or offset &gt; LOBMAXSIZE, nth &lt; 1, and nth &gt; LOBMAXSIZE.</p>
<p id="EN-US_TOPIC_0000001188482120__p29978211262">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__b9841718192219">DBMS_LOB.INSTR</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__screen99975218265"><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="n">DBMS_LOB</span><span class="p">.</span><span class="n">INSTR</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="n">pattern</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="n">RAW</span><span class="p">,</span>
<span class="k">offset</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
<span class="n">nth</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">)</span>
<span class="k">RETURN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">;</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">INSTR</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">CLOB</span><span class="p">,</span>
<span class="n">pattern</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="k">offset</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
<span class="n">nth</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">)</span>
<span class="k">RETURN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__table2099872182618" frame="border" border="1" rules="all"><caption><b>Table 10 </b>DBMS_LOB.INSTR interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__row1799812213261"><th align="left" class="cellrowborder" valign="top" width="24.16%" id="mcps1.3.1.4.9.4.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__p89981721142613">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="75.84%" id="mcps1.3.1.4.9.4.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__p18998102120263">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__row899832162618"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p12998821142614">lob_loc</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p149987213263">LOB descriptor to be searched for</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row119983217261"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p2099842118265">pattern</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p20998172122617">Matched pattern. It is RAW for BLOB and TEXT for CLOB.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row1099802172618"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p1998142172620">offset</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p299812216268">For BLOB, the absolute offset is in the unit of byte. For CLOB, the offset is in the unit of character. The matching start position is 1.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row999882142618"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.9.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p7998172115263">nth</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.9.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p19981721102611">Number of pattern matching times. The minimum value is 1.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001188482120__li19579245181414"><a name="EN-US_TOPIC_0000001188482120__li19579245181414"></a><a name="li19579245181414"></a>DBMS_LOB.COMPARE<p id="EN-US_TOPIC_0000001188482120__p452831214474"><a name="EN-US_TOPIC_0000001188482120__li19579245181414"></a><a name="li19579245181414"></a>This function compares two LOBs or a certain part of two LOBs.</p>
<ul id="EN-US_TOPIC_0000001188482120__ul11440250174716"><li id="EN-US_TOPIC_0000001188482120__li1311164113479">If the two parts are equal, <strong id="EN-US_TOPIC_0000001188482120__b1337755010195">0</strong> is returned. Otherwise, a non-zero value is returned.</li><li id="EN-US_TOPIC_0000001188482120__li91234194713">If the first CLOB is smaller than the second, <strong id="EN-US_TOPIC_0000001188482120__b10192125420224">-1</strong> is returned. If the first CLOB is larger than the second, <strong id="EN-US_TOPIC_0000001188482120__b1372270142316">1</strong> is returned.</li><li id="EN-US_TOPIC_0000001188482120__li114441184715">If any of the <strong id="EN-US_TOPIC_0000001188482120__b32559326243">amount</strong>, <strong id="EN-US_TOPIC_0000001188482120__b1844636132417">offset_1</strong>, and <strong id="EN-US_TOPIC_0000001188482120__b12285945112415">offset_2</strong> parameters is invalid, <strong id="EN-US_TOPIC_0000001188482120__b181132262510">NULL</strong> is returned. The valid offset range is 1 to LOBMAXSIZE.</li></ul>
<p id="EN-US_TOPIC_0000001188482120__p757913456148">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__en-us_topic_0027042944_b63533039165427_3">DBMS_LOB.READ</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__screen4579245181410"><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>
<span class="normal">14</span>
<span class="normal">15</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">COMPARE</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_1</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="n">lob_2</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="n">amount</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">LOBMAXSIZE</span><span class="p">,</span>
<span class="n">offset_1</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
<span class="n">offset_2</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">)</span>
<span class="k">RETURN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">;</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">COMPARE</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_1</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">CLOB</span><span class="p">,</span>
<span class="n">lob_2</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">CLOB</span><span class="p">,</span>
<span class="n">amount</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">LOBMAXSIZE</span><span class="p">,</span>
<span class="n">offset_1</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>
<span class="n">offset_2</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">)</span>
<span class="k">RETURN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<div class="p" id="EN-US_TOPIC_0000001188482120__p113851832482">
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__table487213584473" frame="border" border="1" rules="all"><caption><b>Table 11 </b>DBMS_LOB.COMPARE interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__row15871165810477"><th align="left" class="cellrowborder" valign="top" width="24.16%" id="mcps1.3.1.4.10.5.1.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__p3871358194716">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="75.84%" id="mcps1.3.1.4.10.5.1.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__p787145818474">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__row58711158184710"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.10.5.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p118711358104714">lob_1</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.10.5.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p138719588476">First LOB descriptor to be compared</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row20871658114713"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.10.5.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p1587115582471">lob_2</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.10.5.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p1887112583473">Second LOB descriptor to be compared</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row19871145844719"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.10.5.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p98711958144712">amount</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.10.5.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p1887135813477">Number of characters or bytes to be compared. The maximum value is DBMS_LOB.LOBMAXSIZE.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row118711258144712"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.10.5.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p1987135810478">offset_1</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.10.5.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p587195820476">Offset of the first LOB descriptor. The initial position is 1.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row487225813474"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.10.5.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p6872205844715">offset_2</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.10.5.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p1587219587472">Offset of the second LOB descriptor. The initial position is 1.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</li><li id="EN-US_TOPIC_0000001188482120__li381175591417"><a name="EN-US_TOPIC_0000001188482120__li381175591417"></a><a name="li381175591417"></a>DBMS_LOB.SUBSTR<p id="EN-US_TOPIC_0000001188482120__p78111655181411"><a name="EN-US_TOPIC_0000001188482120__li381175591417"></a><a name="li381175591417"></a>This function reads the substring of a LOB and returns the number of read bytes or the number of characters. If amount &gt; 1, amount &lt; 32767, offset &lt; 1, or offset &gt; LOBMAXSIZE, <strong id="EN-US_TOPIC_0000001188482120__b1826317248315">NULL</strong> is returned.</p>
<p id="EN-US_TOPIC_0000001188482120__p181175591418">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__b814324732210">DBMS_LOB.SUBSTR</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__screen2811195571412"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">SUBSTR</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="n">amount</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="mi">32767</span><span class="p">,</span>
<span class="k">offset</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">)</span>
<span class="k">RETURN</span><span class="w"> </span><span class="n">RAW</span><span class="p">;</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">SUBSTR</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">CLOB</span><span class="p">,</span>
<span class="n">amount</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="mi">32767</span><span class="p">,</span>
<span class="k">offset</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="mi">1</span><span class="p">)</span>
<span class="k">RETURN</span><span class="w"> </span><span class="n">VARCHAR2</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__table1781110550149" frame="border" border="1" rules="all"><caption><b>Table 12 </b>DBMS_LOB.SUBSTR interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__row10811455121416"><th align="left" class="cellrowborder" valign="top" width="24.16%" id="mcps1.3.1.4.11.4.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__p2811105517142">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="75.84%" id="mcps1.3.1.4.11.4.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__p7811185512145">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__row1681165519141"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.11.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p781113557141">lob_loc</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.11.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p5533124682017">LOB descriptor of the substring to be read. For BLOB, the return value is the number of read bytes. For CLOB, the return value is the number of characters.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row178121755161413"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.11.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p08124559145">offset</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.11.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p125555582010">Number of bytes or characters to be read.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row281255510147"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.11.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p15812145511417">buffer</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.11.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p98129554145">Number of characters or bytes offset from the start position.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001188482120__li374125861411"><a name="EN-US_TOPIC_0000001188482120__li374125861411"></a><a name="li374125861411"></a>DBMS_LOB.TRIM<p id="EN-US_TOPIC_0000001188482120__p1774135810147"><a name="EN-US_TOPIC_0000001188482120__li374125861411"></a><a name="li374125861411"></a>This stored procedure truncates the LOB of a specified length. After this stored procedure is executed, the length of the LOB is set to the length specified by the <strong id="EN-US_TOPIC_0000001188482120__b521315115374">newlen</strong> parameter. If an empty LOB is truncated, no execution result is displayed. If the specified length is longer than the length of LOB, an exception occurs.</p>
<p id="EN-US_TOPIC_0000001188482120__p874205801415">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__b20687558152218">DBMS_LOB.TRIM</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__screen147425585147"><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="n">DBMS_LOB</span><span class="p">.</span><span class="k">TRIM</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="n">newlen</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">);</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="k">TRIM</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="k">CLOB</span><span class="p">,</span>
<span class="n">newlen</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__table1674295861410" frame="border" border="1" rules="all"><caption><b>Table 13 </b>DBMS_LOB.TRIM interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__row2742135813147"><th align="left" class="cellrowborder" valign="top" width="13.530000000000001%" id="mcps1.3.1.4.12.4.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__p1374245871417">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="86.47%" id="mcps1.3.1.4.12.4.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__p187424583145">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__row177421858201416"><td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.1.4.12.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p3742758161414">lob_loc</p>
</td>
<td class="cellrowborder" valign="top" width="86.47%" headers="mcps1.3.1.4.12.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p674245891415">BLOB type object to be read</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row2713918239"><td class="cellrowborder" valign="top" width="13.530000000000001%" headers="mcps1.3.1.4.12.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p13715913234">newlen</p>
</td>
<td class="cellrowborder" valign="top" width="86.47%" headers="mcps1.3.1.4.12.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p27119192316">After truncation, the new LOB length for BLOB is in the unit of byte and that for CLOB is in the unit of character.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001188482120__li145817213157"><a name="EN-US_TOPIC_0000001188482120__li145817213157"></a><a name="li145817213157"></a>DBMS_LOB.CREATETEMPORARY<p id="EN-US_TOPIC_0000001188482120__p155810271518"><a name="EN-US_TOPIC_0000001188482120__li145817213157"></a><a name="li145817213157"></a>This stored procedure creates a temporary BLOB or CLOB and is used only for syntax compatibility.</p>
<p id="EN-US_TOPIC_0000001188482120__p758121156">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__b39306816239">DBMS_LOB.CREATETEMPORARY</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__screen8581426151"><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></pre></div></td><td class="code"><div><pre><span></span><span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">CREATETEMPORARY</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="k">cache</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">BOOLEAN</span><span class="p">,</span>
<span class="n">dur</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">);</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">CREATETEMPORARY</span><span class="w"> </span><span class="p">(</span>
<span class="n">lob_loc</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="k">CLOB</span><span class="p">,</span>
<span class="k">cache</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">BOOLEAN</span><span class="p">,</span>
<span class="n">dur</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__table75812231520" frame="border" border="1" rules="all"><caption><b>Table 14 </b>DBMS_LOB.CREATETEMPORARY interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__row558102191511"><th align="left" class="cellrowborder" valign="top" width="24.16%" id="mcps1.3.1.4.13.4.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__p85817221510">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="75.84%" id="mcps1.3.1.4.13.4.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__p55916219156">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__row259172111510"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.13.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p259142141511">lob_loc</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.13.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p20591251511">LOB descriptor</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row14591928154"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.13.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p1259729157">cache</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.13.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p1559182181518">This parameter is used only for syntax compatibility.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row1159142131516"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.13.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p0606251512">dur</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.13.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p13607201514">This parameter is used only for syntax compatibility.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001188482120__li194203411159"><a name="EN-US_TOPIC_0000001188482120__li194203411159"></a><a name="li194203411159"></a>DBMS_LOB.APPEND<p id="EN-US_TOPIC_0000001188482120__p44217481520"><a name="EN-US_TOPIC_0000001188482120__li194203411159"></a><a name="li194203411159"></a>The stored procedure <strong id="EN-US_TOPIC_0000001188482120__b16907163264212">READ</strong> loads a part of BLOB contents to BUFFER according to the specified length and initial position offset.</p>
<p id="EN-US_TOPIC_0000001188482120__p19421343152">The function prototype of <strong id="EN-US_TOPIC_0000001188482120__b197613204238">DBMS_LOB.APPEND</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__screen1642116414156"><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="n">DBMS_LOB</span><span class="p">.</span><span class="n">APPEND</span><span class="w"> </span><span class="p">(</span>
<span class="n">dest_lob</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="n">src_lob</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">);</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">APPEND</span><span class="w"> </span><span class="p">(</span>
<span class="n">dest_lob</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">OUT</span><span class="w"> </span><span class="k">CLOB</span><span class="p">,</span>
<span class="n">src_lob</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="k">CLOB</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001188482120__table1342104191512" frame="border" border="1" rules="all"><caption><b>Table 15 </b>DBMS_LOB.APPEND interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001188482120__row94210431515"><th align="left" class="cellrowborder" valign="top" width="24.16%" id="mcps1.3.1.4.14.4.2.3.1.1"><p id="EN-US_TOPIC_0000001188482120__p94211245157">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="75.84%" id="mcps1.3.1.4.14.4.2.3.1.2"><p id="EN-US_TOPIC_0000001188482120__p1942164141513">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001188482120__row142164181515"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.14.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p5421543156">dest_lob</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.14.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p12421124101512">LOB descriptor to be written</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001188482120__row0422544158"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.14.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001188482120__p2042254201511">src_lob</p>
</td>
<td class="cellrowborder" valign="top" width="75.84%" headers="mcps1.3.1.4.14.4.2.3.1.2 "><p id="EN-US_TOPIC_0000001188482120__p1542234191510">LOB descriptor to be read</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001188482120__scad6aa5ed9de4152af44ac6c2c74f716"><h4 class="sectiontitle">Examples</h4><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001188482120__s5a392acf863d442ea090fac4b3b795e9"><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>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span>
<span class="normal">23</span>
<span class="normal">24</span>
<span class="normal">25</span>
<span class="normal">26</span>
<span class="normal">27</span>
<span class="normal">28</span>
<span class="normal">29</span>
<span class="normal">30</span>
<span class="normal">31</span>
<span class="normal">32</span>
<span class="normal">33</span>
<span class="normal">34</span>
<span class="normal">35</span>
<span class="normal">36</span>
<span class="normal">37</span>
<span class="normal">38</span>
<span class="normal">39</span>
<span class="normal">40</span>
<span class="normal">41</span>
<span class="normal">42</span>
<span class="normal">43</span>
<span class="normal">44</span>
<span class="normal">45</span>
<span class="normal">46</span>
<span class="normal">47</span>
<span class="normal">48</span>
<span class="normal">49</span>
<span class="normal">50</span>
<span class="normal">51</span>
<span class="normal">52</span></pre></div></td><td class="code"><div><pre><span></span><span class="c1">-- Obtain the length of the character string.</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">GETLENGTH</span><span class="p">(</span><span class="s1">'12345678'</span><span class="p">);</span>
<span class="k">DECLARE</span>
<span class="n">myraw</span><span class="w"> </span><span class="n">RAW</span><span class="p">(</span><span class="mi">100</span><span class="p">);</span>
<span class="n">amount</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="mi">2</span><span class="p">;</span>
<span class="n">buffer</span><span class="w"> </span><span class="nb">INTEGER</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="mi">1</span><span class="p">;</span>
<span class="k">begin</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="k">READ</span><span class="p">(</span><span class="s1">'123456789012345'</span><span class="p">,</span><span class="n">amount</span><span class="p">,</span><span class="n">buffer</span><span class="p">,</span><span class="n">myraw</span><span class="p">);</span>
<span class="n">dbms_output</span><span class="p">.</span><span class="n">put_line</span><span class="p">(</span><span class="n">myraw</span><span class="p">);</span>
<span class="k">end</span><span class="p">;</span>
<span class="o">/</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">blob_Table</span><span class="w"> </span><span class="p">(</span><span class="n">t1</span><span class="w"> </span><span class="nb">blob</span><span class="p">)</span><span class="w"> </span><span class="n">DISTRIBUTE</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="n">REPLICATION</span><span class="p">;</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">blob_Table_bak</span><span class="w"> </span><span class="p">(</span><span class="n">t2</span><span class="w"> </span><span class="nb">blob</span><span class="p">)</span><span class="w"> </span><span class="n">DISTRIBUTE</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="n">REPLICATION</span><span class="p">;</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">blob_Table</span><span class="w"> </span><span class="k">VALUES</span><span class="p">(</span><span class="s1">'abcdef'</span><span class="p">);</span>
<span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">blob_Table_bak</span><span class="w"> </span><span class="k">VALUES</span><span class="p">(</span><span class="s1">'22222'</span><span class="p">);</span>
<span class="k">DECLARE</span>
<span class="n">str</span><span class="w"> </span><span class="n">varchar2</span><span class="p">(</span><span class="mi">100</span><span class="p">)</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="s1">'abcdef'</span><span class="p">;</span>
<span class="k">source</span><span class="w"> </span><span class="n">raw</span><span class="p">(</span><span class="mi">100</span><span class="p">);</span>
<span class="n">dest</span><span class="w"> </span><span class="nb">blob</span><span class="p">;</span>
<span class="n">copyto</span><span class="w"> </span><span class="nb">blob</span><span class="p">;</span>
<span class="n">amount</span><span class="w"> </span><span class="nb">int</span><span class="p">;</span>
<span class="n">PSV_SQL</span><span class="w"> </span><span class="n">varchar2</span><span class="p">(</span><span class="mi">100</span><span class="p">);</span>
<span class="n">PSV_SQL1</span><span class="w"> </span><span class="n">varchar2</span><span class="p">(</span><span class="mi">100</span><span class="p">);</span>
<span class="n">a</span><span class="w"> </span><span class="nb">int</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="mi">1</span><span class="p">;</span>
<span class="n">len</span><span class="w"> </span><span class="nb">int</span><span class="p">;</span>
<span class="k">BEGIN</span>
<span class="k">source</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="n">utl_raw</span><span class="p">.</span><span class="n">cast_to_raw</span><span class="p">(</span><span class="n">str</span><span class="p">);</span>
<span class="n">amount</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="n">utl_raw</span><span class="p">.</span><span class="k">length</span><span class="p">(</span><span class="k">source</span><span class="p">);</span>
<span class="n">PSV_SQL</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="s1">'select * from blob_Table for update'</span><span class="p">;</span>
<span class="n">PSV_SQL1</span><span class="w"> </span><span class="p">:</span><span class="o">=</span><span class="w"> </span><span class="s1">'select * from blob_Table_bak for update'</span><span class="p">;</span>
<span class="k">EXECUTE</span><span class="w"> </span><span class="k">IMMEDIATE</span><span class="w"> </span><span class="n">PSV_SQL</span><span class="w"> </span><span class="k">into</span><span class="w"> </span><span class="n">dest</span><span class="p">;</span>
<span class="k">EXECUTE</span><span class="w"> </span><span class="k">IMMEDIATE</span><span class="w"> </span><span class="n">PSV_SQL1</span><span class="w"> </span><span class="k">into</span><span class="w"> </span><span class="n">copyto</span><span class="p">;</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="k">WRITE</span><span class="p">(</span><span class="n">dest</span><span class="p">,</span><span class="w"> </span><span class="n">amount</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w"> </span><span class="k">source</span><span class="p">);</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">WRITEAPPEND</span><span class="p">(</span><span class="n">dest</span><span class="p">,</span><span class="w"> </span><span class="n">amount</span><span class="p">,</span><span class="w"> </span><span class="k">source</span><span class="p">);</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="n">ERASE</span><span class="p">(</span><span class="n">dest</span><span class="p">,</span><span class="w"> </span><span class="n">a</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">);</span>
<span class="n">DBMS_OUTPUT</span><span class="p">.</span><span class="n">PUT_LINE</span><span class="p">(</span><span class="n">a</span><span class="p">);</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="k">COPY</span><span class="p">(</span><span class="n">copyto</span><span class="p">,</span><span class="w"> </span><span class="n">dest</span><span class="p">,</span><span class="w"> </span><span class="n">amount</span><span class="p">,</span><span class="w"> </span><span class="mi">10</span><span class="p">,</span><span class="w"> </span><span class="mi">1</span><span class="p">);</span>
<span class="n">DBMS_LOB</span><span class="p">.</span><span class="k">CLOSE</span><span class="p">(</span><span class="n">dest</span><span class="p">);</span>
<span class="k">RETURN</span><span class="p">;</span>
<span class="k">END</span><span class="p">;</span>
<span class="o">/</span>
<span class="c1">--Delete the table.</span>
<span class="k">DROP</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">blob_Table</span><span class="p">;</span>
<span class="k">DROP</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">blob_Table_bak</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_04_0550.html">Advanced Packages</a></div>
</div>
</div>
View Git Blame Copy Permalink