SQL Commands / Foreign Data
DROP USER MAPPING
Read the PG 18 manualremove a user mapping for a foreign server
Reading PG 18current·documented in 19 of 30 versions, 8.4 to 20
Syntax
DROP USER MAPPING [ IF EXISTS ] FOR { user_name | USER | CURRENT_ROLE | CURRENT_USER | PUBLIC } SERVER server_name
Syntax diagrams
Read left to right. Branches are choices, bypasses are optional, loops repeat. Select an underlined parameter to open its rule.
Description
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 MAPPINGRelated entries
Definition snapshot: b7bd9cda · English manual source