dropdb
Описание
dropdb удаляет ранее созданную базу данных PostgreSQL, и должна выполняться от имени суперпользователя или её владельца.
dropdb это обёртка для SQL-команды DROP DATABASE. Удаление баз данных с её помощью по сути не отличается от выполнения того же действия при обращении к серверу другими способами.
Параметры
dropdb принимает в качестве аргументов:
- база_данных
Указывает имя удаляемой базы данных.
- -e
--echo Вывести команды к серверу, генерируемые при выполнении dropdb.
- -i
--interactive Выводит вопрос о подтверждении перед удалением.
- -V
--version Выводит версию dropdb.
- --if-exists
Не считать ошибкой, если база данных не существует. В этом случае будет выдано замечание.
- -?
--help Вывести справку по команде dropdb.
dropdb также принимает из командной строки параметры подключения:
- -h host
--host=host Указывает имя компьютера, на котором запущен сервер. Если значение начинается с косой черты, оно интерпретируется как имя каталога с доменным сокетом Unix.
- -p порт
--port=порт Указывает TCP-порт или расширение файла Unix-сокета, на котором сервер слушает подключения.
- -U имя_пользователя
--username=имя_пользователя Имя пользователя, под которым производится подключение.
- -w
--no-password Не выдавать запрос на ввод пароля. Если сервер требует аутентификацию по паролю и пароль не доступен с помощью других средств, таких как файл .pgpass, попытка соединения не удастся. Этот параметр может быть полезен в пакетных заданиях и скриптах, где нет пользователя, который вводит пароль.
- -W
--password Принудительно запрашивать пароль перед подключением к базе данных.
Это несущественный параметр, так как dropdb запрашивает пароль автоматически, если сервер проверяет подлинность по паролю. Однако, чтобы понять это, dropdb лишний раз подключается к серверу. Поэтому иногда имеет смысл ввести -W, чтобы исключить эту ненужную попытку подключения.
- --maintenance-db=база_данных
Указывает имя базы данных, к которой будет произведено подключение при удалении целевой. Если имя не указано, то будет использовано postgres. Если же postgres не существует, то будет использоваться template1.
Переменные окружения
- PGHOST
PGPORT
PGUSER Параметры подключения по умолчанию
Эта утилита, как и большинство других утилит PostgreSQL, также использует переменные среды, поддерживаемые libpq (см. Раздел 31.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;
Пред. | Начало | След. |
createuser | Уровень выше | droplang |