# DROP USER MAPPING
#### 功能描述
删除用户到外部服务器的用户映射。
#### 语法格式
```
DROP USER MAPPING [ IF EXISTS ] FOR { user_name | USER | CURRENT_USER | PUBLIC } SERVER server_name;
```
![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/figure/zh-cn_image_0000002764301096.png)
#### 参数描述
- **IF EXISTS**
  判断指定的用户映射是否存在。
  - 如果指定的用户映射存在，则删除成功。
  
  - 如果指定的用户映射不存在，不会进行删除操作，仅产生一个NOTICE提示，用于告知指定的用户映射不存在。
  
  
  ![](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  与很多语句不同，对于IF EXISTS参数只用于DROP USER MAPPING语句，在CREATE USER MAPPING语句中使用时会报语法错误。
  
- **user_name**
  该映射的用户名。
  - CURRENT_USER \| USER：匹配当前用户的名称。
  
  - PUBLIC：被用于匹配系统中所有现存和未来的用户名。
    
- **server_name**
  用户映射的服务器名。
  
 
#### 示例
```
--创建角色。
gaussdb=# CREATE ROLE bob PASSWORD '********';
--创建外部服务器。
gaussdb=# CREATE SERVER my_server FOREIGN DATA WRAPPER log_fdw;
--创建USER MAPPING。
gaussdb=# CREATE USER MAPPING FOR bob SERVER my_server OPTIONS (USER 'bob', PASSWORD '********');
--修改USER MAPPING。
gaussdb=# ALTER USER MAPPING FOR bob SERVER my_server OPTIONS (SET PASSWORD '********');
--删除USER MAPPING。
gaussdb=# DROP USER MAPPING FOR bob SERVER my_server;
--删除外部服务器。
gaussdb=# DROP SERVER my_server;
--删除角色。
gaussdb=# DROP ROLE bob;
```
#### 相关链接
[ALTER USER MAPPING](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0223.html)，[CREATE USER MAPPING](https://support.huaweicloud.com/centralized-ref-v10-gaussdb/gaussdb-38-0290.html)
