# ALTER USER MAPPING
#### 功能描述
ALTER USER MAPPING语句用于更改一个用户到一个外部服务器的映射定义。
#### 注意事项
- 当在OPTIONS中出现password选项时，需要保证GaussDB每个节点的$GAUSSHOME/bin目录下存在usermapping.key.cipher和usermapping.key.rand文件，如果不存在这两个文件，请使用gs\\_guc工具生成并使用gs\\_ssh工具发布到每个节点的$GAUSSHOME/bin目录下。
- OPTIONS中的敏感字段（如password）在使用多层引号时，语义和不带引号的场景是不同的，因此不会被识别为敏感字段进行脱敏。
 
#### 语法格式
```
ALTER USER MAPPING FOR { user_name | USER | CURRENT_USER | PUBLIC }
    SERVER server_name
    OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] )
```
在OPTIONS选项里，ADD、SET和DROP指定要执行的操作，未指定时默认为ADD操作。option和value为对应操作的参数及参数值。
#### 参数说明
- **user_name**
  该映射的用户名。
  CURRENT_USER和USER匹配当前用户的名称。PUBLIC被用来匹配系统中所有当前以及未来的用户名。
  
- **server_name**
  该用户映射的服务器名。
  
- **OPTIONS**
  为该用户映射更改选项。新选项会覆盖任何之前指定的选项。ADD、 SET和DROP指定要被执行的动作。如果没有显式地指定操作，将假定为ADD。选项名称必须为唯一，该服务器的外部数据包装器也会验证选项。
  
 
#### 示例
请参考CREATE USER MAPPING的[示例](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0432.html#ZH-CN_TOPIC_0000002186016190__zh-cn_topic_0000002185454586_section7741915300)。
#### 相关链接
[CREATE USER MAPPING](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0432.html#ZH-CN_TOPIC_0000002186016190)，[DROP USER MAPPING](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0469.html#ZH-CN_TOPIC_0000002186175878)