DROP USER MAPPING
remove a user mapping for a foreign server
English manual coverage begins with PostgreSQL 6.4. Source history and runtime observations have their own recorded version boundaries.
Reading PG 18·Select a recorded version
- anchor
- SQL-DROPUSERMAPPING
- file
- sql-dropusermapping.html
- lang
- en
- name
- DROP USER MAPPING
- purpose
- remove a user mapping for a foreign server
- purpose zh
- 删除外部服务器的用户映射
- sections same as
- Unknown
- slug
- 18
- synopsis html
- DROP USER MAPPING [ IF EXISTS ] FOR { <em class="replaceable"><code>user_name</code></em> | USER | CURRENT_ROLE | CURRENT_USER | PUBLIC } SERVER <em class="replaceable"><code>server_name</code></em>
- synopsis text
- DROP USER MAPPING [ IF EXISTS ] FOR { user_name | USER | CURRENT_ROLE | CURRENT_USER | PUBLIC } SERVER server_name
Syntax
DROP USER MAPPING [ IF EXISTS ] FOR { user_name | USER | CURRENT_ROLE | CURRENT_USER | PUBLIC } SERVER server_nameSyntax diagrams
Read left to right. Branches are choices, bypasses are optional, loops repeat. Select an underlined parameter to open its rule.
Definition PG 18
DROP USER MAPPING [ IF EXISTS ] FOR { user_name | USER | CURRENT_ROLE | CURRENT_USER | PUBLIC } SERVER server_nameDescription
DROP USER MAPPING removes an existing user mapping from 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 USAGE privilege on the server has been granted to the user.
Parameters
IF EXISTSDo not throw an error if the user mapping does not exist. A notice is issued in this case.
user_nameUser name of the mapping.
CURRENT_ROLE,CURRENT_USER, andUSERmatch the name of the current user.PUBLICis used to match all present and future user names in the system.server_nameServer name of the user mapping.
Examples
Drop a user mapping bob, server foo if it exists:
DROP USER MAPPING IF EXISTS FOR bob SERVER foo;
Compatibility
DROP USER MAPPING conforms to ISO/IEC 9075-9 (SQL/MED). The IF EXISTS clause is a PostgreSQL extension.
See Also
CREATE USER MAPPING, ALTER USER MAPPINGCompare versions
Source references
Full definition and evidence JSON
Definition sources
center · PostgreSQL 18 · wiki-repair-20261023:e314410eb3ccd6810f41d6d51ed770d8a3c4d64541fb674a43057b98345157cd
Text language: en · wiki-repair-20261023:e314410eb3ccd6810f41d6d51ed770d8a3c4d64541fb674a43057b98345157cd