mirror of https://github.com/postgres/postgres
I'm still working on the has_role function and information_schema changes.REL8_1_STABLE
Tom Lane
20 years ago
parent
f5df006a04
commit
e5d6b91220
@ -0,0 +1,116 @@ |
||||
<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/set_role.sgml,v 1.1 2005/07/25 22:12:31 tgl Exp $ --> |
||||
<refentry id="SQL-SET-ROLE"> |
||||
<refmeta> |
||||
<refentrytitle id="sql-set-role-title">SET ROLE</refentrytitle> |
||||
<refmiscinfo>SQL - Language Statements</refmiscinfo> |
||||
</refmeta> |
||||
|
||||
<refnamediv> |
||||
<refname>SET ROLE</refname> |
||||
<refpurpose>set the current user identifier of the current session</refpurpose> |
||||
</refnamediv> |
||||
|
||||
<indexterm zone="sql-set-role"> |
||||
<primary>SET ROLE</primary> |
||||
</indexterm> |
||||
|
||||
<refsynopsisdiv> |
||||
<synopsis> |
||||
SET [ SESSION | LOCAL ] ROLE <replaceable class="parameter">rolename</replaceable> |
||||
SET [ SESSION | LOCAL ] ROLE NONE |
||||
RESET ROLE |
||||
</synopsis> |
||||
</refsynopsisdiv> |
||||
|
||||
<refsect1> |
||||
<title>Description</title> |
||||
|
||||
<para> |
||||
This command sets the current user |
||||
identifier of the current SQL-session context to be <replaceable |
||||
class="parameter">rolename</replaceable>. The role name may be |
||||
written as either an identifier or a string literal. Using this |
||||
command, it is possible to either add privileges or restrict one's |
||||
privileges. |
||||
</para> |
||||
|
||||
<para> |
||||
The specified <replaceable class="parameter">rolename</replaceable> |
||||
must be a role that the current session user is a member of. |
||||
(If the session user is a superuser, any role can be selected.) |
||||
</para> |
||||
|
||||
<para> |
||||
The <literal>SESSION</> and <literal>LOCAL</> modifiers act the same |
||||
as for the regular <xref linkend="SQL-SET" endterm="SQL-SET-title"> |
||||
command. |
||||
</para> |
||||
|
||||
<para> |
||||
The <literal>NONE</> and <literal>RESET</> forms reset the current |
||||
user identifier to be the current session user identifier. |
||||
These forms may be executed by any user. |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1> |
||||
<title>Examples</title> |
||||
|
||||
<programlisting> |
||||
SELECT SESSION_USER, CURRENT_USER; |
||||
|
||||
session_user | current_user |
||||
--------------+-------------- |
||||
peter | peter |
||||
|
||||
SET ROLE 'paul'; |
||||
|
||||
SELECT SESSION_USER, CURRENT_USER; |
||||
|
||||
session_user | current_user |
||||
--------------+-------------- |
||||
peter | paul |
||||
</programlisting> |
||||
</refsect1> |
||||
|
||||
<refsect1> |
||||
<title>Compatibility</title> |
||||
|
||||
<para> |
||||
<productname>PostgreSQL</productname> |
||||
allows identifier syntax (<literal>"rolename"</literal>), while |
||||
the SQL standard requires the role name to be written as a string |
||||
literal. SQL does not allow this command during a transaction; |
||||
<productname>PostgreSQL</productname> does not make this |
||||
restriction because there is no reason to. |
||||
The <literal>SESSION</> and <literal>LOCAL</> modifiers are a |
||||
<productname>PostgreSQL</productname> extension, as is the |
||||
<literal>RESET</> syntax. |
||||
</para> |
||||
</refsect1> |
||||
|
||||
<refsect1> |
||||
<title>See Also</title> |
||||
|
||||
<simplelist type="inline"> |
||||
<member><xref linkend="sql-set-session-authorization" endterm="sql-set-session-authorization-title"></member> |
||||
</simplelist> |
||||
</refsect1> |
||||
</refentry> |
||||
|
||||
<!-- Keep this comment at the end of the file |
||||
Local variables: |
||||
mode:sgml |
||||
sgml-omittag:nil |
||||
sgml-shorttag:t |
||||
sgml-minimize-attributes:nil |
||||
sgml-always-quote-attributes:t |
||||
sgml-indent-step:1 |
||||
sgml-indent-data:t |
||||
sgml-parent-document:nil |
||||
sgml-default-dtd-file:"../reference.ced" |
||||
sgml-exposed-tags:nil |
||||
sgml-local-catalogs:("/usr/lib/sgml/catalog") |
||||
sgml-local-ecat-files:nil |
||||
End: |
||||
--> |
||||
Loading…
Reference in new issue