dropdb
dropdb — удалить базу данных Postgres Pro
Синтаксис
dropdb
[параметр-подключения
...] [параметр
...] имя_бд
Описание
dropdb удаляет ранее созданную базу данных Postgres Pro, и должна выполняться от имени суперпользователя или её владельца.
dropdb это обёртка для SQL-команды DROP DATABASE. Удаление баз данных с её помощью по сути не отличается от выполнения того же действия при обращении к серверу другими способами.
Параметры
dropdb принимает в качестве аргументов:
имя_бд
Указывает имя удаляемой базы данных.
-e
--echo
Вывести команды к серверу, генерируемые при выполнении dropdb.
-i
--interactive
Выводит вопрос о подтверждении перед удалением.
-V
--version
Выводит версию dropdb.
--if-exists
Не считать ошибкой, если база данных не существует. В этом случае будет выдано замечание.
-?
--help
Вывести справку по команде dropdb.
dropdb также принимает из командной строки параметры подключения:
-h
сервер
--host=
сервер
Указывает имя компьютера, на котором работает сервер. Если значение начинается с косой черты, оно определяет каталог Unix-сокета.
-p
порт
--port=
порт
Указывает TCP-порт или расширение файла локального Unix-сокета, через который сервер принимает подключения.
-U
имя_пользователя
--username=
имя_пользователя
Имя пользователя, под которым производится подключение.
-w
--no-password
Не выдавать запрос на ввод пароля. Если сервер требует аутентификацию по паролю и пароль не доступен с помощью других средств, таких как файл
.pgpass
, попытка соединения не удастся. Этот параметр может быть полезен в пакетных заданиях и скриптах, где нет пользователя, который вводит пароль.-W
--password
Принудительно запрашивать пароль перед подключением к базе данных.
Это несущественный параметр, так как dropdb запрашивает пароль автоматически, если сервер проверяет подлинность по паролю. Однако чтобы понять это, dropdb лишний раз подключается к серверу. Поэтому иногда имеет смысл ввести
-W
, чтобы исключить эту ненужную попытку подключения.--maintenance-db=
имя_бд
Указывает имя опорной базы данных, к которой будет произведено подключение для удаления целевой. Если имя не указано, будет выбрана база
postgres
, а если она не существует (или именно она и удаляется) —template1
. Здесь может задаваться строка подключения. В этом случае параметры в строке подключения переопределяют одноимённые параметры, заданные в командной строке.
Переменные окружения
PGHOST
PGPORT
PGUSER
Параметры подключения по умолчанию
Эта утилита, как и большинство других утилит Postgres Pro, также использует переменные среды, поддерживаемые libpq (см. Раздел 35.14).
Диагностика
В случае возникновения трудностей, обратитесь к DROP DATABASE и psql. При диагностике следует учесть, что при запуске утилиты также применяются переменные окружения и параметры подключения по умолчанию libpq.
Примеры
Для удаления базы данных demo
на сервере, используемом по умолчанию:
$
dropdb demo
Для удаления базы данных demo
на сервере eden
, слушающим подключения на порту 5000, в интерактивном режиме и выводом запросов к серверу:
$
dropdb -p 5000 -h eden -i -e demo
База данных "demo" будет удалена навсегда. Продолжить? (y/n)
y
DROP DATABASE demo;