DROP DATABASE

DROP DATABASE — удалить базу данных

Синтаксис

DROP DATABASE [ IF EXISTS ] имя [ [ WITH ] ( параметр [, ...] ) ]

Где параметр может быть:

  FORCE

Описание

Команда DROP DATABASE удаляет базу данных. Она удаляет записи из каталогов, которые относятся к базе данных, и удаляет каталог, содержащий данные. Выполнить команду может только владелец базы данных. Кроме того, команда не может быть выполнена, пока вы или кто-либо другой подключен к целевой базе данных. (Чтобы выполнить эту команду, подключитесь к QHB или любой другой базе данных.)

Действие команды DROP DATABASE нельзя отменить. Используйте ее с осторожностью!

Параметры

IF EXISTS

Не считать ошибкой, если база данных не существует. В этом случае будет выдано соответствующее уведомление.

имя

Имя базы данных, подлежащей удалению.

FORCE

Попытаться завершить все существующие подключения к целевой базе данных. Подключения не завершаются, если в целевой базе данных находятся подготовленные транзакции, активные слоты логической репликации или подписки.

Данная операция завершится ошибкой, если у текущего пользователя нет прав завершать другие подключения (это те же права, что требуются для выполнения pg_terminate_backend; они описаны в разделе Функции сигнализации сервера). Также ошибка произойдет, если завершить подключения не удастся.

Примечания

Команда DROP DATABASE не может быть выполнена внутри блока транзакций.

Эта команда не может быть выполнена, если установлено подключение к целевой базе данных. Таким образом, возможно, будет удобнее использовать вместо нее программу dropdb, которая является ее оболочкой.

Совместимость

В стандарте SQL нет команды DROP DATABASE.

См. также

CREATE DATABASE