mirror of
https://github.com/postgres/postgres.git
synced 2025-07-09 22:41:56 +03:00
d392e9bdea
The documentation of CREATE/ALTER ROLE has been missing two things related to PASSWORD: - The password value provided needs to be quoted, some places of the documentation marked the field with quotes, but not others, which led to confusion. - PASSWORD NULL was not provided consistently, with ENCRYPTED being not compatible with it. Reported-by: Steven Winfield Author: Michael Paquier Reviewed-by: David G. Johnston Discussion: https://postgr.es/m/154282901979.1316.7418475422120496802@wrigleys.postgresql.org
79 lines
2.4 KiB
Plaintext
79 lines
2.4 KiB
Plaintext
<!--
|
|
doc/src/sgml/ref/create_user.sgml
|
|
PostgreSQL documentation
|
|
-->
|
|
|
|
<refentry id="sql-createuser">
|
|
<indexterm zone="sql-createuser">
|
|
<primary>CREATE USER</primary>
|
|
</indexterm>
|
|
|
|
<refmeta>
|
|
<refentrytitle>CREATE USER</refentrytitle>
|
|
<manvolnum>7</manvolnum>
|
|
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>CREATE USER</refname>
|
|
<refpurpose>define a new database role</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<synopsis>
|
|
CREATE USER <replaceable class="parameter">name</replaceable> [ [ WITH ] <replaceable class="parameter">option</replaceable> [ ... ] ]
|
|
|
|
<phrase>where <replaceable class="parameter">option</replaceable> can be:</phrase>
|
|
|
|
SUPERUSER | NOSUPERUSER
|
|
| CREATEDB | NOCREATEDB
|
|
| CREATEROLE | NOCREATEROLE
|
|
| INHERIT | NOINHERIT
|
|
| LOGIN | NOLOGIN
|
|
| REPLICATION | NOREPLICATION
|
|
| BYPASSRLS | NOBYPASSRLS
|
|
| CONNECTION LIMIT <replaceable class="parameter">connlimit</replaceable>
|
|
| [ ENCRYPTED ] PASSWORD '<replaceable class="parameter">password</replaceable>' | PASSWORD NULL
|
|
| VALID UNTIL '<replaceable class="parameter">timestamp</replaceable>'
|
|
| IN ROLE <replaceable class="parameter">role_name</replaceable> [, ...]
|
|
| IN GROUP <replaceable class="parameter">role_name</replaceable> [, ...]
|
|
| ROLE <replaceable class="parameter">role_name</replaceable> [, ...]
|
|
| ADMIN <replaceable class="parameter">role_name</replaceable> [, ...]
|
|
| USER <replaceable class="parameter">role_name</replaceable> [, ...]
|
|
| SYSID <replaceable class="parameter">uid</replaceable>
|
|
</synopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>Description</title>
|
|
|
|
<para>
|
|
<command>CREATE USER</command> is now an alias for
|
|
<xref linkend="sql-createrole"/>.
|
|
The only difference is that when the command is spelled
|
|
<command>CREATE USER</command>, <literal>LOGIN</literal> is assumed
|
|
by default, whereas <literal>NOLOGIN</literal> is assumed when
|
|
the command is spelled
|
|
<command>CREATE ROLE</command>.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Compatibility</title>
|
|
|
|
<para>
|
|
The <command>CREATE USER</command> statement is a
|
|
<productname>PostgreSQL</productname> extension. The SQL standard
|
|
leaves the definition of users to the implementation.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
|
|
<simplelist type="inline">
|
|
<member><xref linkend="sql-createrole"/></member>
|
|
</simplelist>
|
|
</refsect1>
|
|
</refentry>
|