pg_user_mapping — PostgreSQL system catalog

Summary

The catalog pg_user_mapping stores the mappings from local user to remote. Access to this catalog is restricted from normal users, use the view pg_user_mappings instead.

(Description quoted from the official PostgreSQL documentation.)

Columns

The pg_user_mapping system catalog exposes the following columns (names, types and descriptions are taken verbatim from the PostgreSQL documentation):

• oid oid
  Row identifier
• umuser oid references pg_authid.oid
  OID of the local role being mapped, or zero if the user mapping is public
• umserver oid references pg_foreign_server.oid
  The OID of the foreign server that contains this mapping
• umoptions text[]
  User mapping specific options, as “keyword=value” strings

Related catalogs

This object references the following other system catalogs:

• umuser → pg_authid
• umserver → pg_foreign_server

Version applicability

Present in PostgreSQL 17, 18, 19 (verified against each release’s documentation). This is a long-standing system object that also exists in earlier PostgreSQL releases.

Related & references

• PostgreSQL system catalog & view index
• Built-in function reference

Reference: PostgreSQL documentation — pg_user_mapping.