createdb

Nombre

createdb  --  Crea una nueva base de datos PostgreSQL

Synopsis

createdb [ options ] dbname [ descripcion ]
  

Inputs

-h, --host host

Especifica el nombre de host (hostname) de la maquina sobre la que esta ejecutandose la postmaster.

-p, --port port

Especifica el puerto TCP/IP Internet o la extension del fichero de socket del dominio local Unix en el cual la postmaster esta escuchando para recibir conexiones.

-U, --username username

Usuario como el que se conecta.

-W, --password

Fuerza a que se teclee password.

-e, --echo

Muestra la consulta que createdb genera y envia al motor de la base de datos (backend)

-q, --quiet

No muestra ninguna respuesta.

-D, --location datadir

especifica localizacion alternativa de la base de datos para esta instalacion de la base de datos. Esta es la localizacion de las tablas del sistema, no la localizacion de esta base de datos especifica, que puede ser diferente.

-E, --encoding encoding

Especifica el esquema de codificacion de caracteres que se usara con esta base de datos.

dbname

Especifica el nombre de la base de datos que sera creada. El nombre debe ser unico entre todas las bases de datos PostgreSQL en esta instalacion. El valor por omision es crear una base de datos con el mismo nombre que el usuario en curso del sistema.

description

Opcionalmente esto especifica un comentario que sera asociado con la base de datos nuevamente creada.

Las opciones -h, -p, -U, -W, y -e son pasadas literalmente a psql.

Outputs

CREATE DATABASE

La base de datos fue creada exitosamente.

createdb: Creacion de la base de datos fallida.

(Lo dice todo.)

createdb: Comentario a la creacion fallida. (La base de datos fue creada.)

El comentario/descripcion para la base de datos que no ha podido ser creada. La base de datos misma podria haber sido creada ya. Puedes utilizar el comando SQL COMMENT ON DATABASE para crearle el comentario despues.

Si hay un error en la condicion, el error del motor de base de datos (backend) sera mostrado. Vease CREATE DATABASE y psql para mas posibilidades.

Descripcion

createdb crea una nueva base de datos PostgreSQL. El usuario que ejecuta este comando se convierte en el propietario de la base de datos.

createdb es una script shell que envuelve un comando SQL CREATE DATABASE a traves del terminal interactivo de PostgreSQL psql. Asi pues, no hay nada especial sobre la creacion de bases de datos por este u otros metodos. Esto significa que el psql debe ser encontrado por el script y que un servidor de base de datos esta ejecutandose en el hosts destino. Tambien, cualquier cualquier configuracion por defecto y variable de entorno disponible para psql y la libreria front-end libpq se aplicaran.

Uso

Para crear la base de datos demo utilizando el servidor por defecto de base de datos:

$ createdb demo
CREATE DATABASE
   
La respuesta es la misma que hubieses tenido de ejecutar el comando de SQL CREATE DATABASE.

Para crear una base de datos demo utilizando la postmaster en la maquina (host) eden, puerto 5000, utilizando el esquema de codificacion LATIN1 con una mirada en la consulta subrayada:

$ createdb -p 5000 -h eden -E LATIN1 -e demo
CREATE DATABASE "demo" WITH ENCODING = 'LATIN1'
CREATE DATABASE