O utilitário createdb cria um banco de dados do 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 utilitário possuir os privilégios apropriados.
O createdb é um invólucro 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.
O createdb aceita os seguintes argumentos de linha de comando:
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 corrente do sistema operacional.
Especifica um comentário a ser associado ao banco de dados recém criado.
Especifica o espaço de tabelas padrão para o banco de dados.
Mostra os comandos que o createdb gera e envia para o servidor.
Especifica o esquema de codificação de caracteres a ser usado neste banco de dados. Os conjuntos de caracteres suportados pelo servidor PostgreSQL estão descritos na Seção 21.2.1.
Especifica o usuário do banco de dados que será o dono do novo banco de dados.
Não exibe resposta.
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 SQL CREATE DATABASE subjacente; consulte este comando para obter informações adicionais sobre estas opções.
O createdb também aceita os seguintes argumentos de linha de comando para os parâmetros de conexão:
Especifica o nome de hospedeiro da máquina onde o servidor está executando. Se o nome iniciar por uma barra (/), será utilizado como o diretório do soquete do domínio Unix.
Especifica a porta TCP, ou a extensão de arquivo do soquete do domínio Unix local, onde o servidor está atendendo as conexões.
Nome do usuário para conectar.
Força a solicitação da senha.
Se estiver definida, o nome do banco de dados a ser criado, a menos que o nome esteja definido na linha de comando.
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.
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.
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
