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 ef0ada5a59 DWS DEV 20240716 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-11-02 09:07:47 +00:00

856 lines
90 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001510283745"></a><a name="EN-US_TOPIC_0000001510283745"></a>
<h1 class="topictitle1">DBMS_LOB</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001510283745__s37b0a3d6966a4957a5658a2639f8f373"><h4 class="sectiontitle">Related Interfaces</h4><p id="EN-US_TOPIC_0000001510283745__afa5e525917b342d4af86ca64f01a72b8"><a href="#EN-US_TOPIC_0000001510283745__tffbf9cab696e4f679111cf4cdc7b0647">Table 1</a> provides all interfaces supported by the <strong id="EN-US_TOPIC_0000001510283745__b553917197418">DBMS_LOB</strong> package.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001510283745__tffbf9cab696e4f679111cf4cdc7b0647"></a><a name="tffbf9cab696e4f679111cf4cdc7b0647"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001510283745__tffbf9cab696e4f679111cf4cdc7b0647" frame="border" border="1" rules="all"><caption><b>Table 1 </b>DBMS_LOB</caption><thead align="left"><tr id="EN-US_TOPIC_0000001510283745__r3e70ea3db0c04371a32de1f6b34d857c"><th align="left" class="cellrowborder" valign="top" width="35.93%" id="mcps1.3.1.3.2.3.1.1"><p id="EN-US_TOPIC_0000001510283745__a693807b403cc4e20a56bc03dcca65e94">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_0000001510283745__a34cb668b508642138e730de5847d1bbb">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__r3912c2a46599419798f3bc2b3c33891c"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a85ac496ae5c1468090f902072d3c82af"><a href="#EN-US_TOPIC_0000001510283745__lf95449ac7b1a483fbfdd7a4691c9757a">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_0000001510283745__a04ed9b247a634f639d8441fb1410a853">Obtains and returns the specified length of a LOB object.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__row1487315436182"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__p158745430183"><a href="#EN-US_TOPIC_0000001510283745__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_0000001510283745__p787414318189">Opens a LOB and returns a LOB descriptor.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__ra72c57dc3b974a41b3dc802e5847cd23"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a76034ec54af1474c8e573517ba883be8"><a href="#EN-US_TOPIC_0000001510283745__l56b5fffb69d74008bc3bad24a0ab1955">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_0000001510283745__ac60a8f95210549d69b2f711ff9a9c5e1">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_0000001510283745__r7239d1178942483cb54592e129862cfa"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a57219a54067a4b09bd5591d283e0be52"><a href="#EN-US_TOPIC_0000001510283745__lb4305a39ac30402496fbaf5f0f07675d">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_0000001510283745__a7e24c892b88f4050933a0b710d40e055">Copies contents in BUFFER area to LOB according to the specified length and initial position offset.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__r607d5a76973c4ffb860a38cfd3427489"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a80c52137d5de4a70ac52101cb45d2ea4"><a href="#EN-US_TOPIC_0000001510283745__led481795fbe5451ea116f59315730865">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_0000001510283745__a560a99ac661147b8a38664d29dfddc12">Copies contents in BUFFER area to the end part of LOB according to the specified length.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__r6336b3c26f81456f9c329e789a5a5ded"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a09bbb7bfb30f49408207b19966056dfc"><a href="#EN-US_TOPIC_0000001510283745__l7dc53dfc34c7425bbb06c63735c30313">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_0000001510283745__ae03db274eb5f4d3faf8e1d369401c301">Copies contents in BLOB to another BLOB according to the specified length and initial position offset.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__rd3ada0c9475c4614b6734e25a09ce94f"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a2fae5a1be5df4a1a9e7609a8a50e70e7"><a href="#EN-US_TOPIC_0000001510283745__l0a15b6d3dc424ef6b5a7785938a17585">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_0000001510283745__a13eb5deedf984e44bbef0351d6a73c60">Deletes contents in BLOB according to the specified length and initial position offset.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__rb087744655c74cfe840010fa13f9902c"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__aac5450a1df01441887ded777dd48fdb3"><a href="#EN-US_TOPIC_0000001510283745__tb7117685db7e49b6866f679b1b43a8ac">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_0000001510283745__a9b7f8de1e31b483aa88d2ca2e162ba46">Closes a LOB descriptor.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__row68011725104"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__p108021628103"><a href="#EN-US_TOPIC_0000001510283745__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_0000001510283745__p1680210261014">Returns the position of the Nth occurrence of a character string in LOB.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__row076195215166"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__p1676155281616"><a href="#EN-US_TOPIC_0000001510283745__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_0000001510283745__p976852141611">Compares two LOBs or a certain part of two LOBs.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__row6889194715168"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__p108892479161"><a href="#EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__row2672173512167"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__p1267263519162"><a href="#EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__b922155233917">newlen</strong> parameter.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__row235685818184"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__p113563582185"><a href="#EN-US_TOPIC_0000001510283745__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_0000001510283745__p1928175419583">Creates a temporary BLOB or CLOB.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__row54322157196"><td class="cellrowborder" valign="top" width="35.93%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__p15433815161912"><a href="#EN-US_TOPIC_0000001510283745__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_0000001510283745__p112141156125815">Adds the content of a LOB to another LOB.</p>
</td>
</tr>
</tbody>
</table>
</div>
<ul id="EN-US_TOPIC_0000001510283745__uceeb34fd095a4f02a4a1622e4d2fdf2f"><li id="EN-US_TOPIC_0000001510283745__lf95449ac7b1a483fbfdd7a4691c9757a"><a name="EN-US_TOPIC_0000001510283745__lf95449ac7b1a483fbfdd7a4691c9757a"></a><a name="lf95449ac7b1a483fbfdd7a4691c9757a"></a>DBMS_LOB.GETLENGTH<p id="EN-US_TOPIC_0000001510283745__acbbd0f93c55a4457aadc3d240ffd54ae"><a name="EN-US_TOPIC_0000001510283745__lf95449ac7b1a483fbfdd7a4691c9757a"></a><a name="lf95449ac7b1a483fbfdd7a4691c9757a"></a>Specifies the length of a LOB type object obtained and returned by the stored procedure <strong id="EN-US_TOPIC_0000001510283745__en-us_topic_0027042944_b21642217104359">GETLENGTH</strong>.</p>
<p id="EN-US_TOPIC_0000001510283745__ab41da71d25644ad68334e607f9c545e9">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__en-us_topic_0027042944_b63533039165427_1">DBMS_LOB.GETLENGTH</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__s90d7459664aa4a91bc57b33a56e23322"><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_0000001510283745__t14324b1486ed4a9bbced43bb46fc555c" 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_0000001510283745__ra9b40bc725214407a4a7fb670b940312"><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_0000001510283745__a69fc371f71234b4b832ad5a8f9a936d1">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_0000001510283745__a59e47839bda24aa397c2f2ee9f3ce2b6">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__rd08c7de9a47e4ceaa56c8714a4d3b89e"><td class="cellrowborder" valign="top" width="23.05%" headers="mcps1.3.1.4.1.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__aa34c660eb4144a178341c90e5ef0fbfe">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_0000001510283745__a0a048726b4ab4a8594c96920fea7becb">LOB type object whose length is to be obtained</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001510283745__li7581543191913"><a name="EN-US_TOPIC_0000001510283745__li7581543191913"></a><a name="li7581543191913"></a>DBMS_LOB.OPEN<p id="EN-US_TOPIC_0000001510283745__p2581104315192"><a name="EN-US_TOPIC_0000001510283745__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_0000001510283745__p1058120430190">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__b117322133410">DBMS_LOB.OPEN</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__p175832434192">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p458364351913">BLOB or CLOB descriptor that is opened</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p106175463262">Open mode (currently, DBMS_LOB.LOB_READWRITE is supported)</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001510283745__l56b5fffb69d74008bc3bad24a0ab1955"><a name="EN-US_TOPIC_0000001510283745__l56b5fffb69d74008bc3bad24a0ab1955"></a><a name="l56b5fffb69d74008bc3bad24a0ab1955"></a>DBMS_LOB.READ<p id="EN-US_TOPIC_0000001510283745__ae3ef58d3f77e4090b7aa5b96c27c8f01"><a name="EN-US_TOPIC_0000001510283745__l56b5fffb69d74008bc3bad24a0ab1955"></a><a name="l56b5fffb69d74008bc3bad24a0ab1955"></a>The stored procedure <strong id="EN-US_TOPIC_0000001510283745__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_0000001510283745__ace91fef9b8504bda88f543eb44b40684">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__en-us_topic_0027042944_b63533039165427_3">DBMS_LOB.READ</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__s535783f8c96e446e89949fa6eb13959d"><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_0000001510283745__t3be8bef6c6814e90a27bbb9bf988fcb8" 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_0000001510283745__red5a324c9d5f4924b2da82d7ef36a03d"><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_0000001510283745__a4b4da56e46bf4667b5263ac2cd503fbe">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_0000001510283745__a63f83c3a75bb4d0da8e9f9ba2a327a12">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__r31540dd0b40a42b788495fa88aa48cb2"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.3.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a2a1a7b66146349dda4acb5825bf05c4a">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_0000001510283745__ae88e6c9e74e84e85aefa4889a1237e9f">LOB type object to be loaded</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__rddf3a0e6a79c4d249bc92f9953b6015b"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.3.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__afa66dd9555804b918acb4c48afd71838">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_0000001510283745__aef279dee231d45b7ab3ecb5c1fa62161">Load data length</p>
<div class="note" id="EN-US_TOPIC_0000001510283745__n693407de8ce94d12a769c976e68ea98a"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001510283745__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_0000001510283745__rb4f0c74380e94c4fa8439a5218405779"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.3.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__afed189cb505f45e5a174e4d7cc123ee1">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_0000001510283745__a77c534ea622e4b49947de15719912004">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_0000001510283745__r7032a0d2b0e64fbbb65e81691d51bbbc"><td class="cellrowborder" valign="top" width="24.16%" headers="mcps1.3.1.4.3.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a8cd99de966934647aeb06fdbb7bee9ea">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_0000001510283745__af55609d3d8c949789ad499b8e9019dd7">Target buffer to store the loaded LOB contents</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001510283745__lb4305a39ac30402496fbaf5f0f07675d"><a name="EN-US_TOPIC_0000001510283745__lb4305a39ac30402496fbaf5f0f07675d"></a><a name="lb4305a39ac30402496fbaf5f0f07675d"></a>DBMS_LOB.WRITE<p id="EN-US_TOPIC_0000001510283745__a738edfcb196d4e9685060266b6f7d8c8"><a name="EN-US_TOPIC_0000001510283745__lb4305a39ac30402496fbaf5f0f07675d"></a><a name="lb4305a39ac30402496fbaf5f0f07675d"></a>The stored procedure <strong id="EN-US_TOPIC_0000001510283745__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_0000001510283745__a63108f3c978842b7b258fa36dda4b223">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__en-us_topic_0027042944_b63533039165427_5">DBMS_LOB.WRITE</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__s3a816ddd4b984b4ba5dafe1db78aee21"><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_0000001510283745__ta7241a7b6a5c49dea377b1b1fb6b97e7" 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_0000001510283745__rd1281a5cf3ba47599e72bf92a7dea7e2"><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_0000001510283745__abb3022ac868b4e5fa07ac31878aaa3ca">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_0000001510283745__a08975e4c107143eb8fa2938257a8ef1a">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__r0f9883bacdec4a1f9e2c6dd9fc3ac9bf"><td class="cellrowborder" valign="top" width="24.18%" headers="mcps1.3.1.4.4.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__ac041b1f4163244fa8f62b6964838c9a4">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_0000001510283745__a6e705254958d410592932698aea7e0ba">LOB type object to be written</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__ra2140b77d16442a6b55a4a44003c8748"><td class="cellrowborder" valign="top" width="24.18%" headers="mcps1.3.1.4.4.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__ab6ce0ba88a244c46823c61c8dcc41967">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_0000001510283745__a1f30f9b0a2aa4c64aa6c37a82c7e486c">Write data length</p>
<div class="note" id="EN-US_TOPIC_0000001510283745__n24836e8c87a444009d37832695714dd1"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001510283745__ac4ec169122734d518ca88fabefd916d2">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_0000001510283745__ra099b90a1f1c4a2395e64535802a1c72"><td class="cellrowborder" valign="top" width="24.18%" headers="mcps1.3.1.4.4.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a38bc01feffaf42379f6ca4c05121b4cb">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_0000001510283745__a7073f244e81141fc88aaf572809b9aef">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_0000001510283745__n75d52c2eab1a4b3e984a3c083bf325f0"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001510283745__abcee88f4470640e6902fbdae02781844">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_0000001510283745__r19a9d05e442541c6994f28598e0bd7f1"><td class="cellrowborder" valign="top" width="24.18%" headers="mcps1.3.1.4.4.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a317e652a90de4fee88a525f18aaeeb03">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_0000001510283745__ab49b8775ea654c1897a30f764cee8d12">Content to be written</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001510283745__led481795fbe5451ea116f59315730865"><a name="EN-US_TOPIC_0000001510283745__led481795fbe5451ea116f59315730865"></a><a name="led481795fbe5451ea116f59315730865"></a>DBMS_LOB.WRITEAPPEND<p id="EN-US_TOPIC_0000001510283745__ad9c5d5b354a544139f6d94f669d82734"><a name="EN-US_TOPIC_0000001510283745__led481795fbe5451ea116f59315730865"></a><a name="led481795fbe5451ea116f59315730865"></a>The stored procedure <strong id="EN-US_TOPIC_0000001510283745__b154678576474">WRITEAPPEND</strong> copies contents in BUFFER to the end part of LOB according to the specified length.</p>
<p id="EN-US_TOPIC_0000001510283745__a56ad0b9a03c3467db597708d5121ad88">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__en-us_topic_0027042944_b63533039165427_7">DBMS_LOB.WRITEAPPEND</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__s867aae5c66c74c468fbd711a72af979f"><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_0000001510283745__tf5b06a28456f4b16841e3ff395a12a58" 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_0000001510283745__rd9581d1529b541829ebdb347d16d4770"><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_0000001510283745__ae4c364b8d16d4be391afe477146d5f5e">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_0000001510283745__ab9826fb0ed844d4782e1fa311ddb5ee1">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__rb6e0193be42a42fa8ef84c25568e26ad"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.5.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a65547471ac004a349f2096e4ab091928">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_0000001510283745__af4e6b75f13404d959cbc72274787b547">LOB type object to be written</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__r1181cdcc885a488aac24357b2f2cc09e"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.5.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a6a61fb71acfa4626a3f6e0a80be2fd95">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_0000001510283745__abdddc5f6d5cb4e66be5c4baccd19dae1">Write data length</p>
<div class="note" id="EN-US_TOPIC_0000001510283745__n9fb3c172a9234436bbe40cb6a614bd07"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001510283745__a86a709d57815481280a3fa9c71bee740">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_0000001510283745__r2e4f408fef7847aab4c3dadb34e142c8"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.5.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__aef3d7a43e6b44370b4da621332f3197c">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_0000001510283745__aa371fae1e3a14071904d2405fab8b620">Content to be written</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001510283745__l7dc53dfc34c7425bbb06c63735c30313"><a name="EN-US_TOPIC_0000001510283745__l7dc53dfc34c7425bbb06c63735c30313"></a><a name="l7dc53dfc34c7425bbb06c63735c30313"></a>DBMS_LOB.COPY<p id="EN-US_TOPIC_0000001510283745__a134ec115c36e4270894d52d4e9c5ec97"><a name="EN-US_TOPIC_0000001510283745__l7dc53dfc34c7425bbb06c63735c30313"></a><a name="l7dc53dfc34c7425bbb06c63735c30313"></a>The stored procedure <strong id="EN-US_TOPIC_0000001510283745__b1263717361968">COPY</strong> copies contents in BLOB to another BLOB according to the specified length and initial position offset.</p>
<p id="EN-US_TOPIC_0000001510283745__a75ff9761b122436c8cd92bdad68d5136">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__b40410158114158">DBMS_LOB.COPY</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__sb6c8db65dd5d4e20a3c3f15f7aa95dc9"><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_0000001510283745__tf6018708c38c43ce9c1b013cdb48d7bd" 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_0000001510283745__r4b47f2814df44ce1aa1d812c7384d078"><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_0000001510283745__a305589289fc142709d08754fd9ad7eec">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_0000001510283745__a27537f7e6d774b3fae9f73756a2b3f9a">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__r6f6af5323e92483c95e4629a24078328"><td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.3.1.4.6.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a29f38a3cfb21461a8645f9b7a704abd5">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_0000001510283745__a076c896e87f84d97b6da049924242074">BLOB type object to be pasted</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__r6864cf7b18924faaa0f729dee24e1937"><td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.3.1.4.6.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a74960261f580456292b073aec96d90aa">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_0000001510283745__af59271927d1e47c1b34b547385b1cea6">BLOB type object to be copied</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__r0c87b053658c49d4921298354213ca5a"><td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.3.1.4.6.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a4aab0fbde66e4448b61dc735b327711e">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_0000001510283745__ab18271eb2fe14f54aded4793cfa5ad08">Replication length.</p>
<div class="note" id="EN-US_TOPIC_0000001510283745__n18be54836daa45dda24a6777fb4a46cf"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001510283745__ab95fdc50c4764d44a945891d127d5fd8">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_0000001510283745__ra59ccde0e5f94a17b3e3ad7192cf35fb"><td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.3.1.4.6.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a60f9eccf9a4f46f2b154b5515aa05e7f">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_0000001510283745__a9c77476e3edd485dac3f0ce1785c5a8f">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_0000001510283745__n2ae1fa9104f44397859f31b00a20c95e"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001510283745__affb4a837f66e4e9b956091d52e6845bb">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_0000001510283745__rd6e9f9722ba84734b32b7d2e99b5b721"><td class="cellrowborder" valign="top" width="24.060000000000002%" headers="mcps1.3.1.4.6.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a075cbfe0cb56488c86192ecd22d7833b">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_0000001510283745__a5911efe32a964154b0697e8805466062">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_0000001510283745__n7f07d107ea5c44158959112b8a111010"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001510283745__a63bad4db733d48f68ab0e8f9852b5b51">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_0000001510283745__l0a15b6d3dc424ef6b5a7785938a17585"><a name="EN-US_TOPIC_0000001510283745__l0a15b6d3dc424ef6b5a7785938a17585"></a><a name="l0a15b6d3dc424ef6b5a7785938a17585"></a>DBMS_LOB.ERASE<p id="EN-US_TOPIC_0000001510283745__af2e9b5a9a26f437b9328e0702bd73dad"><a name="EN-US_TOPIC_0000001510283745__l0a15b6d3dc424ef6b5a7785938a17585"></a><a name="l0a15b6d3dc424ef6b5a7785938a17585"></a>The stored procedure <strong id="EN-US_TOPIC_0000001510283745__b139801359164015">ERASE</strong> deletes contents in BLOB according to the specified length and initial position offset.</p>
<p id="EN-US_TOPIC_0000001510283745__ae6195f359b9342e28a3dce6890240c47">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__en-us_topic_0027042944_b42498624164155">DBMS_LOB.ERASE</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__s5b2ae62f121048d7b90ded785b1b0829"><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_0000001510283745__t0e509db7d2a04fd88a71e68d9cdb04c1" 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_0000001510283745__r03eff70bac1847408b0c9ba13f202a2d"><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_0000001510283745__a02c641584bb64a5f826e4ce8c675a1a4">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_0000001510283745__abaa8c481708744bab7f49fffd57e3e86">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__r5f50f257439242308e00bd03fb2dd69a"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.7.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__ad2d772a3b3d748d69c5c846e2f7a6789">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_0000001510283745__a4093f54da48145dfa8f8b56af1bcb09f">BLOB type object whose contents are to be deleted</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__r3b6d07628c0647029fee33805ed32e30"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.7.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a6a21de61c2574367bd67951be6fc9f14">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_0000001510283745__aa6ed3c77b4504c23a56c48b99603c818">Length of contents to be deleted</p>
<div class="note" id="EN-US_TOPIC_0000001510283745__n1ea07c3082c4419e811fe68caf27b4f7"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001510283745__a482ebace90c64989a231128595c6c6e2">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_0000001510283745__r533b159d75544011b054ecc6248aee50"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.7.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a0387ce5b5a734d71b1f1376138afe70a">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_0000001510283745__a10867e20a4a14920b3661cbc7a709b1f">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_0000001510283745__n8a71899b49974d24b438269acc81b304"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001510283745__adf1dba75432f4f2b9946c8573d9623a1">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_0000001510283745__lf23368cbcb91454b9722aacc4dd739e2">DBMS_LOB.CLOSE<p id="EN-US_TOPIC_0000001510283745__a6b5a717851154e3faa23fb7e53efa416"><a name="EN-US_TOPIC_0000001510283745__lf23368cbcb91454b9722aacc4dd739e2"></a><a name="lf23368cbcb91454b9722aacc4dd739e2"></a>The procedure <strong id="EN-US_TOPIC_0000001510283745__b842352706103756">CLOSE</strong> disables the enabled contents of LOB according to the specified length and initial position offset.</p>
<p id="EN-US_TOPIC_0000001510283745__a57825ea97d1a45a8a44c1dd17eb23b34">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__b1221877111">DBMS_LOB.CLOSE</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__sd9997bf2b0884ebea266d4155871466c"><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_0000001510283745__tb7117685db7e49b6866f679b1b43a8ac"></a><a name="tb7117685db7e49b6866f679b1b43a8ac"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001510283745__tb7117685db7e49b6866f679b1b43a8ac" 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_0000001510283745__rcab178fbaa4447499b2556a1d7a90055"><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_0000001510283745__a9ed4eb872a204f9c95196c7a52b43e36">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_0000001510283745__add4ea392352d4bd190e9478c18d94bbd">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__r7aef21646ddc4d769f3d186a4735030c"><td class="cellrowborder" valign="top" width="23.93%" headers="mcps1.3.1.4.8.4.2.3.1.1 "><p id="EN-US_TOPIC_0000001510283745__a2b88a297e4504d08bd0b71f060bf1b1f">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_0000001510283745__a88aacfe6860d4adea9e59a78e7694d3f">LOB type object to be disabled</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001510283745__li1442318419148"><a name="EN-US_TOPIC_0000001510283745__li1442318419148"></a><a name="li1442318419148"></a>DBMS_LOB.INSTR<p id="EN-US_TOPIC_0000001510283745__p5673152213264"><a name="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p29978211262">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__b9841718192219">DBMS_LOB.INSTR</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__p18998102120263">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p149987213263">LOB descriptor to be searched for</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p20998172122617">Matched pattern. It is RAW for BLOB and TEXT for CLOB.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__p19981721102611">Number of pattern matching times. The minimum value is 1.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001510283745__li19579245181414"><a name="EN-US_TOPIC_0000001510283745__li19579245181414"></a><a name="li19579245181414"></a>DBMS_LOB.COMPARE<p id="EN-US_TOPIC_0000001510283745__p452831214474"><a name="EN-US_TOPIC_0000001510283745__li19579245181414"></a><a name="li19579245181414"></a>This function compares two LOBs or a certain part of two LOBs.</p>
<ul id="EN-US_TOPIC_0000001510283745__ul11440250174716"><li id="EN-US_TOPIC_0000001510283745__li1311164113479">If the two parts are equal, <strong id="EN-US_TOPIC_0000001510283745__b1337755010195">0</strong> is returned. Otherwise, a non-zero value is returned.</li><li id="EN-US_TOPIC_0000001510283745__li91234194713">If the first CLOB is smaller than the second, <strong id="EN-US_TOPIC_0000001510283745__b10192125420224">-1</strong> is returned. If the first CLOB is larger than the second, <strong id="EN-US_TOPIC_0000001510283745__b1372270142316">1</strong> is returned.</li><li id="EN-US_TOPIC_0000001510283745__li114441184715">If any of the <strong id="EN-US_TOPIC_0000001510283745__b32559326243">amount</strong>, <strong id="EN-US_TOPIC_0000001510283745__b1844636132417">offset_1</strong>, and <strong id="EN-US_TOPIC_0000001510283745__b12285945112415">offset_2</strong> parameters is invalid, <strong id="EN-US_TOPIC_0000001510283745__b181132262510">NULL</strong> is returned. The valid offset range is 1 to LOBMAXSIZE.</li></ul>
<p id="EN-US_TOPIC_0000001510283745__p757913456148">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__b1420337562">DBMS_LOB.READ</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__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_0000001510283745__p113851832482">
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__p787145818474">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p138719588476">First LOB descriptor to be compared</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p1887112583473">Second LOB descriptor to be compared</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p1887135813477">Number of characters or bytes to be compared. The maximum value is DBMS_LOB.LOBMAXSIZE.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p587195820476">Offset of the first LOB descriptor. The initial position is 1.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__li381175591417"><a name="EN-US_TOPIC_0000001510283745__li381175591417"></a><a name="li381175591417"></a>DBMS_LOB.SUBSTR<p id="EN-US_TOPIC_0000001510283745__p78111655181411"><a name="EN-US_TOPIC_0000001510283745__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_0000001510283745__b1826317248315">NULL</strong> is returned.</p>
<p id="EN-US_TOPIC_0000001510283745__p181175591418">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__b814324732210">DBMS_LOB.SUBSTR</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__p7811185512145">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__p125555582010">Number of bytes or characters to be read.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p98129554145">Number of characters or bytes offset from the start position.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001510283745__li374125861411"><a name="EN-US_TOPIC_0000001510283745__li374125861411"></a><a name="li374125861411"></a>DBMS_LOB.TRIM<p id="EN-US_TOPIC_0000001510283745__p1774135810147"><a name="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p874205801415">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__b20687558152218">DBMS_LOB.TRIM</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__p187424583145">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p674245891415">BLOB type object to be read</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__li145817213157"><a name="EN-US_TOPIC_0000001510283745__li145817213157"></a><a name="li145817213157"></a>DBMS_LOB.CREATETEMPORARY<p id="EN-US_TOPIC_0000001510283745__p155810271518"><a name="EN-US_TOPIC_0000001510283745__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_0000001510283745__p758121156">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__b39306816239">DBMS_LOB.CREATETEMPORARY</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__p55916219156">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p20591251511">LOB descriptor</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p1559182181518">This parameter is used only for syntax compatibility.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p13607201514">This parameter is used only for syntax compatibility.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001510283745__li194203411159"><a name="EN-US_TOPIC_0000001510283745__li194203411159"></a><a name="li194203411159"></a>DBMS_LOB.APPEND<p id="EN-US_TOPIC_0000001510283745__p44217481520"><a name="EN-US_TOPIC_0000001510283745__li194203411159"></a><a name="li194203411159"></a>The stored procedure <strong id="EN-US_TOPIC_0000001510283745__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_0000001510283745__p19421343152">The function prototype of <strong id="EN-US_TOPIC_0000001510283745__b197613204238">DBMS_LOB.APPEND</strong> is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__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_0000001510283745__p1942164141513">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p12421124101512">LOB descriptor to be written</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001510283745__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_0000001510283745__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_0000001510283745__p1542234191510">LOB descriptor to be read</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001510283745__s07333214dc9944d4a2525f7a7a89db47"><h4 class="sectiontitle">Examples</h4><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510283745__s30a71b6cd1914bd6a7a2be0d46151302"><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">GaussDB(DWS) Stored Procedure Advanced Package</a></div>
</div>
</div>
View Git Blame Copy Permalink