dropdb#

dropdb
dropdb
Назад НаверхПриложения клиента PostgreSQLНачало Далее

dropdb

dropdb — удаление базы данных Tantor BE

Синтаксис

dropdb [connection-option...] [option...] dbname

Описание

dropdb уничтожает существующую базу данных Tantor BE. Пользователь, выполняющий эту команду, должен быть суперпользователем базы данных или владельцем базы данных.

dropdb - это оболочка для команды SQL DROP DATABASE. Нет эффективной разницы между удалением баз данных с помощью этой утилиты и другими методами доступа к серверу.

Опции

dropdb принимает следующие аргументы командной строки:

dbname

Указывает имя базы данных, которую нужно удалить.

-e
--echo

Отобразите команды, которые генерирует и отправляет на сервер dropdb.

-f
--force

Попытка завершить все существующие соединения с целевой базой данных перед ее удалением. См. DROP DATABASE для получения дополнительной информации об этой опции.

-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 автоматически запросит пароль, если сервер требует аутентификацию по паролю. Однако dropdb потратит попытку подключения, чтобы узнать, что сервер требует пароль. В некоторых случаях стоит набрать -W, чтобы избежать дополнительной попытки подключения.

--maintenance-db=dbname

Указывает имя базы данных, к которой нужно подключиться для удаления целевой базы данных. Если не указано, будет использоваться база данных postgres; если она не существует (или является удаляемой базой данных), будет использоваться база данных template1. Это может быть строка подключения. Если это так, параметры строки подключения переопределяют любые конфликтующие параметры командной строки.

Окружение

PGHOST
PGPORT
PGUSER

Параметры подключения по умолчанию

PG_COLOR

Определяет, следует ли использовать цвет в диагностических сообщениях. Возможные значения: always, auto и never.

Эта утилита, как и большинство других утилит Tantor BE, также использует переменные среды, поддерживаемые libpq (см. Раздел 31.15).

Диагностика

В случае затруднений см. DROP DATABASE и psql для обсуждения возможных проблем и сообщений об ошибках. Сервер баз данных должен быть запущен на целевом хосте. Кроме того, будут применяться любые настройки соединения по умолчанию и переменные среды, используемые библиотекой libpq для интерфейса.

Примеры

Для удаления базы данных demo на сервере базы данных по умолчанию: 

$ dropdb demo

Для удаления базы данных demo с использованием сервера на хосте eden, порт 5000, с проверкой и просмотром базовой команды: 

$ dropdb -p 5000 -h eden -i -e demo
Database "demo" will be permanently deleted.
Are you sure? (y/n) y
DROP DATABASE demo;

См. также

createdb, DROP DATABASE
Назад Наверх Далее
createuser Начало dropuser