dropdb — elimina una base de datos de PostgreSQL
dropdb [opción-de-conexión...] [opción...] nombre_bd
dropdb destruye una base de datos de PostgreSQL existente. El usuario que ejecuta este comando debe ser un superusuario de la base de datos o el propietario de la misma.
dropdb es un envoltorio (wrapper) del
comando SQL DROP DATABASE.
No hay ninguna diferencia real entre eliminar bases de datos mediante
esta utilidad y mediante otros métodos para acceder al servidor.
dropdb acepta los siguientes argumentos de línea de comandos:
nombre_bdEspecifica el nombre de la base de datos que se va a eliminar.
-e--echoMuestra los comandos que dropdb genera y envía al servidor.
-f--forceIntenta finalizar todas las conexiones existentes a la base de datos de destino antes de eliminarla. Consulta la DROP DATABASE para obtener más información sobre esta opción.
-i--interactiveMuestra un mensaje de verificación antes de realizar cualquier acción destructiva.
-V--versionMuestra la versión de dropdb y finaliza.
--if-existsNo arroja un error si la base de datos no existe. Se emite una advertencia (notice) en este caso.
-?--helpMuestra la ayuda sobre los argumentos de línea de comandos de dropdb y finaliza.
dropdb también acepta los siguientes argumentos de línea de comandos para los parámetros de conexión:
-h host--host=hostEspecifica el nombre de host de la máquina en la que se está ejecutando el servidor. Si el valor comienza con una barra diagonal, se utiliza como el directorio para el socket de dominio Unix.
-p puerto--port=puertoEspecifica el puerto TCP o la extensión del archivo de socket de dominio Unix local en el que el servidor está escuchando conexiones.
-U usuario--username=usuarioNombre de usuario con el que conectarse.
-w--no-password
Nunca solicita una contraseña. Si el servidor requiere
autenticación por contraseña y no hay una contraseña disponible por
otros medios, como un archivo .pgpass, el
intento de conexión fallará. Esta opción puede ser útil en
trabajos por lotes (batch) y scripts donde no hay ningún usuario presente para introducir una
contraseña.
-W--passwordFuerza a dropdb a solicitar una contraseña antes de conectarse a una base de datos.
Esta opción nunca es indispensable, ya que
dropdb solicitará automáticamente
una contraseña si el servidor exige autenticación por contraseña.
Sin embargo, dropdb desperdiciará un
intento de conexión para descubrir que el servidor requiere una contraseña.
En algunos casos, vale la pena escribir -W para evitar el
intento de conexión adicional.
--maintenance-db=nombre_bd
Especifica el nombre de la base de datos a la que conectarse para eliminar la
base de datos de destino. Si no se especifica, se utilizará la base de datos
postgres; si esta no existe (o es la base de datos
que se está eliminando), se utilizará template1.
Esto puede ser una cadena de conexión. Si es así, los parámetros de la cadena de conexión anularán cualquier
opción de línea de comandos en conflicto.
PGHOSTPGPORTPGUSERParámetros de conexión predeterminados.
PG_COLOR
Especifica si se debe usar color en los mensajes de diagnóstico. Los valores posibles
son always, auto y
never.
Esta utilidad, al igual que la mayoría de las demás utilidades de PostgreSQL, también utiliza las variables de entorno soportadas por libpq (consulta la Section 32.15).
En caso de dificultad, consulta la DROP DATABASE y la psql para obtener información sobre posibles problemas y mensajes de error. El servidor de la base de datos debe estar ejecutándose en el host de destino. Además, se aplicará cualquier configuración de conexión predeterminada y variable de entorno utilizada por la biblioteca frontend libpq.
Para eliminar la base de datos demo usando el servidor de
base de datos predeterminado:
$dropdb demo
Para eliminar la base de datos demo usando el
servidor en el host eden, puerto 5000, con confirmación e información del comando subyacente:
$dropdb -p 5000 -h eden -i -e demoDatabase "demo" will be permanently deleted. Are you sure? (y/n)yDROP DATABASE demo;