upstream/postgresql
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2026-04-15 22:10:45 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: Add note about "Client User" and "Superuser" fields in \conninfo output.

Browse source 
In the \conninfo psql command, the "Client User" column shows the user who
established the connection, while the "Superuser" column reflects whether
the current user in the current execution context is a superuser. This means
the users referred to in these columns can differ, for example, if the current
user was changed with the SET ROLE command.

This commit adds a note to the \conninfo documentation to clarify
this behavior and avoid potential confusion.

Author: Fujii Masao <masao.fujii@gmail.com>
Reviewed-by: Robert Treat <rob@xzilla.net>
Reviewed-by: David G. Johnston <david.g.johnston@gmail.com>
Discussion: https://postgr.es/m/685961b8-b6ce-40bb-b2d5-c2ff135d3388@oss.nttdata.com
This commit is contained in:
Fujii Masao 2025-06-14 10:39:26 +09:00
parent be37ac20fc
commit 0fe50417ec
1 changed files with 9 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
doc/src/sgml/ref/psql-ref.sgml
View file

@ -1103,6 +1103,15 @@ SELECT $1 \parse stmt1
Outputs information about the current database connection,
including TLS-related information if TLS is in use.
</para>
<para>
Note that the <structfield>Client User</structfield> field shows
the user at the time of connection, while the
<structfield>Superuser</structfield> field indicates whether
the current user (in the current execution context) has
superuser privileges. These users are usually the same, but they can
differ, for example, if the current user was changed with the
<command>SET ROLE</command> command.
</para>
</listitem>
</varlistentry>