ALTER USER

描述

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

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

• 锁定或者解锁用户，且被锁定的用户不允许登录数据库。

  说明

  除了修改当前用户的口令之外，必须拥有 CREATE USER 的权限，才可以执行本命令。

• 设置用户在登录时默认激活的角色。

• 修改用户的资源选项。

权限要求

执行 ALTER USER 语句需要当前用户具备 CREATE USER 管理权限。有关 OceanBase 数据库权限的详细介绍，请参见 MySQL 模式下的权限分类。

语法

• 修改用户密码：

  ALTER USER 'user_name'
  IDENTIFIED [WITH auth_plugin]  BY 'password' | IDENTIFIED [WITH auth_plugin] AS 'auth_string'
  

• 修改用户密码并保留当前密码（双密码场景，自 V4.4.2 BP1 起）：

  ALTER USER 'user_name' IDENTIFIED BY 'password' RETAIN CURRENT PASSWORD;
  

• 丢弃已保留的旧密码（自 V4.4.2 BP1 起）：

  ALTER USER 'user_name' DISCARD OLD PASSWORD;
  

• 锁定用户：

  ALTER USER 'user_name' [ACCOUNT LOCK | ACCOUNT UNLOCK];
  

• 设置用户在登录时默认激活的角色：

  ALTER USER user_name DEFAULT ROLE {NONE | ALL | role_name [, role_name ...]};
  

• 修改用户的资源选项：

  ALTER USER user_name WITH  resource_option [resource_option];
  
  resource_option:
      MAX_CONNECTIONS_PER_HOUR integer
      | MAX_USER_CONNECTIONS integer
  

参数解释

示例

• 执行以下命令将用户 sqluser01 的密码修改为 ******。

  obclient> ALTER USER 'sqluser01' IDENTIFIED BY '******';
  

• 将用户 sqluser01 的密码修改为 NewSecret，并保留改密前的旧密码（双密码）。

  obclient> ALTER USER 'sqluser01'@'%' IDENTIFIED BY 'NewSecret' RETAIN CURRENT PASSWORD;
  

• 在业务切换完成后丢弃旧密码。

  obclient> ALTER USER 'sqluser01'@'%' DISCARD OLD PASSWORD;
  

• 指定使用 mysql_native_password 身份验证插件。

  ALTER USER 'sqluser01'
  IDENTIFIED WITH mysql_native_password
             AS '******';
  

• 指定使用 caching_sha2_password 身份验证插件。

  ALTER USER 'sqluser02'
  IDENTIFIED WITH caching_sha2_password
             BY '******';
  

• 锁定用户 obsqluser01。

  obclient> ALTER USER 'obsqluser01' ACCOUNT LOCK;
  

• 解锁用户 obsqluser01。

  obclient> ALTER USER 'obsqluser01' ACCOUNT UNLOCK;
  

• 指定用户 user001 在登录时，默认激活用户被授予的 role001 和 role002 角色。

  ALTER USER user001 DEFAULT ROLE role001, role002;
  

相关文档

• 双密码管理
• 激活角色
• 查看角色
• CURRENT_ROLE