Le Tableau 21.1, « Jeux de caractères de PostgreSQL » montre les jeux de caractères disponibles à l'utilisation dans PostgreSQL™.

Toutes les API ne supportent pas les jeux de caractères de la liste. Par exemple, le pilote JDBC de PostgreSQL™ ne supporte pas MULE_INTERNAL, LATIN6, LATIN8 et LATIN10.

La valeur SQL_ASCII se comporte de façon considérablement différente des autres valeurs. Quand l'ensemble de caractères du serveur est SQL_ASCII, le serveur interprète les valeurs des octets 0-127 suivant le standard ASCII alors que les valeurs d'octets 128-255 sont considérées comme des caractères non interprétés. Aucune conversion de codage ne sera effectuée avec SQL_ASCII. Du coup, cette valeur n'est pas tellement la déclaration qu'un codage spécifique est utilisé, mais plutôt de l'ignorance du codage. Dans la plupart des cas, si vous travaillez avec des données non ASCII, il est déconseillé d'utiliser la valeur SQL_ASCII car PostgreSQL™ sera incapable de vous aider dans la conversion ou la validation des caractères non ASCII.

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, initdb tente de déterminer le codage approprié à utiliser suivant la locale spécifiée ou par défaut.

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

Le codage 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
 postgres      | t-ishii | EUC_JP
 regression    | t-ishii | SQL_ASCII
 template1     | t-ishii | EUC_JP
 test          | t-ishii | EUC_JP
 utf8          | t-ishii | UTF8
(9 rows)

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ées dans le catalogue système pg_conversion. PostgreSQL™ est livré avec certaines conversions prédéfinies, conversions listées dans le Tableau 21.2, « Conversion de jeux de caractères client/serveur ». Vous pouvez créer une nouvelle conversion en utilisant la commande SQL CREATE CONVERSION.

Pour activer la conversion automatique de jeux de caractères, vous devez dire à PostgreSQL™ quel jeu de caractères (codage) vous voulez utiliser côté client. Il y a plusieurs façons de faire cela :

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 n'ont pas de représentation en LATIN1 -- une erreur est alors rapportée.

Si l'ensemble de caractères du client est défini en tant que SQL_ASCII, la conversion du codage est désactivée quelque soit l'ensemble de caractères du serveur. Comme pour le serveur, utiliser SQL_ASCII est déconseillé sauf si vous ne travaillez qu'avec des données ASCII.

Ceux-ci sont de bonnes sources pour commencer à maîtriser les différents jeux de caractères.