dropuser#

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

dropuser

dropuser — удаление учетной записи пользователя Tantor BE

Синтаксис

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

Описание

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

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

Опции

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

username

Указывает имя пользователя Tantor BE, который должен быть удален. Если имя не указано в командной строке и используется опция -i/--interactive, будет предложено ввести имя.

-e
--echo

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

-i
--interactive

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

-V
--version

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

--if-exists

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

-?
--help

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

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

-h host
--host=host

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

-p port
--port=port

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

-U username
--username=username

Имя пользователя для подключения (не имя пользователя для удаления).

-w
--no-password

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

-W
--password

Принудительно требовать от dropuser ввод пароля перед подключением к базе данных.

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

Окружение

PGHOST
PGPORT
PGUSER

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

PG_COLOR

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

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

Диагностика

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

Примеры

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

$ dropuser joe

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

$ 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
Назад Наверх Далее
dropdb Начало ecpg