描述

这个命令把当前 SQL 会话的当前用户标识符设置为 role_name。 角色名可以写成一个标识符或者一个字符串。在 SET ROLE之后，对 SQL 命令的权限检查时就 好像该角色就是原先登录的角色一样。

当前会话用户必须具有指定的SET选项，针对 role_name，可以是直接 拥有，也可以通过带有SET选项的成员关系链间接 拥有。 （如果会话用户是超级用户，则可以选择任何角色。）

SESSION和LOCAL修饰符发挥的作用和常规的SET命令一样。

SET ROLE NONE设置当前用户标识符为当前会话用户标识符，由session_user返回。 RESET ROLE设置当前用户标识符为由command-line options、ALTER ROLE, 或ALTER DATABASE指定的连接时间设定，如果存在这样的设置的话。 否则，RESET ROLE设置当前用户标识符到当前会话用户标识符。 这些形式可以由任何用户执行。

注解

使用此命令，可以添加权限或限制自己的权限。如果会话用户角色被授予 WITH INHERIT TRUE，它会自动拥有每个此类角色的所有权限。 在这种情况下，SET ROLE实际上会删除除目标角色直接 拥有或继承的权限之外的所有权限。另一方面，如果会话用户角色被授予 WITH INHERIT FALSE，则默认情况下无法访问被授予角色的 权限。然而，如果角色被授予WITH SET TRUE，会话用户 可以使用SET ROLE来放弃直接分配给会话用户的权限， 而是获取指定角色可用的权限。如果角色被授予WITH INHERIT FALSE, SET FALSE，那么无论是否使用SET ROLE， 都无法行使该角色的权限。

请注意，当超级用户选择SET ROLE为非超级用户角色时， 他们将失去超级用户权限。

SET ROLE的效果堪比 SET SESSION AUTHORIZATION，但是涉及的特权检查 完全不同。还有，SET SESSION AUTHORIZATION决定 后来的SET ROLE命令可以使用哪些角色， 不过用 SET ROLE更改角色并不会改变后续 SET ROLE能够使用的角色集。

SET ROLE不会处理角色的ALTER ROLE设置指定的会话变量。 这只在登录期间发生。

SET ROLE不能在一个 SECURITY DEFINER函数中使用。

示例

SELECT SESSION_USER, CURRENT_USER;

 session_user | current_user
--------------+--------------
 peter        | peter

SET ROLE 'paul';

SELECT SESSION_USER, CURRENT_USER;

 session_user | current_user
--------------+--------------
 peter        | paul

兼容性

PostgreSQL允许标识符 语法（"rolename"），而 SQL 标准要求 角色名被写成字符串。SQL 不允许在事务中使用这个命令，而 PostgreSQL并不做此限 制，因为并没有原因需要这样做。和RESET语法 一样，SESSION和 LOCAL修饰符是一种 PostgreSQL扩展。

另见