文档首页/ 云数据库 GaussDB/ 参考（分布式_V2.0-10.x）/ SQL参考/ SQL语法/ A/ ALTER USER
更新时间：2026-10-21 GMT+08:00
查看PDF
分享

ALTER USER

功能描述

修改数据库用户的属性。包括数据库用户名称以及权限等。

注意事项

ALTER USER中修改的会话参数只针对指定的用户，且在下一次会话中有效。

语法格式

  • 修改用户的权限等信息。 
    1
    		 
    ALTER USER user_name [ [ WITH ] option [ ... ] ];

    其中option子句为：

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
    		 
    {
    { CREATEDB | NOCREATEDB }
    | { CREATEROLE | NOCREATEROLE }
    | { INHERIT | NOINHERIT }
    | { AUDITADMIN | NOAUDITADMIN }
    | { SYSADMIN | NOSYSADMIN }
    | { MONADMIN | NOMONADMIN }
    | { OPRADMIN | NOOPRADMIN }
    | { POLADMIN | NOPOLADMIN }
    | { USEFT | NOUSEFT }
    | { LOGIN | NOLOGIN }
    | { REPLICATION | NOREPLICATION }
    | { PERSISTENCE | NOPERSISTENCE }
    | CONNECTION LIMIT connlimit
    | [ ENCRYPTED | UNENCRYPTED ] PASSWORD { 'password' [EXPIRED] | DISABLE | EXPIRED }
    | [ ENCRYPTED | UNENCRYPTED ] IDENTIFIED BY { 'password' [ REPLACE 'old_password' | EXPIRED ] | DISABLE }
    | VALID BEGIN 'timestamp'
    | VALID UNTIL 'timestamp'
    | RESOURCE POOL 'respool'
    | USER GROUP 'groupuser'
    | PERM SPACE 'spacelimit'
    | TEMP SPACE 'tmpspacelimit'
    | SPILL SPACE 'spillspacelimit'
    | NODE GROUP logic_cluster_name
    | ACCOUNT { LOCK | UNLOCK }
    | PGUSER
    | PASSWORD EXPIRE INTERVAL 'time' DAY
}

  • 修改用户名。 
    1
2
    		 
    ALTER USER user_name 
    RENAME TO new_name;

  • 修改与用户关联的指定会话参数值。当前版本不支持设置用户级别参数。 
    ALTER USER user_name [ IN DATABASE database_name ]
    SET configuration_parameter {{ TO | = } { value | DEFAULT }|FROM CURRENT};

  • 重置与用户关联的指定会话参数值。当前版本不支持设置用户级别参数。 
    ALTER USER user_name 
    [ IN DATABASE database_name ] RESET {configuration_parameter|ALL};

参数说明

  • user_name

    现有用户名。

    取值范围：已存在的用户名，如果用户名中包含大写字母则需要使用双引号进行声明。

    当前不支持对重分布资源管控对象redisuser进行RENAME TO操作，也不支持将其他用户名进行RENAME TO redisuser操作。

  • new_password

    新密码。

    取值范围：字符串。

    密码规则如下：

    • 不能与当前密码相同。
    • 密码默认不少于8个字符。
    • 不能与用户名及用户名倒序相同。
    • 至少包含大写字母（A~Z）、小写字母（a~z）、数字（0~9）以及非字母数字字符（限定为~!@#$%^&*()-_=+\|[{}];:,<.>/?）四类字符中的三类字符。当密码中包含其他字符（不属于上述四种字符范围内）时语句执行报错。
    • 用户密码需要使用单引号或双引号进行声明。
  • old_password

    旧密码。

  • ACCOUNT { LOCK | UNLOCK }
    • ACCOUNT LOCK：锁定账户，禁止通过密码认证登录数据库。
    • ACCOUNT UNLOCK：解锁账户，允许登录数据库。
  • PGUSER

    当前版本不允许修改用户的PGUSER属性。

  • 其他参数请参见ALTER ROLE章节的参数说明以及ALTER ROLE章节的参数说明。

示例

--创建用户jim，登录密码为********。
gaussdb=# CREATE USER jim PASSWORD '********';

--创建数据库。
gaussdb=# CREATE DATABASE testdb1;

--修改用户jim的登录密码。
gaussdb=# ALTER USER jim IDENTIFIED BY '**********' REPLACE '********';

--锁定jim账户。
gaussdb=# ALTER USER jim ACCOUNT LOCK;

--解锁jim账户。
gaussdb=# ALTER USER jim ACCOUNT UNLOCK;

--修改用户名。
gaussdb=# ALTER USER jim RENAME TO lisa;

--删除用户。
gaussdb=# DROP USER lisa CASCADE;

相关链接

CREATE ROLE，CREATE USER，DROP USER

父主题： A

相关文档