Documentação do PostgreSQL 7.4.1
Anterior Início Fim Próxima

CREATE CONVERSION

Nome

CREATE CONVERSION -- cria uma conversão de codificação

Sinopse

CREATE [DEFAULT] CONVERSION nome
    FOR codificação_de_origem TO codificação_de_destino FROM nome_da_função

Descrição

O comando CREATE CONVERSION cria uma conversão de codificação. Os nomes das conversões podem ser utilizados na função convert para especificar uma determinada conversão de codificação. Além disso, as conversões marcadas como DEFAULT podem ser utilizadas para fazer a conversão automática de codificação entre o cliente e o servidor. Para esta finalidade devem ser criadas duas conversões: da codificação A para B e da codificação B para A.

Para poder criar uma conversão é necessário possuir o privilégio EXECUTE na função, e o privilégio CREATE no esquema de destino.

Parâmetros

DEFAULT
A cláusula DEFAULT indica que esta é a conversão padrão para o caso particular destas codificações de origem e de destino. Em um esquema deve existir apenas uma codificação padrão para cada par de codificações.
nome
O nome da conversão. O nome da conversão pode ser qualificado pelo esquema. Caso não seja, a conversão é criada no esquema corrente. O nome da conversão deve ser único no esquema.
codificação_de_origem
O nome da codificação de origem.
codificação_de_destino
O nome da codificação de destino.
nome_da_função
A função utilizada para realizar a conversão. O nome da função pode ser qualificado pelo esquema. Caso não seja, a função é procurada no caminho. A função deve possuir a seguinte assinatura: 
funcao_de_conversao(
    integer,  -- identificador da codificação de origem
    integer,  -- identificador da codificação de destino
    cstring,  -- cadeia de caracteres de origem (cadeia de caracteres C terminada por nulo)
    cstring,  -- cadeia de caracteres de destino (cadeia de caracteres C terminada por nulo)
    integer   -- comprimento da cadeia de caracteres de origem
) RETURNS void;

Observações

Use o comando DROP CONVERSION para remover conversões definidas pelo usuário.

Os privilégios necessários para criar conversão podem ser alterados em uma versão futura.

Exemplos

Para criar a conversão da codificação UNICODE para LATIN1 utilizando minha_funcao:

CREATE CONVERSION minha_conversao FOR 'UNICODE' TO 'LATIN1' FROM minha_funcao;

Compatibilidade

O comando CREATE CONVERSION é uma extensão do PostgreSQL. Não existe o comando CREATE CONVERSION no padrão SQL.

Veja também

ALTER CONVERSION , CREATE FUNCTION , DROP CONVERSION
Anterior Principal Próxima
CREATE CONSTRAINT TRIGGER Acima CREATE DATABASE
SourceForge.net Logo