createdb
Nome
createdb -- cria um novo banco de dados do
PostgreSQL
Sinopse
createdb [opção...] [nome_do_banco_de_dados] [descrição]
Descrição
O createdb cria um banco de dados no PostgreSQL.
Normalmente, o usuário do banco de dados que executa este comando se torna o dono do novo banco de dados. Entretanto, pode ser especificado um dono diferente por meio da opção -O, se o usuário que está executando este comando tiver os privilégios apropriados.
O createdb é uma capa em torno do comando
CREATE DATABASE
do SQL. Não existe diferença efetiva entre criar bancos de dados através deste utilitário, ou através de outros métodos para acessar o servidor.
Opções
O createdb aceita os seguintes argumentos de linha de comando:
- nome_do_banco_de_dados
-
Especifica o nome do banco de dados a ser criado. O nome deve ser único entre todos os bancos de dados do PostgreSQL deste agrupamento. O padrão é criar o banco de dados com o mesmo nome do usuário atual do sistema operacional.
- descrição
-
Especifica um comentário a ser associado ao banco de dados recém criado.
- -D local
--location local
-
Especifica o local alternativo para o banco de dados. Consulte também a aplicação
initlocation
.
- -e
--echo
-
Mostra os comandos que o createdb gera e envia para o servidor.
- -E codificação
--encoding codificação
-
Especifica o esquema de codificação de caracteres a ser usado neste banco de dados.
- -O dono
--owner dono
-
Especifica o usuário do banco de dados que será o dono do novo banco de dados.
- -q
--quiet
-
Não exibe resposta.
- -T modelo
--template modelo
-
Especifica o banco de dados modelo, a partir do qual este banco de dados será construído.
As opções -D, -E, -O e -T correspondem às opções do comando
CREATE DATABASE
subjacente; consulte este comando para obter mais informações sobre estas opções.
O createdb 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
-
Se estiver definido, o nome do banco de dados a ser criado, a menos que o nome esteja definido na linha de comando.
- PGHOST
PGPORT
PGUSER
-
Parâmetros de conexão padrão. PGUSER também determina o nome do banco de dados a ser criado, se este não for especificado na linha de comando ou por PGDATABASE.
Diagnósticos
Havendo dificuldade, veja no comando
CREATE DATABASE
e no
psql
a discussão dos problemas possíveis e as mensagens de erro. O servidor de banco de dados deve estar executando no hospedeiro de destino. Também se aplicam todas as definições de conexão padrão e as variáveis de ambiente utilizadas pela biblioteca cliente libpq.
Exemplos
Para criar o banco de dados demo usando o servidor de banco de dados padrão:
$ createdb demo
CREATE DATABASE
A resposta é a mesma que teria sido recebida se fosse executado o comando CREATE DATABASE do SQL.
Para criar o banco de dados demo usando o servidor no hospedeiro eden, a porta 5000, o esquema de codificação LATIN1 e vendo o comando subjacente:
$ createdb -p 5000 -h eden -E LATIN1 -e demo
CREATE DATABASE "demo" WITH ENCODING = 'LATIN1'
CREATE DATABASE