dropdb

примечание

Эта страница переведена при помощи нейросети GigaChat.

dropdb — удаляет базу данных PostgreSQL.

Синтаксис

dropdb [connection-option...] [option...] dbname

Описание

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

dropdb является оболочкой для команды SQL DROP DATABASE. По своей эффективности она не отличается от удаления базы данных другими способами, доступными в сервере PostgreSQL.

Параметры

Для утилиты dropdb существуют следующие параметры командной строки:

dbname

Задает имя базы данных, которую необходимо удалить.

-e
--echo

Выводит на экран команды, которые dropdb отправляет на сервер.

-f
--force

Пытается принудительно завершить все активные подключения к базе данных перед ее удалением. Подробнее описано в разделе о команде DROP DATABASE.

-i
--interactive

Запрашивает подтверждение у пользователя перед удалением.

-V
--version

Выводит версию dropdb и завершается.

--if-exists

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

-?
--help

Показывает справку о параметрах командной строки утилиты dropdb и завершается.

-h host
--host=host

Указывает хост компьютера, на котором запущен сервер. Если значение начинается с косой черты, оно определяет каталог Unix-сокета.

-p port
--port=port

Указывает TCP-порт или расширение файла локального Unix-сокета для подключения к серверу.

-U username
--username=username

Указывает имя пользователя для подключения.

-w
--no-password

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

-W
--password

Запрашивает пароль перед подключением к основному серверу.

Параметр не является обязательным, поскольку dropdb автоматически запросит пароль, если сервер требует аутентификацию паролем. Однако утилита потратит попытку подключения, чтобы выяснить, что сервер хочет пароль. В некоторых случаях стоит ввести -W, чтобы избежать дополнительной попытки подключения.

--maintenance-db=dbname

Указывает имя базы данных, к которой нужно подключиться, чтобы удалить целевую базу данных. Если параметр не задан, используется база postgres. Если она отсутствует или совпадает с удаляемой, применяется template1.

Также можно передать строку подключения. В этом случае параметры строки подключения имеют приоритет над одноименными параметрами командной строки.

Переменные окружения

Утилита поддерживает переменные окружения:

• PGHOST
• PGPORT
• PGUSER
• PG_COLOR

PG_COLOR указывает, использовать ли цвет в диагностических сообщениях. Возможные значения — always, auto и never.

Утилита dropdb использует переменные окружения, поддерживаемые libpq.

Диагностика

В случае возникновения трудностей, обратитесь в разделы DROP DATABASE и psql.

Сервер базы данных должен быть запущен на целевом хосте. Кроме того, будут применяться стандартные настройки подключения и переменные окружения, применяемые библиотекой интерфейса libpq.

Примеры

Удаление базы данных demo на сервере баз данных по умолчанию:

$ dropdb demo

Удаление базы данных demo с использованием сервера на хосте eden, порт 5000, с проверкой и просмотром SQL команды:

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

Смотрите также

createdb, DROP DATABASE