ДОКУМЕНТАЦИЯ

Выберите версию, форк и язык для СУБД Digital Q.DataBase, чтобы прочитать или скачать всю документацию.

Новости

01.09.2026

СУБД Digital Q.DataBase можно развернуть из готового Docker-образа

25.08.2026

СУБД Digital Q.DataBase: 8 ядер бесплатно — до 1 сентября!

Документация

Диасофт
Авторские права © 2016–2025 ООО "Диасофт Экосистема"

Скачать всю документацию:

pdf (13 mБ) EPUB (13 mБ) CHM (14 МБ)

6.2.5. dropdb

Содержание

6.2.5. dropdb

dropdb — удаление Digital Q.DataBase база данных

Синтаксис

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

Описание

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

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.

Эта утилита, как и большинство других Digital Q.DataBase утилит, также использует переменные окружения, поддерживаемые libpq (см. Раздел 4.1.15).

Диагностика

В случае возникновения трудностей см. 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;

См. также

createdb, DROP DATABASE

Наверх