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 e4102cdd17c56119be0d4b12cc0e92989bf9996f..ca4aa51df665ba963bb937cde874f00def97ccbd 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -15306,6 +15306,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
@@ -15429,8 +15435,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
@@ -15450,6 +15459,10 @@ SELECT * FROM pg_ls_dir('.') WITH ORDINALITY AS t(ls,n);
     current_query
    
 
+   
+    current_role
+   
+
    
     current_schema
    
@@ -15501,6 +15514,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.)