database/postgres
database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-06-05 23:56:58 +03:00
Code

Document current_role.

Browse Source 
This system function has been there a very long time, but somehow escaped
being listed in func.sgml.

Fabien Coelho and Tom Lane

Discussion: https://postgr.es/m/alpine.DEB.2.20.1705061027580.3896@lancre
This commit is contained in:
Tom Lane 2017-05-06 14:19:47 -04:00
parent adfad4222d
commit a5faf1708e
1 changed files with 20 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
doc/src/sgml/func.sgml
View File

@ -14809,6 +14809,12 @@ SELECT * FROM pg_ls_dir('.') WITH ORDINALITY AS t(ls,n);
by the client (might contain more than one statement)</entry> by the client (might contain more than one statement)</entry>
</row> </row>
<row>
<entry><literal><function>current_role</function></literal></entry>
<entry><type>name</type></entry>
<entry>equivalent to <function>current_user</function></entry>
</row>
<row> <row>
<entry><literal><function>current_schema</function>[()]</literal></entry> <entry><literal><function>current_schema</function>[()]</literal></entry>
<entry><type>name</type></entry> <entry><type>name</type></entry>
@ -14920,8 +14926,11 @@ SELECT * FROM pg_ls_dir('.') WITH ORDINALITY AS t(ls,n);
<note> <note>
<para> <para>
<function>current_catalog</function>, <function>current_schema</function>, <function>current_catalog</function>,
<function>current_user</function>, <function>session_user</function>, <function>current_role</function>,
<function>current_schema</function>,
<function>current_user</function>,
<function>session_user</function>,
and <function>user</function> have special syntactic status and <function>user</function> have special syntactic status
in <acronym>SQL</acronym>: they must be called without trailing in <acronym>SQL</acronym>: they must be called without trailing
parentheses. (In PostgreSQL, parentheses can optionally be used with parentheses. (In PostgreSQL, parentheses can optionally be used with
@ -14941,6 +14950,10 @@ SELECT * FROM pg_ls_dir('.') WITH ORDINALITY AS t(ls,n);
<primary>current_query</primary> <primary>current_query</primary>
</indexterm> </indexterm>
<indexterm>
<primary>current_role</primary>
</indexterm>
<indexterm> <indexterm>
<primary>current_schema</primary> <primary>current_schema</primary>
</indexterm> </indexterm>
@ -14992,6 +15005,11 @@ SELECT * FROM pg_ls_dir('.') WITH ORDINALITY AS t(ls,n);
functions with the attribute <literal>SECURITY DEFINER</literal>. functions with the attribute <literal>SECURITY DEFINER</literal>.
In Unix parlance, the session user is the <quote>real user</quote> and In Unix parlance, the session user is the <quote>real user</quote> and
the current user is the <quote>effective user</quote>. the current user is the <quote>effective user</quote>.
<function>current_role</function> and <function>user</function> are
synonyms for <function>current_user</function>. (The SQL standard draws
a distinction between <function>current_role</function>
and <function>current_user</function>, but <productname>PostgreSQL</>
does not, since it unifies users and roles into a single kind of entity.)
</para> </para>
<para> <para>