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 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

Voici de bonnes sources pour commencer à maîtriser les différents jeux de caractères.