dropuser - удалить учетную запись пользователя QHB
dropuser - удалить учетную запись пользователя QHB
Синтаксис
dropuser [connection-option...] [option...] [username]
Описание
dropuser удаляет существующего пользователя QHB. Только
суперпользователи и пользователи с привилегией CREATEROLE могут удалять
пользователей QHB. Чтобы удалить суперпользователя, вы должны
быть самим суперпользователем.
dropuser - это "обертка" над SQL командой DROP ROLE. Нет
разницы между удалением пользователей с помощью этой утилиты или же иным способом при обращении к серверу
Параметры
dropuser принимает следующие аргументы командной строки:
| Аргумент | Описание |
|---|---|
username | Указывает имя удаляемого пользователя QHB. Вам будет предложено ввести имя, если оно не указано в командной строке и используется параметр -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 потратит одну дополнительную попытку подключения для аутентификации. В некоторых случаях стоит ввести -W, чтобы не делать эту попытку |
Окружение
PGHOST
PGPORT
PGUSER
- Параметры подключения по умолчанию
PG_COLOR
- Указывает, использовать ли цвет в диагностических сообщениях. Возможные значения always, auto, never.
Эта утилита, как и большинство других утилит QHB, также использует переменные среды, поддерживаемые libpq.
Диагностика
В случае затруднений см. DROP ROLE и qsql для обсуждения потенциальных проблем и сообщений об ошибках. Сервер базы данных должен работать на целевом хосте. Кроме того, при запуске утилиты, будут применяться параметры подключения и переменные окружения, которые используются библиотекой 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;