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