Document current_role.

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

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index f06d0a92c038d0ea54cd79508881c66d1871d782..629865701fb9a463031186c7a6a9c9ae5ccb8cea 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -15735,6 +15735,12 @@ SELECT * FROM pg_ls_dir('.') WITH ORDINALITY AS t(ls,n);
        by the client (might contain more than one statement)
       
 
+      
+       current_role
+       name
+       equivalent to current_user
+      
+
       
        current_schema[()]
        name
@@ -15871,8 +15877,11 @@ SELECT * FROM pg_ls_dir('.') WITH ORDINALITY AS t(ls,n);
 
    
     
-     current_catalog, current_schema,
-     current_user, session_user,
+     current_catalog,
+     current_role,
+     current_schema,
+     current_user,
+     session_user,
      and user have special syntactic status
      in SQL: they must be called without trailing
      parentheses.  (In PostgreSQL, parentheses can optionally be used with
@@ -15892,6 +15901,10 @@ SELECT * FROM pg_ls_dir('.') WITH ORDINALITY AS t(ls,n);
     current_query
    
 
+   
+    current_role
+   
+
    
     current_schema
    
@@ -15943,6 +15956,11 @@ SELECT * FROM pg_ls_dir('.') WITH ORDINALITY AS t(ls,n);
     functions with the attribute SECURITY DEFINER.
     In Unix parlance, the session user is the real user and
     the current user is the effective user.
+    current_role and user are
+    synonyms for current_user.  (The SQL standard draws
+    a distinction between current_role
+    and current_user, but PostgreSQL
+    does not, since it unifies users and roles into a single kind of entity.)