5.2. マルチバイトサポート

5.2.1. マルチバイトサポートの付与

マルチバイトオプションを付けて configure を実行します。

./configure --enable-multibyte[=encoding_system]

ここで encoding_system は以下の表にある値のうちのひとつです。

デフォルトで PostgreSQL が日本語符号化方式を使用できるようにコンフィギュレーションする例です：

$ ./configure --enable-multibyte=EUC_JP

もし符号化システムが省略された場合 (./configure --enable-multibyte)、 SQL_ASCII が使用されます。

5.2.2. 符号化方式の設定

initdb で PostgreSQL のひとつのインストレーションのデフォルトの符号化方式を定義します。例です。

$ initdb -E EUC_JP

はデフォルトの符号化方式を EUC_JP (日本語拡張 Unix コード)に設定します。より長いオプションの文字列を入力するのがお好みなら -E の代わりに --encoding と書くこともできます。-E オプションも --encoding オプションも与えられない場合コンフィギュレーションが行われたときに指定された符号化方式が使われます。

異なる符号化方式のデータベースを作成することができます。

$ createdb -E EUC_KR korean

は EUC_KR 符号化方式で korean という名前のデータベースを作成します。SQL コマンドで同じことを行うには次のようにします。

CREATE DATABASE korean WITH ENCODING = 'EUC_KR';

データベースの符号化方式は pg_database システムカタログにある encoding column で表現されます。 -l オプションか psql の \l コマンドで符号化方式を見ることができます。

$ psql -l
            List of databases
   Name        |  Owner  |   Encoding
---------------+---------+---------------
 euc_cn        | t-ishii | EUC_CN
 euc_jp        | t-ishii | EUC_JP
 euc_kr        | t-ishii | EUC_KR
 euc_tw        | t-ishii | EUC_TW
 mule_internal | t-ishii | MULE_INTERNAL
 regression    | t-ishii | SQL_ASCII
 template1     | t-ishii | EUC_JP
 test          | t-ishii | EUC_JP
 unicode       | t-ishii | UNICODE
(9 rows)
(訳注：オリジナルは Name 列 が Database となっていますが、7.2.1 での実際の
結果にあわせてあります。)

5.2.3. サーバ・クライアント間の符号化方式自動翻訳

PostgreSQL にはいくつかの符号化方式に対してサーバとクライアントの間で自動的に符号化方式を翻訳する機能を提供しています。使用できる組合せは Table 5-2 にまとめてあります。

自動符号化方式を使用できるようにするためには、クライアントでどのような符号化方式を使用させたいかを PostgreSQL に伝えなければなりません。これを行うにはいくつかの方法があります。

• psql で \encoding コマンドを使います。\encoding は実行中であってもクライアントの符号化方式を変更させます。例えば符号化方式を SJIS に変えたい場合は次のように入力します。

  \encoding SJIS
  

• libpq 関数を使う。 \encoding は結果を得るために実際は PQsetClientEncoding() を呼び出しています。

  int PQsetClientEncoding(PGconn *conn, const char *encoding)
  

  ここで conn はサーバへの接続、 encoding は使用したい符号化方式です。符号化方式の設定に成功すると 0 を返し失敗すると -1 を返します。この接続にたいする現在の符号化方式は次のようにして確認できます。

  int PQclientEncoding(const PGconn *conn)
  

  EUC_JP のような記号文字列ではなく符号化方式 ID を返すことに注意して下さい。符号化方式 ID を符号化方式の名称に変換するには次のようにします。

  char *pg_encoding_to_char(int encoding_id)
  

• SET CLIENT_ENCODING TO を使って。 次の SQL コマンドでクライアントの符号化方式を設定できます。

  SET CLIENT_ENCODING TO 'encoding';
  

  SQL92 の構文 SET NAMES を同じ目的で使うこともできます。

  SET NAMES 'encoding';
  

  現在のクライアントの符号化方式を問い合わせるには次のようにします。

  SHOW CLIENT_ENCODING;
  

  デフォルトの符号化方式に戻すのには次のようにします。

  RESET CLIENT_ENCODING;
  

• PGCLIENTENCODING を使って。 クライアントの環境で環境変数 PGCLIENTENCODING が定義されているとサーバと接続が確立した時点で自動的にクライアントの符号化方式が選択されます。(上で説明したそのほかのどんな方法でもその後書き換えできます。)

5.2.4. Unicode について

Unicode と他の符号化方式間での自動符号化方式翻訳は PostgreSQL 7.1 からサポートされるようになりました。7.1 ではデフォルトで使えるようになっていません。この機能を使えるようにするには --enable-unicode-conversion オプションをつけてコンフィギュレーションを行います。この場合 --enable-multibyte オプションも必要ですので注意して下さい。

