# ALTER USER
#### 功能描述
修改数据库用户的属性。
#### 注意事项
ALTER USER中修改的会话参数只针对指定的用户，且在下一次会话中有效。
#### 语法格式
- 修改用户的权限等信息。
  ```
  ALTER USER user_name [ [ WITH ] option [ ... ] ];
  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 ALL;
  ```
  其中option子句为。
  ```
  { CREATEDB | NOCREATEDB }
      | { CREATEROLE | NOCREATEROLE }
      | { AUDITADMIN | NOAUDITADMIN }
      | { SYSADMIN | NOSYSADMIN }
      | {MONADMIN | NOMONADMIN}
      | {OPRADMIN | NOOPRADMIN}
      | {POLADMIN | NOPOLADMIN}
      | { USEFT | NOUSEFT }
      | {INHERIT | NOINHERIT}
      | { LOGIN | NOLOGIN }
      | {PERSISTENCE | NOPERSISTENCE}
      | CONNECTION LIMIT connlimit
      | VALID BEGIN 'timestamp'
      | VALID UNTIL 'timestamp'
      | USER GROUP 'groupuser'
      | NODE GROUP logic_cluster_name
      | ACCOUNT { LOCK | UNLOCK }
  ```
  
- 修改与用户关联的指定会话参数值。
  ```
  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 ALL;
  ```
  
 
#### 参数说明
- **user_name**
  现有用户名。
  取值范围：已存在的用户名，用户名要求详见[•user_name](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0080.html#ZH-CN_TOPIC_0000002527965422__zh-cn_topic_0000002557933339_zh-cn_topic_0000001783205569_zh-cn_topic_0283136891_zh-cn_topic_0237122125_zh-cn_topic_0059778166_l787859d7e0cd43babcd1c035703c3448)。
  
- **new_password**
  新密码。
  密码规则如下：
  - 不能与当前密码相同。
  
  - 密码默认不少于8个字符。
  
  - 不能与用户名及用户名倒序相同。
  
  - 至少包含大写字母（A-Z），小写字母（a-z），数字（0-9），非字母数字字符（限定为\~!@#$%\^\&\*()-_=+\\\|\[{}\];:,\<.\>/?）四类字符中的三类字符。
  
  - 应当使用单引号将用户密码括起来。
  
  
  取值范围：字符串。
  
- **old_password**
  旧密码。
  
- **ACCOUNT { LOCK \| UNLOCK }**
  - ACCOUNT LOCK：锁定账户，禁止登录数据库。
  
  - ACCOUNT UNLOCK：解锁账户，允许登录数据库。
   
- **PGUSER**
  当前版本不允许修改用户的PGUSER属性。
  
其他参数请参见[CREATE ROLE](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0074.html#ZH-CN_TOPIC_0000002558925203)和[ALTER ROLE](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0052.html#ZH-CN_TOPIC_0000002527805456)的参数说明。
#### 示例
请参考CREATE USER的[示例](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0080.html#ZH-CN_TOPIC_0000002527965422__zh-cn_topic_0000002557933339_zh-cn_topic_0000001783205569_zh-cn_topic_0283136891_zh-cn_topic_0237122125_zh-cn_topic_0059778166_sfbca773f5bcd4799b3ea668b3eb074fa)。
#### 相关链接
[CREATE ROLE](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0074.html#ZH-CN_TOPIC_0000002558925203)，[CREATE USER](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0080.html#ZH-CN_TOPIC_0000002527965422)，[DROP USER](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0096.html#ZH-CN_TOPIC_0000002558805301)