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

95 lines
10 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001233708705"></a><a name="EN-US_TOPIC_0000001233708705"></a>
<h1 class="topictitle1">Binary Data Types</h1>
<div id="body8662426"><p id="EN-US_TOPIC_0000001233708705__en-us_topic_0059778141_p168218119366"><a href="#EN-US_TOPIC_0000001233708705__teea287ea2f5d4444bb3ebb521189b9e8">Table 1</a> lists the binary data types that can be used in <span id="EN-US_TOPIC_0000001233708705__text805822315">GaussDB(DWS)</span>.</p>
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001233708705__teea287ea2f5d4444bb3ebb521189b9e8"></a><a name="teea287ea2f5d4444bb3ebb521189b9e8"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001233708705__teea287ea2f5d4444bb3ebb521189b9e8" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Binary Data Types</caption><thead align="left"><tr id="EN-US_TOPIC_0000001233708705__rd6c8f22526fd42d8b723ead93f91c856"><th align="left" class="cellrowborder" valign="top" width="10%" id="mcps1.3.2.2.4.1.1"><p id="EN-US_TOPIC_0000001233708705__a8fdafb04f4954c5bb56ab97fe816a910"><strong id="EN-US_TOPIC_0000001233708705__b84235270691445">Name</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="42%" id="mcps1.3.2.2.4.1.2"><p id="EN-US_TOPIC_0000001233708705__aedea42dd8c5c42199806e6b54b8dc747"><strong id="EN-US_TOPIC_0000001233708705__b842352706212013">Description</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="48%" id="mcps1.3.2.2.4.1.3"><p id="EN-US_TOPIC_0000001233708705__a19694fc9e6494d809dc6b5a055b896bd"><strong id="EN-US_TOPIC_0000001233708705__b84235270618324">Storage Space</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001233708705__r986b12e2b82f4effb6790e2b6d6243a4"><td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001233708705__ae08e32a3dae6420e81fb01f00608abe2">BLOB</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001233708705__a92a0c7f2cb5446849fdeeb79ae57de58">Binary large object.</p>
<p id="EN-US_TOPIC_0000001233708705__a15cbd6788a9843aebbc7e71c34c9e4af">Currently, BLOB only supports the following external access interfaces:</p>
<ul id="EN-US_TOPIC_0000001233708705__u7066c912584f4676bde522ce12b0e441"><li id="EN-US_TOPIC_0000001233708705__la3ea8d67f39c4563aff015f9dea7a765">DBMS_LOB.GETLENGTH</li><li id="EN-US_TOPIC_0000001233708705__l87fa6fbe1dd04e509a0c14b40c6b455b">DBMS_LOB.READ</li><li id="EN-US_TOPIC_0000001233708705__ld114ed337f7440f8a9692c214c549ce6">DBMS_LOB.WRITE</li><li id="EN-US_TOPIC_0000001233708705__lba7198fd4ceb45ed84d050d702e46966">DBMS_LOB.WRITEAPPEND</li><li id="EN-US_TOPIC_0000001233708705__le713c948ca0f4b9388d3902526e68f7c">DBMS_LOB.COPY</li><li id="EN-US_TOPIC_0000001233708705__le2e4935565e6480a9e04767849de15c2">DBMS_LOB.ERASE</li></ul>
<p id="EN-US_TOPIC_0000001233708705__ad2e744fd427241988df29db8ffa5bce2">For details about the interfaces, see DBMS_LOB.</p>
<div class="note" id="EN-US_TOPIC_0000001233708705__n62a23985159a49e095a843d10f18abad"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001233708705__aa4629d75a07b49288cb68bfa4d63e139">Column storage cannot be used for the BLOB type.</p>
</div></div>
</td>
<td class="cellrowborder" valign="top" width="48%" headers="mcps1.3.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001233708705__a1003e536ffe04b489f2320d9c6a1e6c4">The maximum size is 10,7373,3621 bytes (1 GB - 8203 bytes).</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233708705__r74979cb40d83421d981147e70dcf453e"><td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001233708705__a03844b03b4754b7287f3106688d85b05">RAW</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001233708705__aa29bb7b3a9fb4eb2abb0a126c5080817">Variable-length hexadecimal string</p>
<div class="note" id="EN-US_TOPIC_0000001233708705__n215c685409cb4b95bae54157c1fe13e0"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001233708705__a0d160e863cf843238c90499bda6db98b">Column storage cannot be used for the raw type.</p>
</div></div>
</td>
<td class="cellrowborder" valign="top" width="48%" headers="mcps1.3.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001233708705__a96cd1e0e5d7b41d981d9663e663e5d87">4 bytes plus the actual hexadecimal string. The maximum size is 10,7373,3621 bytes (1 GB - 8203 bytes).</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233708705__rc4d8961dd370490ca8133e2139855175"><td class="cellrowborder" valign="top" width="10%" headers="mcps1.3.2.2.4.1.1 "><p id="EN-US_TOPIC_0000001233708705__a3a9c26a681d64108a0d93666e7792eea">BYTEA</p>
</td>
<td class="cellrowborder" valign="top" width="42%" headers="mcps1.3.2.2.4.1.2 "><p id="EN-US_TOPIC_0000001233708705__a5dcaa38263194e339d7b2ef3f7c175ae">Variable-length binary string</p>
</td>
<td class="cellrowborder" valign="top" width="48%" headers="mcps1.3.2.2.4.1.3 "><p id="EN-US_TOPIC_0000001233708705__a6444176c2ab94e92af1863ea774aa6ac">4 bytes plus the actual binary string. The maximum size is 10,7373,3621 bytes (1 GB - 8203 bytes).</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="note" id="EN-US_TOPIC_0000001233708705__n170c2459de93429a86e707b99a0cda0d"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233708705__a165b4015a8864e51833fcc6dfdf26cf7">In addition to the size limitation on each column, the total size of each tuple is 8203 bytes less than 1 GB.</p>
</div></div>
<div class="section" id="EN-US_TOPIC_0000001233708705__section332057192716"><h4 class="sectiontitle">Example</h4><p id="EN-US_TOPIC_0000001233708705__p16373960299">Create a table:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233708705__screen65901928152912"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span>
<span class="normal">6</span>
<span class="normal">7</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">blob_type_t1</span><span class="w"> </span>
<span class="p">(</span>
<span class="w"> </span><span class="n">BT_COL1</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="w"> </span><span class="n">BT_COL2</span><span class="w"> </span><span class="nb">BLOB</span><span class="p">,</span>
<span class="w"> </span><span class="n">BT_COL3</span><span class="w"> </span><span class="n">RAW</span><span class="p">,</span>
<span class="w"> </span><span class="n">BT_COL4</span><span class="w"> </span><span class="n">BYTEA</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>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233708705__p98531126172910">Insert data:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233708705__screen107112169301"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">blob_type_t1</span><span class="w"> </span><span class="k">VALUES</span><span class="p">(</span><span class="mi">10</span><span class="p">,</span><span class="n">empty_blob</span><span class="p">(),</span><span class="n">HEXTORAW</span><span class="p">(</span><span class="s1">'DEADBEEF'</span><span class="p">),</span><span class="n">E</span><span class="s1">'\\xDEADBEEF'</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233708705__p10420113472912">Query data in the table:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233708705__screen20588154310302"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">blob_type_t1</span><span class="p">;</span>
<span class="w"> </span><span class="n">bt_col1</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">bt_col2</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">bt_col3</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">bt_col4</span><span class="w"> </span>
<span class="c1">---------+---------+----------+------------</span>
<span class="w"> </span><span class="mi">10</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">DEADBEEF</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="err">\</span><span class="n">xdeadbeef</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001233708705__p9329356293">Delete the table:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233708705__screen13841584310"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">DROP</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">blob_type_t1</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_06_0008.html">Data Types</a></div>
</div>
</div>
View Git Blame Copy Permalink