# ALTER USER MAPPING
#### 功能描述
ALTER USER MAPPING语句用于更改一个用户到一个外部服务器的映射定义，外部服务器的所有者可以为任何用户更改该服务器的用户映射。此外，如果服务器上的USAGE权限已授权用户，则用户可以更改其自己的用户名的用户映射。
#### 注意事项
- 当在OPTIONS中出现password选项时，需要保证GaussDB每个节点的$GAUSSHOME/bin目录下存在usermapping.key.cipher和usermapping.key.rand文件，如果不存在这两个文件，请使用gs\\_guc工具生成并使用gs\\_ssh工具发布到每个节点的$GAUSSHOME/bin目录下。具体操作请参考[OPTIONS]中的说明。
- 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。选项名称必须为唯一，该服务器的外部数据包装器也会验证选项。
  ![](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  - 用户的密码会加密后保存到系统表[PG_USER_MAPPING](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0906.html#ZH-CN_TOPIC_0000002200579798)中，加密时需要使用usermapping.key.cipher和usermapping.key.rand作为加密密码文件和加密因子。首次使用前需要通过如下命令创建这两个文件，并将这两个文件放入各节点的$GAUSSHOME/bin目录，且确保具有读权限。gs_ssh工具可以协助您快速将文件放入各节点对应目录下。
    ```
    gs_ssh -c "gs_guc generate -o usermapping -S default -D $GAUSSHOME/bin"
    ```
    
  
  - 其中-S参数指定default时会随机生成密码，用户也可为-S参数指定密码，此密码用于保证生成密码文件的安全性和唯一性，用户无需保存或记忆。其他参数详见工具参考中gs_guc工具说明。
    
 
#### 示例
请参考CREATE USER MAPPING的[8.15.104-示例](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0567.html#ZH-CN_TOPIC_0000002235339521__zh-cn_topic_0000002200142036_section7741915300)。
#### 相关链接
[CREATE USER MAPPING](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0567.html#ZH-CN_TOPIC_0000002235339521)，[DROP USER MAPPING](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0616.html#ZH-CN_TOPIC_0000002200579198)