dropdb
Удаляет базу данных.
Синтаксис
dropdb [<connection-option> ...] [-e] [-i] <dbname>
dropdb -? | --help
dropdb -V | --versionОписание
dropdb удаляет существующую базу данных.
Пользователь, запускающий эту команду, должен быть суперпользователем или владельцем удаляемой базы данных.
dropdb является оберткой для SQL-команды DROP DATABASE.
Параметры
- <dbname>
-
Имя удаляемой базы данных.
- -e | --echo
-
Отображает команды, которые
dropdbгенерирует и отправляет на сервер. - -i | --interactive
-
Запрашивает подтверждение перед выполнением действий, которые могут удалить или изменить данные.
- -V | --version
-
Выводит версию
dropdbи завершает работу. - --if-exists
-
Не выдает ошибку, если база данных не существует. В этом случае будет выведено уведомление.
- -? | --help
-
Выводит справку по аргументам командной строки
dropdbи завершает работу.
Параметры подключения
- -h <host> | --host=<host>
-
Имя хоста, на котором запущен экземпляр мастера. Если параметр не указан, читается из переменной окружения
PGHOSTили используется значение по умолчаниюlocalhost. - -p <port> | --port=<port>
-
TCP-порт, на котором мастер принимает подключения. Если параметр не указан, читается из переменной окружения
PGPORTили используется значение по умолчанию5432. - -U <username> | --username=<username>
-
Имя роли для подключения. Если параметр не указан, читается из переменной окружения
PGUSERили используется имя пользователя операционной системы. - -w | --no-password
-
Не запрашивает пароль. Если сервер требует пароль и он недоступен другими способами (например, через файл .pgpass), подключение завершится неудачей. Этот параметр удобен для пакетных заданий и скриптов, где невозможен интерактивный ввод пароля.
- -W | --password
-
Принудительно запрашивает пароль.
- --maintenance-db=<dbname>
-
Указывает базу данных, к которой выполняется подключение для удаления целевой базы. Если параметр не указан, будет использована база данных
postgres; если она не существует (или является именем удаляемой базы данных), будет использованаtemplate1.
Примеры
-
Удалить базу данных
demo, используя параметры подключения по умолчанию:$ dropdb demo -
Удалить базу данных
demo, используя указанные параметры подключения, с запросом подтверждения и выводом базовой команды:$ dropdb -p 54321 -h mdw -i -e demoЗапрос подтверждения:
Database "demo" will be permanently deleted. Are you sure? (y/n) y
Результат:
DROP DATABASE "demo" DROP DATABASE