createlang
Nome
createlang -- cria uma linguagem procedural do
PostgreSQL
Sinopse
createlang [opções_de_conexão...] nome_da_linguagem [nome_do_banco_de_dados]
createlang [opções_de_conexão...] --list | -l nome_do_banco_de_dados
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 na 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 usar a aplicação createlang, porque esta realiza várias verificações, e é muito mais fácil usá-la. Consulte o comando
CREATE LANGUAGE
para obter informações adicionais.
Opções
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] nome_do_banco_de_dados
[--dbname] nome_do_banco_de_dados
-
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 corrente do sistema operacional.
- -e
--echo
-
Mostra os comandos SQL à medida que são executados.
- -l
--list
-
Mostra a relação de linguagens instaladas no banco de dados de destino.
- -L diretório
-
Especifica o diretório onde o interpretador da linguagem deve ser encontrado. Normalmente o diretório é encontrado automaticamente; esta opção é principalmente para fins de depuração.
O createlang também aceita os seguintes argumentos de linha de comando para os parâmetros de conexão:
- -h hospedeiro
--host hospedeiro
-
Especifica o nome de hospedeiro da máquina onde o servidor está executando. Se o nome iniciar por uma barra (/) é usado como o diretório do soquete do domínio Unix.
- -p porta
--port porta
-
Especifica a porta TCP, ou a extensão de arquivo do soquete do domínio Unix local, onde o servidor está escutando as conexões.
- -U nome_do_usuário
--username nome_do_usuário
-
Nome do usuário para conectar.
- -W
--password
-
Força a solicitação da senha.
Ambiente
- PGDATABASE
PGHOST
PGPORT
PGUSER
-
Parâmetros de conexão padrão.
Diagnósticos
As mensagens de erro são auto-explicativas, em sua maioria. Caso não seja, execute o createlang com a opção --echo e consulte o respectivo comando SQL para obter detalhes.
Observações
Use
droplang
para remover uma linguagem.
Exemplos
Para instalar a linguagem pltcl no banco de dados template1:
$ createlang pltcl template1