20.2. Support des jeux de caract�res

20.2.1. Jeux de Caract�res Support�s

Le Tableau 20-1 montre les jeux de caract�res disponibles � l'utilisation sur le serveur.

Tout les APIs ne supportent pas les jeux de caract�res de la liste. Par exemple, le pilot JDBC de PostgreSQL ne supporte pas MULE_INTERNAL, LATIN6, LATIN8 et LATIN10.

20.2.2. Choisir le Jeu de Caract�res

initdb d�finit le jeu de caract�res par d�faut pour un cluster PostgreSQL. Par exemple,

initdb -E EUC_JP

param�tre le jeu de caract�res (codage) � EUC_JP (Extended Unix Code for Japanese). Vous pouvez utiliser l'option --encoding au lieu de -E si vous pr�f�rez saisir les noms d'options longs. Si aucune option -E ou --encoding n'est donn�e, SQL_ASCII est utilis�.

Vous pouvez cr�er une base de donn�es avec un jeu de caract�re diff�rent:

createdb -E EUC_KR korean

Ceci va cr�er une base de donn�es appel�e korean qui utilisera le jeu de caract�re EUC_KR. Un autre moyen de r�aliser ceci est d'utiliser cette commande SQL :

CREATE DATABASE korean WITH ENCODING 'EUC_KR';

L'encodage pour une base de donn�es est conserv� dans le catalogue syst�me pg_database. Vous pouvez voir ceci en utilisant l'option -l ou la commande \l de psql.

$ psql -l
            List of databases
   Database    |  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)

20.2.3. Conversion de Jeu de Caract�res Automatique entre Serveur et Client

PostgreSQL supporte les conversions automatiques de jeu de caract�res entre client et serveur pour certains jeux de caract�res. Les informations de conversion sont conserv�s dans le catalogue syst�me pg_conversion. Vous pouvez cr�er une nouvelle conversion en utilisant la commande SQL CREATE CONVERSION. PostgreSQL est livr� avec certaines conversions pr�d�finies. Ils sont list�s dans Tableau 20-2.

Pour activer la conversion automatique de jeux de caract�res, vous devez dire � PostgreSQL quel jeu de caract�res (encodage) vous voulez utiliser c�t� client. Il y'a plusieurs fa�ons de faire cela:

• En utilisant la commande \encoding dans psql. \encoding vous permet de changer de jeu de caract�res client � la vol�e. Par exemple, pour changer l'encodage en SJIS, tapez:

  \encoding SJIS

• En utilisant les fonctions libpq. \encoding appelle en fait PQsetClientEncoding() pour faire son travail.

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

  ou conn est une connexion au serveur, et encoding est l'encodage que vous voulez utiliser. Si la fonction fixe l'encodage, elle renvoie 0, sinon -1. L'encodage actuel pour cette connexion peut �tre d�termin� en utilisant:

  int PQclientEncoding(const PGconn *conn);

  Notez que ceci renvoie l'ID d'encodage, pas une cha�ne symbolique tel que EUC_JP. Pour convertir un ID d'encodage en NOM, vous pouvez utiliser:

  char *pg_encoding_to_char(int encoding_id);

• En utilisant SET client_encoding TO. Fixer l'encodage client peut �tre fait avec cette commande SQL:

  SET CLIENT_ENCODING TO 'valeur';

  Vous pouvez aussi utiliser la syntaxe SQL plus standard SET NAMES pour ceci:

  SET NAMES 'valeur';

  Pour demander l'actuel encodage client:

  SHOW client_encoding;

  Pour revenir � l'encodage par d�faut:

  RESET client_encoding;

• En utilisant PGCLIENTENCODING. Si la variable d'environnement PGCLIENTENCODING est d�finie dans l'environnement client, cet encodage client est automatiquement s�lectionn� lorsqu'une connexion au serveur est �tablie. (Ceci peut �tre surcharg� avec n'importe quelle autre des m�thodes ci-dessus.)

• En utilisant la variable de configuration client_encoding. Si la variable client_encoding dans postgresql.conf est d�finie, cet encodage client est automatiquement s�lectionn� lorsqu'une connexion au serveur est �tablie. (Ceci peut �tre surcharg� avec n'importe quelle autre des m�thodes ci-dessus.)

Si la conversion d'un caract�re particulier n'est pas possible -- supposons que vous avez choisi EUC_JP pour le serveur et LATIN1 pour le client, alors certains caract�res japonais ne pourront pas �tre convertis en LATIN1 -- ils seront transform�s en leur valeur hexad�cimale entre parenth�ses, i.e., (826C).

20.2.4. Plus de Lecture

Ceux-ci sont de bonnes sources pour commencer � ma�triser les diff�rents jeux de caract�res.