7.2 では --enable-unicode-conversion オプションは必要ありません。

5.2.5. 翻訳が不可能な場合に起こること

サーバでは EUC_JP が、そしてクライアントでは LATIN1 が選択されていると仮定します。そうすると日本語文字のいくつかは LATIN1 に翻訳することができません。この場合 LATIN1 文字セットで表現できない文字は次のように変形します。

(HEXA DECIMAL)

5.2.6. 参考文献

ここに記したものはさまざまな符号化方式システムを学習するためによい資料です。

5.2.7. 歴史

Dec 7, 2000
        * Unicode と他のエンコード間の符号化方式翻訳の自動化を実装
        * この変更は 7.1 から


May 20, 2000
        * SJIS UDC（NEC による IBM 漢字）サポート（とくやえいじ氏の貢献による）
        * この変更は 7.0.1 から

Mar 22, 2000
        * libpq に関数 PQsetClientEncoding と PQclientEncoding を追加
        * ./configure --with-mb=EUC_JP の代わりに
          ./configure --enable-multibyte=EUC_JP を使うように変更
        * SQL_ASCII リグレッションテストケースを追加
        * SJIS ユーザー定義文字（UDC）をサポート
        * これらの変更は 7.0 から

July 11, 1999
        * WIN1250（Windows Czech）サポートをクライアントエンコードに追加
         （Pavel Behal の貢献による）
        * コンパイラの警告について修正（にしやまともあき氏の貢献による）

Mar 23, 1999
        * KOI8（KOI8-R）、WIN（CP1251）、ALT（CP866）のサポート
         （Oleg Broytmann によるテストに感謝）
        * MB とロケールに関する問題を修正

Jan 26, 1999
        * フロントエンド符号化方式に Big 5 サポートを追加
         （Big5 を使うにはデータベースを EUC_TW で作成してください）
        * EUC_TW リグレッションテストケースを追加

Dec 15, 1998
        * SQL_ASCII サポートに関するバグを修正

Nov 5, 1998
        * 6.4リリース。このバージョンから pg_database はデータベースの
          符号化方式を表現する「encoding」列を持ちます。

Jul 22, 1998
        * 符号化方式の判定をコンパイル時から initdb/createdb に変更
        * COPY コマンド実行時の PGCLIENTENCODING をサポート
        * SQL92 の SET NAMES をサポート
        * LATIN2-5 をサポート
        * UNICODE リグレッションテストケースを追加
        * MB のテストスイートを追加
        * ソースファイルを整理

Jun 5, 1998
        * バックエンドとフロントエンドの符号化方式翻訳をサポート
        * SET CLIENT_ENCODING などの新しいコマンドを追加
        * LATIN1 文字セットをサポート
        * 8 bit 簡潔さの機能強化

April 21, 1998 
          いくつかの機能強化と修正
        * character_length()、position()、substring() で
          マルチバイト文字を使用可能に
        * octet_length() を追加
        * configure に --with-mb を追加
        * 新しいEUC_KRのリグレッションテスト
         （Soonmyung Hong の貢献による)
        * EUC_JP のリグレッションテストケースを追加
        * System V の regress/regress.sh の問題を修正
        * toupper()、tolower() で 8 ビット文字を扱えるように修正

Mar 25, 1998 
        * PostgreSQL 6.3.1 に MB PL2 を導入

Mar 10, 1998
        PL2 のリリース
        * EUC_JP、EUC_CN、MULE_INTERNAL のリグレッションテストを追加
        * 英語ドキュメント(このファイル)を追加
        * 8 ビットシングルバイト文字に関する問題を修正

Mar 1, 1998
        PL1 のリリース

5.2.8. Windows/ODBC 上の WIN1250

ロケールサポートが有効となっている PostgreSQL では Windows クライアントプラットフォームでの WIN1250 文字セットが使用できます。

以下の項目に注意が必要です。

• 特定のシステムシステムロケールでの動作確認がされています。このテストは cs_CZ.iso8859-2 ロケールの、 Red Hat 6.0 と Slackware 3.6 で行われました。

• 決してサーバーのマルチバイトデータベース符号化方式を WIN1250 に設定しようとしてはいけません。Unix には WIN1250 ロケールが存在しないので常に LATIN2 を使用します。

• WIN1250 符号化方式 Windows ODBC クライアントでのみ使用できます。文字はその時点で正しく表示されて再格納されるよう、変換されます。