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

102 lines
11 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001145494453"></a><a name="EN-US_TOPIC_0000001145494453"></a>
<h1 class="topictitle1">DBMS_RANDOM</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001145494453__s8c8d75c0fada4bfd9c910e7057ba34ca"><h4 class="sectiontitle">Related Interfaces</h4><p id="EN-US_TOPIC_0000001145494453__a8ec9d2a885474044b17a1b61769a01e5"><a href="#EN-US_TOPIC_0000001145494453__t93766423da5a44c296f075b7dfc7af5a">Table 1</a> provides all interfaces supported by the <strong id="EN-US_TOPIC_0000001145494453__a763bac80d084421283e8f903891045f0">DBMS_RANDOM</strong> package.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001145494453__t93766423da5a44c296f075b7dfc7af5a"></a><a name="t93766423da5a44c296f075b7dfc7af5a"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001145494453__t93766423da5a44c296f075b7dfc7af5a" frame="border" border="1" rules="all"><caption><b>Table 1 </b>DBMS_RANDOM interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001145494453__rdcb7ee172fee49f19e49255f52510846"><th align="left" class="cellrowborder" valign="top" width="21.75%" id="mcps1.3.1.3.2.3.1.1"><p id="EN-US_TOPIC_0000001145494453__acc2631f4b8aa4bb0bc95218b917a7ead">API</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="78.25%" id="mcps1.3.1.3.2.3.1.2"><p id="EN-US_TOPIC_0000001145494453__a6fbbb46dcd6941f19eb09694f7891c9d">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001145494453__rc94b2a6320904521a1b21f9a011a8a31"><td class="cellrowborder" valign="top" width="21.75%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001145494453__a041b4f23d66c4edfabfa2e65d27ae835"><a href="#EN-US_TOPIC_0000001145494453__lac6fccaa336645a8b4a6d52272b2af1e">DBMS_RANDOM.SEED</a></p>
</td>
<td class="cellrowborder" valign="top" width="78.25%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001145494453__a5e6262e36c5e417da5382293bfaebcdf">Sets a seed for a random number.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001145494453__rf0f450760f2547948f473762cbaf088d"><td class="cellrowborder" valign="top" width="21.75%" headers="mcps1.3.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001145494453__a7a546004e7724804af7b4eead6c7915b"><a href="#EN-US_TOPIC_0000001145494453__lf224bfe4ed9b4cab864ddace5779ab58">DBMS_RANDOM.VALUE</a></p>
</td>
<td class="cellrowborder" valign="top" width="78.25%" headers="mcps1.3.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001145494453__a480e74f686e94796b5e479c6037a763a">Generates a random number between a specified low and a specified high.</p>
</td>
</tr>
</tbody>
</table>
</div>
<ul id="EN-US_TOPIC_0000001145494453__u6dbb540895a04a2f94640f5b330088bd"><li id="EN-US_TOPIC_0000001145494453__lac6fccaa336645a8b4a6d52272b2af1e"><a name="EN-US_TOPIC_0000001145494453__lac6fccaa336645a8b4a6d52272b2af1e"></a><a name="lac6fccaa336645a8b4a6d52272b2af1e"></a>DBMS_RANDOM.SEED<p id="EN-US_TOPIC_0000001145494453__a7e62ab6efb924c16a7aa3c3f8d9a0fbc"><a name="EN-US_TOPIC_0000001145494453__lac6fccaa336645a8b4a6d52272b2af1e"></a><a name="lac6fccaa336645a8b4a6d52272b2af1e"></a>The stored procedure SEED is used to set a seed for a random number. The DBMS_RANDOM.SEED function prototype is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145494453__sd8749e49ae1745f6a783edcddbc9b1d7"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">DBMS_RANDOM</span><span class="p">.</span><span class="n">SEED</span><span class="w"> </span><span class="p">(</span><span class="n">seed</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="w"></span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001145494453__td4ede9490bff413dbd93197d2d4e81f7" frame="border" border="1" rules="all"><caption><b>Table 2 </b>DBMS_RANDOM.SEED interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001145494453__r0d9f4b83771940c989d27bd8ee1fd2c1"><th align="left" class="cellrowborder" valign="top" width="25.28%" id="mcps1.3.1.4.1.3.2.3.1.1"><p id="EN-US_TOPIC_0000001145494453__a232d5a1cd68f4970987c9d7324e67dfb">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="74.72%" id="mcps1.3.1.4.1.3.2.3.1.2"><p id="EN-US_TOPIC_0000001145494453__a82f5ef7ec0f842db82286bdcab66ec7d">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001145494453__r6e61dbf1f4964ed0ad0f06944bff4fd7"><td class="cellrowborder" valign="top" width="25.28%" headers="mcps1.3.1.4.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001145494453__a5730dbb73840439bbf82dcfc5b1d7a9b">seed</p>
</td>
<td class="cellrowborder" valign="top" width="74.72%" headers="mcps1.3.1.4.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001145494453__a2edb5dedcbd14d61a3324d0af5bb3de6">Generates a seed for a random number.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<ul id="EN-US_TOPIC_0000001145494453__u046513a6caa540fcba9521bf7c515423"><li id="EN-US_TOPIC_0000001145494453__lf224bfe4ed9b4cab864ddace5779ab58"><a name="EN-US_TOPIC_0000001145494453__lf224bfe4ed9b4cab864ddace5779ab58"></a><a name="lf224bfe4ed9b4cab864ddace5779ab58"></a>DBMS_RANDOM.VALUE<p id="EN-US_TOPIC_0000001145494453__a62131b15d07043a0b214f56321cd1e02"><a name="EN-US_TOPIC_0000001145494453__lf224bfe4ed9b4cab864ddace5779ab58"></a><a name="lf224bfe4ed9b4cab864ddace5779ab58"></a>The stored procedure VALUE generates a random number between a specified low and a specified high. The DBMS_RANDOM.VALUE function prototype is:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145494453__sac9308da4fcb43418ccb8b03d2909ec3"><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_RANDOM</span><span class="p">.</span><span class="n">VALUE</span><span class="p">(</span><span class="w"></span>
<span class="n">low</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">NUMBER</span><span class="p">,</span><span class="w"></span>
<span class="n">high</span><span class="w"> </span><span class="k">IN</span><span class="w"> </span><span class="nb">NUMBER</span><span class="p">)</span><span class="w"></span>
<span class="k">RETURN</span><span class="w"> </span><span class="nb">NUMBER</span><span class="p">;</span><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001145494453__t9f4679813dea4e0dacf1b89b64eefbb4" frame="border" border="1" rules="all"><caption><b>Table 3 </b>DBMS_RANDOM.VALUE interface parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001145494453__r6f3bf394c770472db846a443d59f12ad"><th align="left" class="cellrowborder" valign="top" width="15.06%" id="mcps1.3.1.5.1.3.2.3.1.1"><p id="EN-US_TOPIC_0000001145494453__a674a67a002834bee9c93bfbb4b38610f">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="84.94%" id="mcps1.3.1.5.1.3.2.3.1.2"><p id="EN-US_TOPIC_0000001145494453__ad87d636adeac411daa9d6d91deb06a56">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001145494453__r7b31f68cdb8343a7988334ac3194443b"><td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.1.5.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001145494453__aabd3d33c7b954105b986a56b475f582a">low</p>
</td>
<td class="cellrowborder" valign="top" width="84.94%" headers="mcps1.3.1.5.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001145494453__a6bdbb39a14a0430b8e5997cf53a66b93">Sets the low bound for a random number. The generated random number is greater than or equal to the low.</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001145494453__r6b8ae1ceec2f4415a5217ae01c222835"><td class="cellrowborder" valign="top" width="15.06%" headers="mcps1.3.1.5.1.3.2.3.1.1 "><p id="EN-US_TOPIC_0000001145494453__aa3508ca1d81f40e28a68749cfc3c98a7">high</p>
</td>
<td class="cellrowborder" valign="top" width="84.94%" headers="mcps1.3.1.5.1.3.2.3.1.2 "><p id="EN-US_TOPIC_0000001145494453__aa265f14a7cfc416fba8cb33e5f78a4bc">Sets the high bound for a random number. The generated random number is less than the high.</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
<div class="note" id="EN-US_TOPIC_0000001145494453__n8a3db140a0634a52830f48827a785ffb"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001145494453__a460e07dfb4ed46c0976d51ff044488c1">The only requirement is that the parameter type is <strong id="EN-US_TOPIC_0000001145494453__a7d5695a8093649709d3d48b5c21da57c">NUMERIC</strong> regardless of the right and left bound values.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001145494453__s2f69d1f1ee29402da7565c2539d7e105"><h4 class="sectiontitle">Examples</h4><p id="EN-US_TOPIC_0000001145494453__a53038301355146778f03f4c30e286c03"></p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145494453__scc850b4c51e643999a4631382020cdcb"><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="c1">-- Generate a random number between 0 and 1:</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">DBMS_RANDOM</span><span class="p">.</span><span class="n">VALUE</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="mi">1</span><span class="p">);</span><span class="w"></span>
<span class="c1">-- Add the low and high parameters to an integer within the specified range and intercept smaller values from the result. (The maximum value cannot be a possible value.) Therefore, use the following code for an integer between 0 and 99:</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">TRUNC</span><span class="p">(</span><span class="n">DBMS_RANDOM</span><span class="p">.</span><span class="n">VALUE</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="mi">100</span><span class="p">));</span><span class="w"></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