2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2

SET SESSION AUTHORIZATION

SET SESSION AUTHORIZATION — 设置会话用户标识符和当前会话的当前用户标识符

概要

SET [ SESSION | LOCAL ] SESSION AUTHORIZATION user_name
SET [ SESSION | LOCAL ] SESSION AUTHORIZATION DEFAULT
RESET SESSION AUTHORIZATION

描述

此命令将当前 SQL 会话的会话用户标识符和当前用户标识符设置为 user_name。用户名称可以写成标识符或字符串字面量。使用此命令,例如,可以暂时切换到一个特权较低的用户,然后再切换回超级用户。

会话用户标识符最初设置为客户端提供的(可能是已验证的)用户名。当前用户标识符通常等于会话用户标识符,但在 SECURITY DEFINER 函数和类似机制的上下文中可能会暂时更改;它也可以通过 SET ROLE 更改。当前用户标识符与权限检查相关。

只有当初始会话用户(已验证用户)具有超级用户权限时,才能更改会话用户标识符。否则,只有在指定已验证的用户名时,命令才会被接受。

与常规 SET 命令一样,SESSIONLOCAL 修饰符的作用相同。

DEFAULTRESET 形式将会话和当前用户标识符重置为最初已验证的用户名。任何用户都可以执行这些形式。

注释

SET SESSION AUTHORIZATION 不能在 SECURITY DEFINER 函数中使用。

示例

SELECT SESSION_USER, CURRENT_USER;

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

SET SESSION AUTHORIZATION 'paul';

SELECT SESSION_USER, CURRENT_USER;

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

兼容性

SQL 标准允许在 user_name 字面量位置出现其他一些表达式,但这些选项在实践中并不重要。PostgreSQL 允许标识符语法("username"),而 SQL 不允许。SQL 不允许在事务期间使用此命令;PostgreSQL 不做此限制,因为没有理由这样做。SESSIONLOCAL 修饰符是 PostgreSQL 的扩展,RESET 语法也是。

执行此命令所需的确切权限由标准定义为实现定义的。

另请参阅

SET ROLE

提交更正

如果您在文档中看到任何不正确、不符合您对特定功能的体验或需要进一步澄清的内容,请使用 此表单 报告文档问题。