ALTER USER

描述

该语句主要用于执行以下操作：

• 修改数据库用户的密码。

• 修改数据库用户使用的 Profile。

• 修改数据库用户连接的加密方式，其它修改用户密码方式，请参见 SET PASSWORD。

• 修改数据库用户拥有角色的默认角色。

权限要求

除了当前用户可以执行的修改命令外，其他用户必须拥有 ALTER USER 权限，才可以执行本命令修改其他用户的信息。有关 OceanBase 数据库权限的详细介绍，请参见 Oracle 模式下的权限分类。

使用限制

使用代理用户代理目标用户连接数据库时，当前仅支持通过 OBClient 连接数据库，并且要求 OBClient 版本为 V2.2.6 及之后版本。暂不支持 Java 驱动和 C 驱动连接数据库。

语法

ALTER USER user_name
    { IDENTIFIED BY password
    | PROFILE {"profile_name" | DEFAULT}
    | REQUIRE {NONE | SSL | x509 | tls_option_list}
    | DEFAULT ROLE
            { role_name[,role_name...]
            | ALL [EXCEPT role_name[,role_name...]]
            | NONE
            }
    | GRANT CONNECT THROUGH proxy_user_name [with_clause]
    };

tls_option_list:
    tls_option
    | tls_option_list tls_option

tls_option:
    CIPHER str_value
    | ISSUER str_value
    | SUBJECT str_value

with_clause:
    WITH ROLE {role_name[, role_name,...]}
    | WITH NO ROLE
    | WITH ROLE ALL EXCEPT {role_name[, role_name,...]}

参数解释

with_clause

• WITH ROLE {role_name[, role_name,...]}：指定代理用户代理目标用户连接数据库时，自动获取并激活指定的角色权限，即仅生效目标用户中指定的角色权限。
• WITH NO ROLE：指定代理用户代理目标用户连接数据库时，不会自动获取目标用户的任何角色权限，即目标用户的所有角色权限均不生效。
• WITH ROLE ALL EXCEPT {role_name[ ,role_name,...]}：指定代理用户代理目标用户连接数据库时，自动获取并激活目标用户中除指定角色之外的其他所有角色权限。

示例

• 修改用户 user1 的密码。

  obclient> ALTER USER user1 IDENTIFIED BY ******;
  Query OK, 0 rows affected
  

• 修改用户 user1 连接加密协议为 SSL。

  obclient> ALTER USER user1 REQUIRE SSL;
  Query OK, 0 rows affected
  

• 修改用户 user1 使用的的 Profile 为 profile1。

  obclient> ALTER USER user1 PROFILE "profile1";
  Query OK, 0 rows affected
  

• 设置用户 user1 的默认角色。

  obclient> CREATE ROLE role1;
  Query OK, 0 rows affected
  
  obclient> CREATE ROLE role2 IDENTIFIED BY ******;
  Query OK, 0 rows affected
  
  obclient> CREATE ROLE role3 IDENTIFIED BY ******;
  Query OK, 0 rows affected
  
  obclient> GRANT role1,role2,role3 TO user1;
  Query OK, 0 rows affected
  
  obclient> ALTER USER user1 DEFAULT ROLE role1;
  Query OK, 0 rows affected
  

  说明

  用户 user1 可以直接使用 role1 的权限。role2 和 role3 的权限需要用户 user1 在会话中启用 role2 和 role3 后，用户 user1 才能使用其权限。

  有关启用角色命令的详细信息，请参见 SET ROLE。