dropdb
dropdb — удалить базу данных QHB
Синтаксис
dropdb [Флаг...] [Параметр...] имя_бд --host=хост
Описание
Утилита dropdb удаляет уже существующую базу данных QHB. Пользователь, который выполняет эту команду, должен быть суперпользователем или владельцем этой базы.
dropdb — это обертка для команды SQL DROP DATABASE. Между удалением баз данных с помощью этой утилиты и их удалением иными способами при обращении к серверу по сути нет никакой разницы.
Для сохранения соединения необходимо подключиться к обслуживающей базе данных (флаг maintenance-db), так как нельзя удалить базу данных, к которой подключен. Также нельзя удалить базу template1 и/или template0.
Параметры
dropdb принимает следующие аргументы командной строки:
имя_бд
Задает имя удаляемой базы данных.
-e
--echo
Отобразить на экране команды, которые dropdb генерирует и отправляет на
сервер.
-f
--force
Попытаться принудительно завершить все существующие подключения к целевой базе,
прежде чем удалять ее. Подробную информацию об этом см. в описании команды
DROP DATABASE.
-i
--interactive
Выдает запрос о подтверждении перед удалением.
--if-exists
Не считать ошибкой, если базы данных не существует. В этом случае выдается
уведомление.
-V
--version
Вывести версию dropdb и завершиться.
-?
--help
Показать справку об аргументах командной строки dropdb и завершиться.
Кроме того, в качестве параметров подключения dropdb принимает следующие аргументы командной строки:
-h хост
--host=хост
Задает имя хост-компьютера, на котором работает сервер. Если значение начинается
со слэша, оно используется в качестве каталога для Unix-сокета.
-p порт
--port=порт
Указывает TCP-порт или расширение файла локального Unix-сокета, через который
сервер принимает подключения.
-U имя_пользователя
--username=имя_пользователя
Имя пользователя, под которым производится подключение.
-w
--no-password
Никогда не запрашивать ввод пароля. Если серверу требуется аутентификация по
паролю, и пароль недоступен с помощью иных средств, таких как файл .pgpass,
попытка подключения завершится неудачно. Этот параметр может быть полезен в
пакетных заданиях и скриптах, где нет пользователя, чтобы ввести пароль.
-W
--password
Принудительно запрашивать пароль перед подключением к базе данных.
Это несущественный параметр, так как dropdb автоматически запросит пароль, если сервер требует аутентификацию по паролю. Однако чтобы выяснить это, dropdb потребуется дополнительная попытка подключения к серверу. В некоторых случаях имеет смысл ввести -W, чтобы исключить эту лишнюю попытку.
--maintenance-db=имя_бд Задает имя базы данных, к которой будет произведено подключение при удалении целевой базы. Если это имя не указано, будет выбрана база данных qhb, а если она не существует (или это имя удаляемой базы) — template1.
Окружение
PGHOST
PGPORT
PGUSER
Параметры подключения по умолчанию
PG_COLOR
Указывает, использовать ли цвета в диагностических сообщениях. Возможные значения:
always (всегда), auto (автоматически) и never (никогда).
Диагностика
В случае возникновения затруднений обратитесь к DROP DATABASE и psql, где рассматриваются потенциальные проблемы и сообщения об ошибках. Сервер базы данных должен работать на целевом хосте.
Примеры
Удалить базу данных new_db. Информация о подключении берется из среды:
$ dropdb new_db
Удалить базу данных new_db на сервере localhost, порт 5432, в интерактивном режиме:
$ dropdb -h localhost -p 5432 -i new_db
Database "new_db" will be permanently removed.
Are you sure? (Y/n):