DROP DATABASE

DROP DATABASE — elimina una base de datos

Synopsis

DROP DATABASE [ IF EXISTS ] nombre [ [ WITH ] ( opción [, ...] ) ]

donde opción puede ser:

    FORCE

Descripción

DROP DATABASE elimina una base de datos. Quita las entradas del catálogo para la base de datos y borra el directorio que contiene los datos. Solo puede ser ejecutado por el propietario de la base de datos. No se puede ejecutar mientras estés conectado a la base de datos de destino. (Conéctate a postgres o a cualquier otra base de datos para emitir este comando). Además, si algún otro usuario está conectado a la base de datos de destino, este comando fallará a menos que utilices la opción FORCE descrita a continuación.

DROP DATABASE no se puede deshacer. ¡Úsalo con cuidado!

Parámetros

IF EXISTS

No arroja un error si la base de datos no existe. Se emite una advertencia (notice) en este caso.

nombre

El nombre de la base de datos que se va a eliminar.

FORCE

Intenta finalizar todas las conexiones existentes a la base de datos de destino. No las finaliza si hay transacciones preparadas, slots de replicación lógica activos o suscripciones presentes en la base de datos de destino.

Esto finaliza las conexiones de procesos de fondo (background workers) y las conexiones que el usuario actual tiene permiso para finalizar con pg_terminate_backend, descrito en la Section 9.28.2. Si aún quedaran conexiones, este comando fallará.

Notas

DROP DATABASE no se puede ejecutar dentro de un bloque de transacción.

Este comando no se puede ejecutar mientras se esté conectado a la base de datos de destino. Por lo tanto, puede resultar más conveniente utilizar el programa dropdb en su lugar, el cual es un envoltorio de este comando.

Compatibilidad

No existe la sentencia DROP DATABASE en el estándar SQL.

Véase también

CREATE DATABASE