createdb

Name

createdb -- cria um novo banco de dados do PostgreSQL

Synopsis

createdb [opções...] [nome_bd] [descrição]

Entradas

-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.

-e, --echo

Exibe os comandos que o createdb gera e envia para o servidor.

-q, --quiet

Não exibe a resposta.

-D, --location diretório_de_dados

Especifica o local alternativo de banco de dados. Consulte também o aplicativo initlocation.

-T, --template gabarito

Especifica o banco de dados de gabarito, a partir do qual este banco de dados será gerado.

-E, --encoding codificação

Especifica o esquema de codificação de caracteres a ser usado neste banco de dados.

nome_bd

Especifica o nome do banco de dados a ser criado. O nome deve ser único entre todos os bancos de dados do PostgreSQL desta instalação. O padrão é criar o banco de dados com o mesmo nome do usuário atual do sistema operacional.

descrição

Especifica, opcionalmente, um comentário a ser associado com o banco de dados criado.

As opções -h, -p, -U, -W e -e são passadas literalmente para o psql. As opções -D, -T e -E são convertidas em opções do comando SQL CREATE DATABASE subjacente; consulte este comando para obter mais informações sobre estas opções.

Saídas

CREATE DATABASE

O banco de dados foi criado com sucesso.

createdb: Database creation failed.

A criação do banco de dados falhou.

createdb: Comment creation failed. (Database was created.)

O comentário/descrição para o banco de dados não pôde ser criado, mas o banco de dados foi criado. Pode ser usado agora o comando SQL COMMENT ON DATABASE para criar o comentário.

Se houver uma condição de erro, a mensagem de erro do servidor será exibida. Consulte o comando CREATE DATABASE e o aplicativo psql para ver as causas possíveis.

Descrição

O createdb cria um banco de dados novo do PostgreSQL. O usuário que executa este comando se torna o dono do banco de dados.

O createdb é um script envoltório que usa o comando SQL CREATE DATABASE através do terminal interativo do PostgreSQL psql. Portanto, não existe nada em especial sobre criar bancos de dados desta ou daquela maneira, significando que o psql deve ser encontrado pelo script, e que o servidor de banco de dados deve estar executando na máquina de destino. Também se aplicam os padrões definidos e as variáveis de ambiente disponíveis para o psql e para a biblioteca cliente libpq.

Utilização

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 SQL CREATE DATABASE.

Para criar o banco de dados demo usando o servidor na máquina eden, porta 5000, usando 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