Commit b8cd6b4f authored by Tom Lane's avatar Tom Lane

Make it clearer that not every Postgres character set can be used as a

server-side character set.
parent 4917564f
<!-- $PostgreSQL: pgsql/doc/src/sgml/charset.sgml,v 2.76 2006/02/18 16:15:21 petere Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/charset.sgml,v 2.77 2006/07/28 15:33:17 tgl Exp $ -->
<chapter id="charset"> <chapter id="charset">
<title>Localization</> <title>Localization</>
...@@ -304,14 +304,13 @@ initdb --locale=sv_SE ...@@ -304,14 +304,13 @@ initdb --locale=sv_SE
allows you to store text in a variety of character sets, including allows you to store text in a variety of character sets, including
single-byte character sets such as the ISO 8859 series and single-byte character sets such as the ISO 8859 series and
multiple-byte character sets such as <acronym>EUC</> (Extended Unix multiple-byte character sets such as <acronym>EUC</> (Extended Unix
Code), UTF-8, and Mule internal code. All character sets can be Code), UTF-8, and Mule internal code. All supported character sets
used transparently throughout the server. (If you use extension can be used transparently by clients, but a few are not supported
functions from other sources, it depends on whether they wrote for use within the server (that is, as a server-side encoding).
their code correctly.) The default character set is selected while The default character set is selected while
initializing your <productname>PostgreSQL</productname> database initializing your <productname>PostgreSQL</productname> database
cluster using <command>initdb</>. It can be overridden when you cluster using <command>initdb</>. It can be overridden when you
create a database using <command>createdb</command> or by using the create a database, so you can have multiple
SQL command <command>CREATE DATABASE</>. So you can have multiple
databases each with a different character set. databases each with a different character set.
</para> </para>
...@@ -320,17 +319,18 @@ initdb --locale=sv_SE ...@@ -320,17 +319,18 @@ initdb --locale=sv_SE
<para> <para>
<xref linkend="charset-table"> shows the character sets available <xref linkend="charset-table"> shows the character sets available
for use in the server. for use in <productname>PostgreSQL</productname>.
</para> </para>
<table id="charset-table"> <table id="charset-table">
<title>Server Character Sets</title> <title>Server Character Sets</title>
<tgroup cols="2"> <tgroup cols="6">
<thead> <thead>
<row> <row>
<entry>Name</entry> <entry>Name</entry>
<entry>Description</entry> <entry>Description</entry>
<entry>Language</entry> <entry>Language</entry>
<entry>Server?</entry>
<!-- <!--
The Bytes/Char field is populated by looking at the values returned The Bytes/Char field is populated by looking at the values returned
by pg_wchar_table.mblen function for each encoding. by pg_wchar_table.mblen function for each encoding.
...@@ -344,6 +344,7 @@ initdb --locale=sv_SE ...@@ -344,6 +344,7 @@ initdb --locale=sv_SE
<entry><literal>BIG5</literal></entry> <entry><literal>BIG5</literal></entry>
<entry>Big Five</entry> <entry>Big Five</entry>
<entry>Traditional Chinese</entry> <entry>Traditional Chinese</entry>
<entry>No</entry>
<entry>1-2</entry> <entry>1-2</entry>
<entry><literal>WIN950</>, <literal>Windows950</></entry> <entry><literal>WIN950</>, <literal>Windows950</></entry>
</row> </row>
...@@ -351,6 +352,7 @@ initdb --locale=sv_SE ...@@ -351,6 +352,7 @@ initdb --locale=sv_SE
<entry><literal>EUC_CN</literal></entry> <entry><literal>EUC_CN</literal></entry>
<entry>Extended UNIX Code-CN</entry> <entry>Extended UNIX Code-CN</entry>
<entry>Simplified Chinese</entry> <entry>Simplified Chinese</entry>
<entry>Yes</entry>
<entry>1-3</entry> <entry>1-3</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -358,6 +360,7 @@ initdb --locale=sv_SE ...@@ -358,6 +360,7 @@ initdb --locale=sv_SE
<entry><literal>EUC_JP</literal></entry> <entry><literal>EUC_JP</literal></entry>
<entry>Extended UNIX Code-JP</entry> <entry>Extended UNIX Code-JP</entry>
<entry>Japanese</entry> <entry>Japanese</entry>
<entry>Yes</entry>
<entry>1-3</entry> <entry>1-3</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -365,6 +368,7 @@ initdb --locale=sv_SE ...@@ -365,6 +368,7 @@ initdb --locale=sv_SE
<entry><literal>EUC_KR</literal></entry> <entry><literal>EUC_KR</literal></entry>
<entry>Extended UNIX Code-KR</entry> <entry>Extended UNIX Code-KR</entry>
<entry>Korean</entry> <entry>Korean</entry>
<entry>Yes</entry>
<entry>1-3</entry> <entry>1-3</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -372,6 +376,7 @@ initdb --locale=sv_SE ...@@ -372,6 +376,7 @@ initdb --locale=sv_SE
<entry><literal>EUC_TW</literal></entry> <entry><literal>EUC_TW</literal></entry>
<entry>Extended UNIX Code-TW</entry> <entry>Extended UNIX Code-TW</entry>
<entry>Traditional Chinese, Taiwanese</entry> <entry>Traditional Chinese, Taiwanese</entry>
<entry>Yes</entry>
<entry>1-3</entry> <entry>1-3</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -379,6 +384,7 @@ initdb --locale=sv_SE ...@@ -379,6 +384,7 @@ initdb --locale=sv_SE
<entry><literal>GB18030</literal></entry> <entry><literal>GB18030</literal></entry>
<entry>National Standard</entry> <entry>National Standard</entry>
<entry>Chinese</entry> <entry>Chinese</entry>
<entry>No</entry>
<entry>1-2</entry> <entry>1-2</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -386,6 +392,7 @@ initdb --locale=sv_SE ...@@ -386,6 +392,7 @@ initdb --locale=sv_SE
<entry><literal>GBK</literal></entry> <entry><literal>GBK</literal></entry>
<entry>Extended National Standard</entry> <entry>Extended National Standard</entry>
<entry>Simplified Chinese</entry> <entry>Simplified Chinese</entry>
<entry>No</entry>
<entry>1-2</entry> <entry>1-2</entry>
<entry><literal>WIN936</>, <literal>Windows936</></entry> <entry><literal>WIN936</>, <literal>Windows936</></entry>
</row> </row>
...@@ -393,6 +400,7 @@ initdb --locale=sv_SE ...@@ -393,6 +400,7 @@ initdb --locale=sv_SE
<entry><literal>ISO_8859_5</literal></entry> <entry><literal>ISO_8859_5</literal></entry>
<entry>ISO 8859-5, <acronym>ECMA</> 113</entry> <entry>ISO 8859-5, <acronym>ECMA</> 113</entry>
<entry>Latin/Cyrillic</entry> <entry>Latin/Cyrillic</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -400,6 +408,7 @@ initdb --locale=sv_SE ...@@ -400,6 +408,7 @@ initdb --locale=sv_SE
<entry><literal>ISO_8859_6</literal></entry> <entry><literal>ISO_8859_6</literal></entry>
<entry>ISO 8859-6, <acronym>ECMA</> 114</entry> <entry>ISO 8859-6, <acronym>ECMA</> 114</entry>
<entry>Latin/Arabic</entry> <entry>Latin/Arabic</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -407,6 +416,7 @@ initdb --locale=sv_SE ...@@ -407,6 +416,7 @@ initdb --locale=sv_SE
<entry><literal>ISO_8859_7</literal></entry> <entry><literal>ISO_8859_7</literal></entry>
<entry>ISO 8859-7, <acronym>ECMA</> 118</entry> <entry>ISO 8859-7, <acronym>ECMA</> 118</entry>
<entry>Latin/Greek</entry> <entry>Latin/Greek</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -414,6 +424,7 @@ initdb --locale=sv_SE ...@@ -414,6 +424,7 @@ initdb --locale=sv_SE
<entry><literal>ISO_8859_8</literal></entry> <entry><literal>ISO_8859_8</literal></entry>
<entry>ISO 8859-8, <acronym>ECMA</> 121</entry> <entry>ISO 8859-8, <acronym>ECMA</> 121</entry>
<entry>Latin/Hebrew</entry> <entry>Latin/Hebrew</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -421,6 +432,7 @@ initdb --locale=sv_SE ...@@ -421,6 +432,7 @@ initdb --locale=sv_SE
<entry><literal>JOHAB</literal></entry> <entry><literal>JOHAB</literal></entry>
<entry><acronym>JOHAB</></entry> <entry><acronym>JOHAB</></entry>
<entry>Korean (Hangul)</entry> <entry>Korean (Hangul)</entry>
<entry>Yes</entry>
<entry>1-3</entry> <entry>1-3</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -428,6 +440,7 @@ initdb --locale=sv_SE ...@@ -428,6 +440,7 @@ initdb --locale=sv_SE
<entry><literal>KOI8</literal></entry> <entry><literal>KOI8</literal></entry>
<entry><acronym>KOI</acronym>8-R(U)</entry> <entry><acronym>KOI</acronym>8-R(U)</entry>
<entry>Cyrillic</entry> <entry>Cyrillic</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry><literal>KOI8R</></entry> <entry><literal>KOI8R</></entry>
</row> </row>
...@@ -435,6 +448,7 @@ initdb --locale=sv_SE ...@@ -435,6 +448,7 @@ initdb --locale=sv_SE
<entry><literal>LATIN1</literal></entry> <entry><literal>LATIN1</literal></entry>
<entry>ISO 8859-1, <acronym>ECMA</> 94</entry> <entry>ISO 8859-1, <acronym>ECMA</> 94</entry>
<entry>Western European</entry> <entry>Western European</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry><literal>ISO88591</></entry> <entry><literal>ISO88591</></entry>
</row> </row>
...@@ -442,6 +456,7 @@ initdb --locale=sv_SE ...@@ -442,6 +456,7 @@ initdb --locale=sv_SE
<entry><literal>LATIN2</literal></entry> <entry><literal>LATIN2</literal></entry>
<entry>ISO 8859-2, <acronym>ECMA</> 94</entry> <entry>ISO 8859-2, <acronym>ECMA</> 94</entry>
<entry>Central European</entry> <entry>Central European</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry><literal>ISO88592</></entry> <entry><literal>ISO88592</></entry>
</row> </row>
...@@ -449,6 +464,7 @@ initdb --locale=sv_SE ...@@ -449,6 +464,7 @@ initdb --locale=sv_SE
<entry><literal>LATIN3</literal></entry> <entry><literal>LATIN3</literal></entry>
<entry>ISO 8859-3, <acronym>ECMA</> 94</entry> <entry>ISO 8859-3, <acronym>ECMA</> 94</entry>
<entry>South European</entry> <entry>South European</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry><literal>ISO88593</></entry> <entry><literal>ISO88593</></entry>
</row> </row>
...@@ -456,6 +472,7 @@ initdb --locale=sv_SE ...@@ -456,6 +472,7 @@ initdb --locale=sv_SE
<entry><literal>LATIN4</literal></entry> <entry><literal>LATIN4</literal></entry>
<entry>ISO 8859-4, <acronym>ECMA</> 94</entry> <entry>ISO 8859-4, <acronym>ECMA</> 94</entry>
<entry>North European</entry> <entry>North European</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry><literal>ISO88594</></entry> <entry><literal>ISO88594</></entry>
</row> </row>
...@@ -463,6 +480,7 @@ initdb --locale=sv_SE ...@@ -463,6 +480,7 @@ initdb --locale=sv_SE
<entry><literal>LATIN5</literal></entry> <entry><literal>LATIN5</literal></entry>
<entry>ISO 8859-9, <acronym>ECMA</> 128</entry> <entry>ISO 8859-9, <acronym>ECMA</> 128</entry>
<entry>Turkish</entry> <entry>Turkish</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry><literal>ISO88599</></entry> <entry><literal>ISO88599</></entry>
</row> </row>
...@@ -470,6 +488,7 @@ initdb --locale=sv_SE ...@@ -470,6 +488,7 @@ initdb --locale=sv_SE
<entry><literal>LATIN6</literal></entry> <entry><literal>LATIN6</literal></entry>
<entry>ISO 8859-10, <acronym>ECMA</> 144</entry> <entry>ISO 8859-10, <acronym>ECMA</> 144</entry>
<entry>Nordic</entry> <entry>Nordic</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry><literal>ISO885910</></entry> <entry><literal>ISO885910</></entry>
</row> </row>
...@@ -477,6 +496,7 @@ initdb --locale=sv_SE ...@@ -477,6 +496,7 @@ initdb --locale=sv_SE
<entry><literal>LATIN7</literal></entry> <entry><literal>LATIN7</literal></entry>
<entry>ISO 8859-13</entry> <entry>ISO 8859-13</entry>
<entry>Baltic</entry> <entry>Baltic</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry><literal>ISO885913</></entry> <entry><literal>ISO885913</></entry>
</row> </row>
...@@ -484,6 +504,7 @@ initdb --locale=sv_SE ...@@ -484,6 +504,7 @@ initdb --locale=sv_SE
<entry><literal>LATIN8</literal></entry> <entry><literal>LATIN8</literal></entry>
<entry>ISO 8859-14</entry> <entry>ISO 8859-14</entry>
<entry>Celtic</entry> <entry>Celtic</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry><literal>ISO885914</></entry> <entry><literal>ISO885914</></entry>
</row> </row>
...@@ -491,6 +512,7 @@ initdb --locale=sv_SE ...@@ -491,6 +512,7 @@ initdb --locale=sv_SE
<entry><literal>LATIN9</literal></entry> <entry><literal>LATIN9</literal></entry>
<entry>ISO 8859-15</entry> <entry>ISO 8859-15</entry>
<entry>LATIN1 with Euro and accents</entry> <entry>LATIN1 with Euro and accents</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry>ISO885915</entry> <entry>ISO885915</entry>
</row> </row>
...@@ -498,6 +520,7 @@ initdb --locale=sv_SE ...@@ -498,6 +520,7 @@ initdb --locale=sv_SE
<entry><literal>LATIN10</literal></entry> <entry><literal>LATIN10</literal></entry>
<entry>ISO 8859-16, <acronym>ASRO</> SR 14111</entry> <entry>ISO 8859-16, <acronym>ASRO</> SR 14111</entry>
<entry>Romanian</entry> <entry>Romanian</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry><literal>ISO885916</></entry> <entry><literal>ISO885916</></entry>
</row> </row>
...@@ -505,6 +528,7 @@ initdb --locale=sv_SE ...@@ -505,6 +528,7 @@ initdb --locale=sv_SE
<entry><literal>MULE_INTERNAL</literal></entry> <entry><literal>MULE_INTERNAL</literal></entry>
<entry>Mule internal code</entry> <entry>Mule internal code</entry>
<entry>Multilingual Emacs</entry> <entry>Multilingual Emacs</entry>
<entry>Yes</entry>
<entry>1-4</entry> <entry>1-4</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -512,6 +536,7 @@ initdb --locale=sv_SE ...@@ -512,6 +536,7 @@ initdb --locale=sv_SE
<entry><literal>SJIS</literal></entry> <entry><literal>SJIS</literal></entry>
<entry>Shift JIS</entry> <entry>Shift JIS</entry>
<entry>Japanese</entry> <entry>Japanese</entry>
<entry>No</entry>
<entry>1-2</entry> <entry>1-2</entry>
<entry><literal>Mskanji</>, <literal>ShiftJIS</>, <literal>WIN932</>, <literal>Windows932</></entry> <entry><literal>Mskanji</>, <literal>ShiftJIS</>, <literal>WIN932</>, <literal>Windows932</></entry>
</row> </row>
...@@ -519,6 +544,7 @@ initdb --locale=sv_SE ...@@ -519,6 +544,7 @@ initdb --locale=sv_SE
<entry><literal>SQL_ASCII</literal></entry> <entry><literal>SQL_ASCII</literal></entry>
<entry>unspecified (see text)</entry> <entry>unspecified (see text)</entry>
<entry><emphasis>any</></entry> <entry><emphasis>any</></entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -526,6 +552,7 @@ initdb --locale=sv_SE ...@@ -526,6 +552,7 @@ initdb --locale=sv_SE
<entry><literal>UHC</literal></entry> <entry><literal>UHC</literal></entry>
<entry>Unified Hangul Code</entry> <entry>Unified Hangul Code</entry>
<entry>Korean</entry> <entry>Korean</entry>
<entry>No</entry>
<entry>1-2</entry> <entry>1-2</entry>
<entry><literal>WIN949</>, <literal>Windows949</></entry> <entry><literal>WIN949</>, <literal>Windows949</></entry>
</row> </row>
...@@ -533,6 +560,7 @@ initdb --locale=sv_SE ...@@ -533,6 +560,7 @@ initdb --locale=sv_SE
<entry><literal>UTF8</literal></entry> <entry><literal>UTF8</literal></entry>
<entry>Unicode, 8-bit</entry> <entry>Unicode, 8-bit</entry>
<entry><emphasis>all</></entry> <entry><emphasis>all</></entry>
<entry>Yes</entry>
<entry>1-4</entry> <entry>1-4</entry>
<entry><literal>Unicode</></entry> <entry><literal>Unicode</></entry>
</row> </row>
...@@ -540,6 +568,7 @@ initdb --locale=sv_SE ...@@ -540,6 +568,7 @@ initdb --locale=sv_SE
<entry><literal>WIN866</literal></entry> <entry><literal>WIN866</literal></entry>
<entry>Windows CP866</entry> <entry>Windows CP866</entry>
<entry>Cyrillic</entry> <entry>Cyrillic</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry><literal>ALT</></entry> <entry><literal>ALT</></entry>
</row> </row>
...@@ -547,6 +576,7 @@ initdb --locale=sv_SE ...@@ -547,6 +576,7 @@ initdb --locale=sv_SE
<entry><literal>WIN874</literal></entry> <entry><literal>WIN874</literal></entry>
<entry>Windows CP874</entry> <entry>Windows CP874</entry>
<entry>Thai</entry> <entry>Thai</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -554,6 +584,7 @@ initdb --locale=sv_SE ...@@ -554,6 +584,7 @@ initdb --locale=sv_SE
<entry><literal>WIN1250</literal></entry> <entry><literal>WIN1250</literal></entry>
<entry>Windows CP1250</entry> <entry>Windows CP1250</entry>
<entry>Central European</entry> <entry>Central European</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry></entry> <entry></entry>
</row> </row>
...@@ -561,6 +592,7 @@ initdb --locale=sv_SE ...@@ -561,6 +592,7 @@ initdb --locale=sv_SE
<entry><literal>WIN1251</literal></entry> <entry><literal>WIN1251</literal></entry>
<entry>Windows CP1251</entry> <entry>Windows CP1251</entry>
<entry>Cyrillic</entry> <entry>Cyrillic</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry><literal>WIN</></entry> <entry><literal>WIN</></entry>
</row> </row>
...@@ -568,48 +600,55 @@ initdb --locale=sv_SE ...@@ -568,48 +600,55 @@ initdb --locale=sv_SE
<entry><literal>WIN1252</literal></entry> <entry><literal>WIN1252</literal></entry>
<entry>Windows CP1252</entry> <entry>Windows CP1252</entry>
<entry>Western European</entry> <entry>Western European</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry></entry> <entry></entry>
</row> </row>
<row> <row>
<entry><literal>WIN1253</literal></entry> <entry><literal>WIN1253</literal></entry>
<entry>Windows CP1253</entry> <entry>Windows CP1253</entry>
<entry>Greek</entry> <entry>Greek</entry>
<entry>1</entry> <entry>Yes</entry>
<entry>1</entry>
<entry></entry>
</row>
<row>
<entry><literal>WIN1254</literal></entry>
<entry>Windows CP1254</entry>
<entry>Turkish</entry>
<entry>Yes</entry>
<entry>1</entry>
<entry></entry>
</row>
<row>
<entry><literal>WIN1255</literal></entry>
<entry>Windows CP1255</entry>
<entry>Hebrew</entry>
<entry>Yes</entry>
<entry>1</entry>
<entry></entry> <entry></entry>
</row> </row>
<row>
<entry><literal>WIN1254</literal></entry>
<entry>Windows CP1254</entry>
<entry>Turkish</entry>
<entry>1</entry>
<entry></entry>
</row>
<row>
<entry><literal>WIN1255</literal></entry>
<entry>Windows CP1255</entry>
<entry>Hebrew</entry>
<entry>1</entry>
<entry></entry>
</row>
<row> <row>
<entry><literal>WIN1256</literal></entry> <entry><literal>WIN1256</literal></entry>
<entry>Windows CP1256</entry> <entry>Windows CP1256</entry>
<entry>Arabic</entry> <entry>Arabic</entry>
<entry>Yes</entry>
<entry>1</entry>
<entry></entry>
</row>
<row>
<entry><literal>WIN1257</literal></entry>
<entry>Windows CP1257</entry>
<entry>Baltic</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry></entry> <entry></entry>
</row> </row>
<row>
<entry><literal>WIN1257</literal></entry>
<entry>Windows CP1257</entry>
<entry>Baltic</entry>
<entry>1</entry>
<entry></entry>
</row>
<row> <row>
<entry><literal>WIN1258</literal></entry> <entry><literal>WIN1258</literal></entry>
<entry>Windows CP1258</entry> <entry>Windows CP1258</entry>
<entry>Vietnamese</entry> <entry>Vietnamese</entry>
<entry>Yes</entry>
<entry>1</entry> <entry>1</entry>
<entry><literal>ABC</>, <literal>TCVN</>, <literal>TCVN5712</>, <literal>VSCII</></entry> <entry><literal>ABC</>, <literal>TCVN</>, <literal>TCVN5712</>, <literal>VSCII</></entry>
</row> </row>
...@@ -731,12 +770,11 @@ $ <userinput>psql -l</userinput> ...@@ -731,12 +770,11 @@ $ <userinput>psql -l</userinput>
<para> <para>
<productname>PostgreSQL</productname> supports automatic <productname>PostgreSQL</productname> supports automatic
character set conversion between server and client for certain character set conversion between server and client for certain
character sets. The conversion information is stored in the character set combinations. The conversion information is stored in the
<literal>pg_conversion</> system catalog. You can create a new <literal>pg_conversion</> system catalog. <productname>PostgreSQL</>
conversion by using the SQL command <command>CREATE comes with some predefined conversions, as shown in <xref
CONVERSION</command>. <productname>PostgreSQL</> comes with some linkend="multibyte-translation-table">. You can create a new
predefined conversions. They are listed in <xref conversion using the SQL command <command>CREATE CONVERSION</command>.
linkend="multibyte-translation-table">.
</para> </para>
<table id="multibyte-translation-table"> <table id="multibyte-translation-table">
...@@ -1081,7 +1119,8 @@ char *pg_encoding_to_char(int <replaceable>encoding_id</replaceable>); ...@@ -1081,7 +1119,8 @@ char *pg_encoding_to_char(int <replaceable>encoding_id</replaceable>);
SET CLIENT_ENCODING TO '<replaceable>value</>'; SET CLIENT_ENCODING TO '<replaceable>value</>';
</programlisting> </programlisting>
Also you can use the more standard SQL syntax <literal>SET NAMES</literal> for this purpose: Also you can use the standard SQL syntax <literal>SET NAMES</literal>
for this purpose:
<programlisting> <programlisting>
SET NAMES '<replaceable>value</>'; SET NAMES '<replaceable>value</>';
...@@ -1130,10 +1169,8 @@ RESET client_encoding; ...@@ -1130,10 +1169,8 @@ RESET client_encoding;
If the conversion of a particular character is not possible If the conversion of a particular character is not possible
&mdash; suppose you chose <literal>EUC_JP</literal> for the &mdash; suppose you chose <literal>EUC_JP</literal> for the
server and <literal>LATIN1</literal> for the client, then some server and <literal>LATIN1</literal> for the client, then some
Japanese characters cannot be converted to Japanese characters do not have a representation in
<literal>LATIN1</literal> &mdash; it is transformed to its <literal>LATIN1</literal> &mdash; then an error is reported.
hexadecimal byte values in parentheses, e.g.,
<literal>(826C)</literal>.
</para> </para>
<para> <para>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment