CREATE CONVERSION

Nom

CREATE CONVERSION -- définir une nouvelle conversion de codage

Synopsis

CREATE [DEFAULT] CONVERSION nom
    FOR codage_source TO codage_dest FROM fonction

Description

CREATE CONVERSION définit une nouvelle conversion entre les codages d'ensembles de caractères. Les noms de conversion pourront être utilisés dans la fonction convert pour spécifier une conversion de codage particulière. De plus, les conversions marquées DEFAULT peuvent être utilisées pour une conversion de codage automatique entre le client et le serveur. Pour y arriver, deux conversions, du codage A à B et du codage B à A, doivent être définies.

Pour être capable de créer conversion, vous devez avoir le droit EXECUTE sur la fonction et le droit CREATE sur le schéma de destination.

Paramètres

DEFAULT

La clause DEFAULT indique que cette conversion est celle par défaut pour un codage de cette source vers cette destination. Il ne doit y avoir qu'un codage par défaut dans un schéma pour une paire de codage.

nom

Le nom de la conversion. Ce nom pourrait être qualifié avec le nom du schéma. Si ce n'est pas le cas, la conversion est définie dans le schéma actuel. Le nom de la conversion doit être unique dans un schéma.

codage_source

Le nom du codage source.

codage_dest

Le nom du codage destination.

fonction

La fonction utilisée pour réaliser la conversion. Le nom de la fonction pourrait être qualifié avec le nom du schéma. Si ce n'est pas le cas, la fonction sera cherchée dans le chemin.

La fonction doit avoir la signature suivante :

conv_proc(
    integer,  -- ID codage source
    integer,  -- ID codage destination
    cstring,  -- chaîne source (chaîne C terminée par un caractère nul)
    internal, -- destination (remplie avec une chaîne C terminée par un caractère nul)
    integer   -- longueur de la chaîne source
) RETURNS void;

Notes

Utilisez DROP CONVERSION pour supprimer une conversion définie par l'utilisateur.

Les droits requis pour créer une conversion pourraient être modifiées dans une version ultérieure.

Exemples

Pour créer une conversion du codage UNICODE vers le codage LATIN1 en utilisant mafonc :

CREATE CONVERSION maconv FOR 'UNICODE' TO 'LATIN1' FROM mafonc;

Compatibilité

CREATE CONVERSION est une extension PostgreSQL. Il n'existe pas d'instruction CREATE CONVERSION dans le standard SQL.

Voir aussi

ALTER CONVERSION, CREATE FUNCTION, DROP CONVERSION