DROP DATABASE

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


Синтаксис

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

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

  FORCE

Описание

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

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


Параметры

IF EXISTS

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

имя

Имя удаляемой базы данных.

FORCE

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

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


Примечания

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

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


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

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


См. также

CREATE DATABASE