dropuser

примечание

Эта страница переведена при помощи нейросети GigaChat.

dropuser — удаляет учетную запись пользователя PostgreSQL.

Синтаксис

dropuser [connection-option...] [option...] [username]

Описание

dropuser удаляет существующего пользователя PostgreSQL. Суперпользователи могут использовать эту команду для удаления любой роли, иначе можно удалять только обычные пользовательские роли, причем это может сделать лишь тот пользователь, который обладает привилегией CREATEROLE и которому предоставлено право ADMIN OPTION на целевую роль.

dropuser является оберткой для команды SQL DROP ROLE. По своей эффективности она не отличается от удаления роли другими способами, доступными в сервере PostgreSQL.

Параметры

Для утилиты dropuser существуют следующие параметры командной строки:

username

Задает имя пользователя PostgreSQL, которого необходимо удалить. Если оно не указано в командной строке и используется параметр -i/--interactive, его необходимо ввести интерактивно.

-e
--echo

Выводит на экран команды, которые dropuser отправляет на сервер.

-i
--interactive

Запрашивает подтверждение действия перед удалением, а также имя пользователя, если оно не указано в командной строке.

-V
--version

Выводит версию dropuser и завершается.

--if-exists

Не выдает ошибку, если пользователь не существует. В этом случае выдается уведомление.

-?
--help

Показывает справку о параметрах командной строки утилиты dropuser и завершается.

-h host
--host=host

Указывает хост компьютера, на котором запущен сервер. Если значение начинается с косой черты, оно определяет каталог Unix-сокета.

-p port
--port=port

Указывает TCP-порт или расширение файла локального Unix-сокета для подключения к серверу.

-U username
--username=username

Указывает имя пользователя для подключения (не имя пользователя, которое нужно удалить).

-w
--no-password

Отключает запрос на ввод пароля. Если сервер требует аутентификации по паролю и пароль недоступен другими способами, такими как файл .pgpass, попытка подключения завершится неудачей. Параметр полезен в пакетных заданиях и сценариях, где нет пользователя, который мог бы ввести пароль.

-W
--password

Запрашивает пароль перед подключением к основному серверу.

Параметр не является обязательным, поскольку dropuser автоматически запросит пароль, если сервер требует аутентификацию паролем. Однако утилита потратит попытку подключения, чтобы выяснить, что сервер хочет пароль. В некоторых случаях стоит ввести -W, чтобы избежать дополнительной попытки подключения.

Переменные окружения

Утилита поддерживает переменные окружения:

• PGHOST
• PGPORT
• PGUSER
• PG_COLOR

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

Утилита dropuser использует переменные окружения, поддерживаемые libpq.

Диагностика

В случае возникновения трудностей, обратитесь в разделы DROP ROLE и psql.

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

Примеры

Удаление пользователя joe из сервера баз данных по умолчанию:

$ dropuser joe

Удаление пользователя joe с использованием сервера на хосте eden, порт 5000, с проверкой и просмотром SQL команды:

$ dropuser -p 5000 -h eden -i -e joe
Role "joe" will be permanently removed.
Are you sure? (y/n) y
DROP ROLE joe;

Смотрите также

createuser, DROP ROLE