描述

ALTER ROLE更改 PostgreSQL角色的属性。

概要中列出的此命令的第一种形式可以更改CREATE ROLE中可指定的许多角色属性。（涵盖了所有可能的属性，但没有用于添加或移除成员资格的选项；请使用GRANT和REVOKE完成此操作。）命令中未提及的属性保留其以前的设置。数据库超级用户可以更改任何角色的任何这些设置。拥有CREATEROLE权限的角色可以更改除SUPERUSER、REPLICATION和BYPASSRLS之外的任何这些设置，但只能针对非超级用户且非复制角色。普通角色只能更改自己的密码。

第二种形式更改角色的名称。数据库超级用户可以重命名任何角色。拥有CREATEROLE权限的角色可以重命名非超级用户角色。当前会话用户不能被重命名。（如果需要这样做，请以其他用户连接。）由于MD5加密的密码使用角色名作为密码学盐，重命名角色会清除其密码（如果密码使用MD5加密）。

其余形式更改角色针对配置变量的会话默认值，可以针对所有数据库，也可以在指定 IN DATABASE子句时仅针对指定数据库中的会话。如果指定的是 ALL而不是角色名，就会更改所有角色的该项设置。将 ALL与IN DATABASE一起使用，实际上与命令 ALTER DATABASE ... SET ...的效果相同。

当该角色随后启动新会话时，指定值将成为会话默认值，覆盖postgresql.conf中的设置或从postgres命令行接收的设置。这只发生在登录时；执行SET ROLE或SET SESSION AUTHORIZATION不会导致设置新的配置值。为所有数据库设置的设置会被附加到角色的数据库特定设置覆盖。特定数据库或特定角色的设置会覆盖为所有角色设置的设置。

超级用户可以更改任何人的会话默认值。拥有CREATEROLE权限的角色可以更改非超级用户角色的默认值。普通角色只能为自己设置默认值。某些配置变量不能以这种方式设置，或者只能由超级用户执行命令来设置。只有超级用户可以更改所有数据库中所有角色的设置。

参数

注解

使用CREATE ROLE添加新角色，使用DROP ROLE移除角色。

ALTER ROLE不能更改角色的成员资格。请使用GRANT和REVOKE完成此操作。

用这个命令指定未加密密码时必须加以注意。密码将以明文形式传输到服务器， 并且也可能被记录在客户端命令历史或服务器日志中。psql 包含一个命令\password，可用于更改角色的密码而不暴露明文密码。

也可以把会话默认值绑定到特定数据库，而不是角色；详见 ALTER DATABASE。如果发生冲突，同时针对数据库和角色的设置 会覆盖角色特定设置，而角色特定设置又会覆盖数据库特定设置。

示例

更改角色的密码：

ALTER ROLE davide WITH PASSWORD 'hu8jmn3';

移除角色的密码：

ALTER ROLE davide WITH PASSWORD NULL;

更改密码的失效日期，并指定该密码应在比 UTC快 1 小时的时区中，于 2015 年 5 月 4 日中午失效：

ALTER ROLE chris VALID UNTIL 'May 4 12:00:00 2015 +1';

使密码永久有效：

ALTER ROLE fred VALID UNTIL 'infinity';

授予角色创建其他角色和新数据库的能力：

ALTER ROLE miriam CREATEROLE CREATEDB;

为角色指定 maintenance_work_mem参数的非默认设置：

ALTER ROLE worker_bee SET maintenance_work_mem = 100000;

为角色指定 client_min_messages参数的数据库特定的非默认设置：

ALTER ROLE fred IN DATABASE devel SET client_min_messages = DEBUG;

兼容性

ALTER ROLE语句是 PostgreSQL的扩展。

另见