select open change scope Open full search

PG.CENTER connects PostgreSQL documentation, reference, and ecosystem knowledge. Maintained by Pigsty.

Supported versions: Current (18) / 17 / 16 / 15 / 14
Development versions: 19 / devel
Unsupported versions: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4
Historical version. PostgreSQL 10 reached end of support in November 2022. See the current version for supported releases.

51.92. pg_user_mappings

The view pg_user_mappings provides access to information about user mappings. This is essentially a publicly readable view of pg_user_mapping that leaves out the options field if the user has no rights to use it.

Table 51.93. pg_user_mappings Columns

Name Type References Description
umid oid pg_user_mapping.oid OID of the user mapping
srvid oid pg_foreign_server.oid The OID of the foreign server that contains this mapping
srvname name pg_foreign_server.srvname Name of the foreign server
umuser oid pg_authid.oid OID of the local role being mapped, 0 if the user mapping is public
usename name   Name of the local user to be mapped
umoptions text[]   User mapping specific options, as keyword=value strings

To protect password information stored as a user mapping option, the umoptions column will read as null unless one of the following applies:

  • current user is the user being mapped, and owns the server or holds USAGE privilege on it

  • current user is the server owner and mapping is for PUBLIC

  • current user is a superuser

Report a documentation issue

Read the upstream documentation. For corrections, first check the current version.