ALTER GROUP

примечание

Эта страница переведена при помощи нейросети GigaChat.

ALTER GROUP — изменение имени роли или группы.

Синтаксис

ALTER GROUP role_specification ADD USER user_name [, ... ]
ALTER GROUP role_specification DROP USER user_name [, ... ]

where role_specification can be:

    role_name
  | CURRENT_ROLE
  | CURRENT_USER
  | SESSION_USER

ALTER GROUP group_name RENAME TO new_name

Описание

ALTER GROUP используется для изменения свойств групп пользователей, однако в настоящее время считается устаревшей. Она сохраняется в PostgreSQL лишь для поддержки старых сценариев, так как концепция групп и пользователей была заменена универсальной моделью ролей.

Два первых варианта этой команды позволяют добавить роли в группу или удалить их из нее. В данном контексте любая роль может выступать в роли как «пользователя», так и «группы». Эти действия фактически равнозначны предоставлению или отзыву членства в роли с именем группы. Поэтому рекомендуется использовать для этого команды GRANT и REVOKE. Обратите внимание, что в этой команде отсутствуют дополнительные параметры, подобные тем, что используются в GRANT и REVOKE, — например, возможность передачи или отзыва права.

Третий вариант команды позволяет изменить имя группы, и он полностью соответствует переименованию роли с помощью команды ALTER ROLE.

Параметры

group_name

Задает имя группы (роли), которая должна быть изменена.

user_name

Задает роли, подлежащие добавлению в группу или удалению из нее. Эти роли должны уже существовать — команда ALTER GROUP не создает и не удаляет пользователей.

new_name

Задает новое имя группы.

Примеры

Добавление пользователей в группу:

ALTER GROUP staff ADD USER karl, john;

Удаление пользователя из группы:

ALTER GROUP workers DROP USER beth;

Совместимость

В стандарте SQL нет команды ALTER GROUP.

Смотрите также

TRANSLATION, REVOKE, ALTER ROLE