createlang

Name

createlang -- define uma nova linguagem procedural do PostgreSQL

Synopsis

createlang [opções_de_conexão...] nome_da_linguagem [nome_bd]
createlang [opções_de_conexão...] --list | -l nome_bd

Entradas

O createlang aceita os seguintes argumentos de linha de comando:

nome_da_linguagem

Especifica o nome da linguagem de programação procedural a ser definida.

-d, --dbname nome_bd

Especifica em qual banco de dados a linguagem deve ser adicionada. O padrão é usar o banco de dados com o mesmo nome do usuário atual do sistema operacional.

-e, --echo

Exibe os comandos SQL à medida que são executados.

-l, --list

Exibe a relação das linguagens instaladas no banco de dados de destino (que deve ser especificado).

--L diretório

Especifica o diretório onde o interpretador da linguagem deve ser encontrado. Normalmente o diretório é encontrado automaticamente; esta opção tem por finalidade a depuração.

O createlang também aceita os seguintes argumentos de linha de comando para os parâmetros de conexão:

-h, --host hospedeiro

Especifica o nome da máquina onde o servidor está executando. Se o nome iniciar por uma barra (/), é considerado como sendo o diretório do soquete do domínio Unix.

-p, --port porta

Especifica a porta Internet TCP/IP, ou o soquete do domínio local Unix, onde o servidor está aguardando as conexões.

-U, --username nome_do_usuário

Nome do usuário para se conectar.

-W, --password

Força a solicitação da senha.

Saídas

A maioria das mensagens de erro são auto-explicativas. Se não for, execute o createlang com a opção --echo e consulte o comando SQL respectivo para obter detalhes. Consulte também o aplicativo psql para ver outras possibilidades.

Descrição

O createlang é um utilitário para adicionar uma nova linguagem de programação a um banco de dados do PostgreSQL. O createlang pode tratar todas as linguagens fornecidas junto com a distribuição padrão do PostgreSQL, mas não as linguagens fornecidas por terceiros.

Embora as linguagens de programação do servidor possam ser adicionadas diretamente usando vários comandos SQL, recomenda-se o uso do createlang porque este realiza várias verificações e é muito mais fácil de usar. Consulte o comando CREATE LANGUAGE para obter mais informações.

Notas

Use o droplang para remover uma linguagem.

O createlang é um script envoltório que chama o psql várias vezes. Se as coisas estiverem dispostas de uma maneira que seja requerida uma senha para se conectar, a senha será solicitada várias vezes.

Utilização

Para instalar a linguagem pltcl no banco de dados template1:

$ createlang pltcl template1