dropuser
dropuser — удалить учётную запись пользователя Postgres Pro
Синтаксис
dropuser
[параметр-подключения
...] [параметр
...] [имя_пользователя
]
Описание
dropuser удаляет ранее созданного пользователя PostgreSQL. Суперпользователи могут удалить любую роль. Удалять роли не суперпользователей могут пользователи с привилегией CREATEROLE
, получившие право ADMIN OPTION
для целевой роли.
dropuser это обёртка для SQL-команды DROP ROLE
. Удаление пользователей с её помощью по сути не отличается от выполнения того же действия при обращении к серверу другими способами.
Параметры
dropuser принимает в качестве аргументов:
имя_пользователя
Указывает имя удаляемой роли Postgres Pro. Если передан флаг
-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
(никогда).
Эта утилита, как и большинство других утилит Postgres Pro, также использует переменные среды, поддерживаемые libpq (см. Раздел 32.15).
Диагностика
В случае возникновения трудностей, обратитесь к DROP ROLE и psql. При диагностике следует учесть, что при запуске утилиты также применяются переменные окружения и параметры подключения по умолчанию libpq.
Примеры
Чтобы удалить роль joe
на сервере, используемом по умолчанию:
$
dropuser joe
Чтобы удалить роль joe
на сервере eden
, слушающем подключения на порту 5000, в интерактивном режиме и с выводом выполняемых команд:
$
dropuser -p 5000 -h eden -i -e joe
Роль "joe" будет удалена навсегда. Продолжить? (y/n)
y
DROP ROLE joe;