docs/sql-stmts/drop-user-mapping.md

---
title: DROP USER MAPPING
---

# DROP USER MAPPING

Removes a user mapping for a foreign server.

## Synopsis

```sql
DROP USER MAPPING [ IF EXISTS ] { <user_name> | USER | CURRENT_USER | PUBLIC } 
    SERVER <server_name>
```

## Description

`DROP USER MAPPING` removes an existing user mapping from a foreign server.

The owner of a foreign server can drop user mappings for that server for any user. Also, a user can drop a user mapping for their own user name if they have been granted the `USAGE` privilege on the server.

## Parameters

**`IF EXISTS`**

Do not throw an error if the user mapping does not exist. Apache Cloudberry issues a notice in this case.

**`user_name`**

User name of the mapping. `CURRENT_USER` and `USER` match the name of the current user. `PUBLIC` is used to match all present and future user names in the system.

**`server_name`**

Server name of the user mapping.

## Examples

Drop the user mapping named `bob`, server `foo` if it exists:

```sql
DROP USER MAPPING IF EXISTS FOR bob SERVER foo;
```

## Compatibility

`DROP SERVER` conforms to ISO/IEC 9075-9 (SQL/MED). The `IF EXISTS` clause is a Apache Cloudberry extension.

## See also

[CREATE USER MAPPING](/docs/sql-stmts/create-user-mapping.md), [ALTER USER MAPPING](/docs/sql-stmts/alter-user-mapping.md)