dropdb

Nombre

dropdb  --  Borra una base de datos PostgreSQL existente

Synopsis

dropdb [ opciones ] nombre_bd
  

Inputs

-h, --host host

Especifica el nombre de host de la máquina sobre la que el postmaster esté corriendo.

-p, --port puerto

Especifica el puerto TCP/IP o el socket Unix local en el que postmaster atiende conexiones.

-U, --username nombre_usuario

Nombre de usuario con el que se va a conectar.

-W, --password

Fuerza la introducción de un password.

-e, --echo

Muestra en pantalla las consultas que dropdb genera y envía al backend.

-q, --quiet

No muestra respuesta alguna.

-i, --interactive

Antes de hacer algo destructivo, pide confirmación a través del prompt.

nombre_bd

Especifica el nombre de la bases de datos que va a ser borrada. Debe ser una de las existentes en esta instalación de PostgreSQL .

Las opciones -h, -p, -U, -W, y -e se pasan literalmente a psql.

Outputs

DROP DATABASE

La base de datos ha sido borrada con éxito.

dropdb: Database removal failed.

Algo no ha ido bien.

Si se produce un error, se mostrará el mensaje de error del backend. Vea drop_database y psql para más información.

Descripción

dropdb destruye una base de datos PostgreSQL existente. El usuario que ejecute este comando debe ser un superusuario de la base de datos o su propietario.

dropdb es un envoltorio del shell script alrededor del comando SQL drop_database por medio del terminal interactivo psql de PostgreSQL. De este modo, no hay nada especial en en borrar bases de datos por medio de este u otros métodos. Esto significa que psql debe ser encontrado por el script y que un servidor de bases de datos está en marcha en el host de destino. También cualquier valor por defecto o cualquier variable de entorno disponible para psql y libpq se aplican.

Uso

Para destruir la base de datos demo en el servidor de bases de datos por defecto:

$ dropdb demo
DROP DATABASE
   

Para destruir la base de datos demo usando el postmaster del host eden, puerto 5000, con verificación y echando un vistazo a la consulta en marcha:

$ dropdb -p 5000 -h eden -i -e demo
Database "demo" will be permanently deleted.
Are you sure? (y/n) y
DROP DATABASE "demo"
DROP DATABASE