dropuser
dropuser — удалить учетную запись пользователя QHB
Синтаксис
dropuser [параметр-подключения...] [параметр...] [имя_пользователя]
Описание
Утилита dropuser удаляет существующего пользователя QHB. Только суперпользователи и пользователи с правом CREATEROLE могут удалять пользователей QHB. (Чтобы удалить суперпользователя, нужно самому быть суперпользователем.)
dropuser — это обертка для команды SQL DROP ROLE. Между удалением
пользователей с помощью этой утилиты и их удалением иными способами при обращении
к серверу по сути нет никакой разницы.
Параметры
Утилита dropuser принимает следующие аргументы командной строки:
имя_пользователя
Задает имя удаляемого пользователя QHB. Если в командной строке
ничего не указано и используется параметр -i/--interactive, имя будет
запрошено.
-e
--echo
Отобразить на экране команды, которые dropuser генерирует и отправляет на
сервер.
-i
--interactive
Запросить подтверждение перед фактическим удалением пользователя и запросить его
имя, если оно не было указано в командной строке.
-V
--version
Вывести версию dropuser и завершиться.
--if-exists
Не считать ошибкой, если пользователя не существует. В этом случае выдается
замечание.
-?
--help
Показать справку об аргументах командной строки dropuser и завершиться.
Кроме того, в качестве параметров подключения dropuser принимает следующие аргументы командной строки:
-h хост
--host=хост
Задает имя хост-компьютера, на котором работает сервер. Если значение начинается
со слэша, оно используется в качестве каталога для сокета домена Unix.
-p порт
--port=порт
Указывает TCP-порт или расширение файла локального сокета домена Unix, через
который сервер принимает подключения.
-U имя_пользователя
--username=имя_пользователя
Имя пользователя, под которым производится подключение (а не удаляемого
пользователя).
-w
--no-password
Никогда не запрашивать ввод пароля. Если серверу требуется аутентификация по
паролю, и пароль недоступен с помощью иных средств, таких как файл .pgpass,
попытка подключения завершится неудачно. Этот параметр может быть полезен в
пакетных заданиях и скриптах, где нет пользователя, чтобы ввести пароль.
-W
--password
Принудительно запрашивать пароль перед подключением к базе данных.
Это несущественный параметр, так как dropuser автоматически запросит
пароль, если сервер требует аутентификацию по паролю. Однако чтобы выяснить это,
dropuser потребуется дополнительная попытка подключения к серверу. В
некоторых случаях имеет смысл ввести -W, чтобы исключить эту лишнюю попытку.
Переменные среды
PGHOST
PGPORT
PGUSER
Параметры подключения по умолчанию
PG_COLOR
Указывает, использовать ли цвета в диагностических сообщениях. Возможные значения:
always (всегда), auto (автоматически) и never (никогда).
Кроме того, эта утилита, как и большинство других утилит QHB, использует переменные среды, поддерживаемые libpq (см. раздел Переменные среды).
Диагностика
В случае возникновения затруднений обратитесь к справочным страницам DROP ROLE
и psql, где рассматриваются потенциальные проблемы и сообщения об ошибках.
Сервер баз данных должен работать на целевом хосте. Кроме того, будут применяться
параметры подключения и переменные среды, которые по умолчанию используются
библиотекой libpq на стороне клиента.
Примеры
Удалить пользователя alex с сервера баз данных по умолчанию:
$ dropuser alex
Удалить пользователя alex на сервере eden, порт 5000, с запросом подтверждения и просмотром нижележащей команды:
$ dropuser -p 5000 -h eden -i -e alex
Role "alex" will be permanently removed.
Are you sure? (y/n) y
DROP ROLE alex;