vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/umn/dws_03_0085.html
Lu, Huayi 95132e24fc DWS UMN 830.201_new version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Reviewed-by: Rechenburg, Matthias <matthias.rechenburg@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2024-05-27 11:54:34 +00:00

64 lines
12 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001330648788"></a><a name="EN-US_TOPIC_0000001330648788"></a>
<h1 class="topictitle1">How Do I View and Set the Database Character Encoding?</h1>
<div id="body0000001330648788"><div class="section" id="EN-US_TOPIC_0000001330648788__section372207123211"><h4 class="sectiontitle">Viewing the Database Character Encoding</h4><p id="EN-US_TOPIC_0000001330648788__p18765104015326">Use the <strong id="EN-US_TOPIC_0000001330648788__b161071521624">server_encoding</strong> parameter to check the character set encoding of the current database. For example, the character encoding of database <strong id="EN-US_TOPIC_0000001330648788__b145281110719">music</strong> is UTF8.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001330648788__screen177071626741"><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">music</span><span class="o">=&gt;</span><span class="w"> </span><span class="k">SHOW</span><span class="w"> </span><span class="n">server_encoding</span><span class="p">;</span>
<span class="w"> </span><span class="n">server_encoding</span>
<span class="c1">-----------------</span>
<span class="w"> </span><span class="n">UTF8</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>
</div>
<div class="section" id="EN-US_TOPIC_0000001330648788__section19744558153214"><h4 class="sectiontitle">Setting the Database Character Encoding</h4><div class="note" id="EN-US_TOPIC_0000001330648788__note4463609433"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001330648788__p5501119194317">GaussDB(DWS) does not support the modification of the character encoding format of a created database.</p>
</div></div>
<p id="EN-US_TOPIC_0000001330648788__p2256153111432">If you need to specify the character encoding format of a database, use <strong id="EN-US_TOPIC_0000001330648788__b52199920135">template0</strong> and the <strong id="EN-US_TOPIC_0000001330648788__b20764192831316">CREATE DATABASE</strong> syntax to create a database. To make your database compatible with most characters, you are advised to use the UTF8 encoding when creating a database.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_section6685122413339"><h4 class="sectiontitle">CREATE DATABASE syntax</h4><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_screen2017012308331"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span>
<span class="normal">6</span>
<span class="normal">7</span>
<span class="normal">8</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">DATABASE</span><span class="w"> </span><span class="n">database_name</span>
<span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">WITH</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">OWNER</span><span class="w"> </span><span class="p">[</span><span class="o">=</span><span class="p">]</span><span class="w"> </span><span class="n">user_name</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">TEMPLATE</span><span class="w"> </span><span class="p">[</span><span class="o">=</span><span class="p">]</span><span class="w"> </span><span class="k">template</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">ENCODING</span><span class="w"> </span><span class="p">[</span><span class="o">=</span><span class="p">]</span><span class="w"> </span><span class="k">encoding</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="n">LC_COLLATE</span><span class="w"> </span><span class="p">[</span><span class="o">=</span><span class="p">]</span><span class="w"> </span><span class="n">lc_collate</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="n">LC_CTYPE</span><span class="w"> </span><span class="p">[</span><span class="o">=</span><span class="p">]</span><span class="w"> </span><span class="n">lc_ctype</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="n">DBCOMPATIBILITY</span><span class="w"> </span><span class="p">[</span><span class="o">=</span><span class="p">]</span><span class="w"> </span><span class="n">compatibility_type</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">CONNECTION</span><span class="w"> </span><span class="k">LIMIT</span><span class="w"> </span><span class="p">[</span><span class="o">=</span><span class="p">]</span><span class="w"> </span><span class="n">connlimit</span><span class="w"> </span><span class="p">]</span><span class="err">}</span><span class="p">[...]</span><span class="w"> </span><span class="p">];</span>
</pre></div></td></tr></table></div>
</div>
</div>
<ul id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_ul58571536134310"><li id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_lb2c788c82bd34ab7839d3d54705057ba"><strong id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_a3b85024a395b4b9399bddda7a86b4805">TEMPLATE [ = ] template</strong><p id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_ab8f8638183ec445eae1009bcb5f46697">Indicates the template name, that is, the name of the template to be used to create the database. GaussDB(DWS) creates a database by copying a database template. GaussDB(DWS) has two initial template databases <strong id="EN-US_TOPIC_0000001330648788__b107776746194125">template0</strong> and <strong id="EN-US_TOPIC_0000001330648788__b111655962294125">template1</strong> and a default user database <strong id="EN-US_TOPIC_0000001330648788__b88187811194125"><span id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_text16946141520539">postgres</span></strong>.</p>
<p id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_ac4d25e8ef43447248dc48b4a86db46c5">Value range: an existing database name. If this is not specified, the system copies <strong id="EN-US_TOPIC_0000001330648788__b135085360894125">template1</strong> by default. Its value cannot be <strong id="EN-US_TOPIC_0000001330648788__b1317355410494"><span id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_text162121722165319">postgres</span></strong>.</p>
<div class="notice" id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_n4283736d9d7a4c758e2ba54b87e0035c"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_a24126e041d9d40fa8d45f0ff8df112e5">Currently, database templates cannot contain sequences. If sequences exist in the template library, database creation will fail.</p>
</div></div>
</li><li id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_laeab0aa10774496995eda1d4592965e4"><strong id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_a07e66e559df948409b087df5460cf335">ENCODING [ = ] encoding</strong><p id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_ac6c54e9209644907bc068f48ceb249d9">Character encoding used by the database. The value can be a character string (for example, <strong id="EN-US_TOPIC_0000001330648788__b214292317294125">SQL_ASCII'</strong>) or an integer number.</p>
<p id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_afd1504cd29504438a5c975f799a81c7e">If this parameter is not specified, the encoding of the template database is used by default. The encoding of template databases <strong id="EN-US_TOPIC_0000001330648788__b200068027794125">template0</strong> and <strong id="EN-US_TOPIC_0000001330648788__b213404965494125">template1</strong> depends on the OS by default. The character encoding of <strong id="EN-US_TOPIC_0000001330648788__b139212219694125">template1</strong> cannot be changed. To change the encoding, use <strong id="EN-US_TOPIC_0000001330648788__b156975985194125">template0</strong> to create a database.</p>
<p id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_ab52e943741654e439ea5fb3b771a6acd">Value range: <strong id="EN-US_TOPIC_0000001330648788__b56838182994125">GBK</strong>, <strong id="EN-US_TOPIC_0000001330648788__b65392715894125">UTF8</strong>, and <strong id="EN-US_TOPIC_0000001330648788__b129982950294125">Latin1</strong></p>
<div class="notice" id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_nb757432d042641dabed2a4cc2ab6e4c3"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_p663514315334">The character set encoding of the new database must be compatible with the local settings (<strong id="EN-US_TOPIC_0000001330648788__b172560501394125">LC_COLLATE</strong> and <strong id="EN-US_TOPIC_0000001330648788__b66478041594125">LC_CTYPE</strong>).</p>
</div></div>
</li></ul>
<div class="section" id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_section5721112004420"><h4 class="sectiontitle">Examples</h4><p id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_p13794175964018">Create database <strong id="EN-US_TOPIC_0000001330648788__b166189273294125">music</strong> using UTF8 (the local encoding type is also UTF8).</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001330648788__en-us_topic_0000001145696599_screen10691333124413"><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">CREATE</span><span class="w"> </span><span class="k">DATABASE</span><span class="w"> </span><span class="n">music</span><span class="w"> </span><span class="k">ENCODING</span><span class="w"> </span><span class="s1">'UTF8'</span><span class="w"> </span><span class="k">template</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">template0</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_03_0065.html">Database Usage</a></div>
</div>
</div>
View Git Blame Copy Permalink