dropuser
Удаляет существующую роль.
Синтаксис
dropuser [<connection-option> ...] [-e] [-i] <role_name>
dropuser -? | --help
dropuser -V | --versionОписание
dropuser удаляет существующую роль в Greengage DB.
Только суперпользователи и роли с привилегией CREATEROLE могут удалять роли.
Чтобы удалить суперпользователя, необходимо самому быть суперпользователем.
dropuser является оберткой для SQL-команды DROP ROLE.
Параметры
- <role_name>
-
Имя удаляемой роли. Если имя не указано в командной строке и используется параметр
-i/--interactive, будет запрошено имя. - -e | --echo
-
Выводит команды, которые
dropuserформирует и отправляет на сервер. - -i | --interactive
-
Запрашивает подтверждение перед удалением роли; если имя роли не указано — запрашивает его.
- --if-exists
-
Не выдает ошибку, если роль не существует. В этом случае выдается уведомление.
- -V | --version
-
Выводит версию
dropuserи завершает работу. - -? | --help
-
Выводит справку по аргументам командной строки
dropuserи завершает работу.
Параметры подключения
- -h <host> | --host=<host>
-
Имя хоста, на котором запущен экземпляр мастера. Если параметр не указан, читается из переменной окружения
PGHOSTили используется значение по умолчаниюlocalhost. - -p <port> | --port=<port>
-
TCP-порт, на котором мастер принимает подключения. Если параметр не указан, читается из переменной окружения
PGPORTили используется значение по умолчанию5432. - -U <username> | --username=<username>
-
Имя роли для подключения. Если параметр не указан, читается из переменной окружения
PGUSERили используется имя пользователя операционной системы. - -w | --no-password
-
Не запрашивает пароль. Если сервер требует пароль и он недоступен другими способами (например, через файл .pgpass), попытка подключения завершится неудачей. Этот параметр удобен для пакетных заданий и скриптов, где невозможен интерактивный ввод пароля.
- -W | --password
-
Принудительно запрашивает пароль.
Примеры
-
Удалить роль
joe, используя параметры подключения по умолчанию:$ dropuser joe -
Удалить роль
joe, используя параметры подключения, с запросом подтверждения и выводом выполняемой команды:$ dropuser -p 5432 -h mdw -i -e joeЗапрос подтверждения:
Role "joe" will be permanently removed. Are you sure? (y/n) y
Результат:
SELECT pg_catalog.set_config('search_path', '', false) DROP ROLE joe;