File: sql-alteruser.html

package info (click to toggle)
mpsql 2.1-2
links: PTS
area: non-free
in suites: potato
size: 3,528 kB
ctags: 4,886
sloc: ansic: 35,184; makefile: 3,761; sh: 44
file content (396 lines) | stat: -rw-r--r-- 5,757 bytes
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML
><HEAD
><TITLE
>     ALTER USER
    </TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet version 1.19"><LINK
REL="HOME"
TITLE="PostgreSQL User's Guide"
HREF="user.html"><LINK
REL="UP"
TITLE="SQL Commands"
HREF="sql-commands.html"><LINK
REL="PREVIOUS"
TITLE="ALTER TABLE"
HREF="sql-altertable.html"><LINK
REL="NEXT"
TITLE="   BEGIN WORK
  "
HREF="sql-beginwork.html"></HEAD
><BODY
BGCOLOR="#FFFFFF"
TEXT="#000000"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PostgreSQL User's Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="sql-altertable.html"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="sql-beginwork.html"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
>ALTER USER</H1
><DIV
CLASS="REFNAMEDIV"
><H2
>Name</H2
>     ALTER USER
     &#8212;      Modifies user account information
    </DIV
><DIV
CLASS="REFSYNOPSISDIV"
><PRE
CLASS="SYNOPSIS"
>ALTER USER <TT
CLASS="REPLACEABLE"
><I
>username</I
></TT
>
    [ WITH PASSWORD <TT
CLASS="REPLACEABLE"
><I
>password</I
></TT
> ]
    [ CREATEDB | NOCREATEDB ]
    [ CREATEUSER | NOCREATEUSER ]
    [ IN GROUP <TT
CLASS="REPLACEABLE"
><I
>groupname</I
></TT
> [, ...] ]
    [ VALID UNTIL '<TT
CLASS="REPLACEABLE"
><I
>abstime</I
></TT
>' ]
    </PRE
><DIV
CLASS="REFSECT2"
><H3
>      Inputs
     </H3
><P
>      Refer to <B
CLASS="COMMAND"
>CREATE USER</B
> for a detailed description of each
      clause.
     </P
><P
></P
><DL
><DT
><TT
CLASS="REPLACEABLE"
><I
> username </I
></TT
></DT
><DD
><P
>	  The Postgres account name of the user whose details are to be altered.
	 </P
></DD
><DT
><TT
CLASS="REPLACEABLE"
><I
> password </I
></TT
></DT
><DD
><P
>	  The new password to be used for this account.
	 </P
></DD
><DT
><TT
CLASS="REPLACEABLE"
><I
> groupname </I
></TT
></DT
><DD
><P
>	  The name of an access group into which this account is to be put.
	 </P
></DD
><DT
><TT
CLASS="REPLACEABLE"
><I
> abstime </I
></TT
></DT
><DD
><P
>	  The date (and, optionally, the time)
 at which this user's access is to be terminated.
	 </P
></DD
></DL
></DIV
><DIV
CLASS="REFSECT2"
><H3
>      Outputs
     </H3
><P
>	 <P
></P
></P><DL
><DT
><SPAN
CLASS="RETURNVALUE"
>ALTER USER</SPAN
></DT
><DD
><P
>	     Message returned if the alteration was successful.
	    </P
></DD
><DT
><SPAN
CLASS="RETURNVALUE"
>ERROR: alterUser: user "username" does not exist</SPAN
></DT
><DD
><P
>	     Error message returned if the user specified doesn't
	     exist.

     </P
></DD
></DL
><P>
    </P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><H2
>     Description
    </H2
><P
>     <B
CLASS="COMMAND"
>ALTER USER</B
> is used to change the attributes of a user's
     <SPAN
CLASS="PRODUCTNAME"
>Postgres</SPAN
> account.
 Please note that it is not possible
     to alter a user's "usesysid" via the alter user
     statement. Also, it is only possible for the
 <SPAN
CLASS="PRODUCTNAME"
>Postgres</SPAN
>
     user or any user with read and modify permissions on
     "pg_shadow" to alter user passwords.
    </P
><P
>     If any of the clauses of the alter user statement are
     omitted, the corresponding value in the "pg_shadow" table
     is left unchanged.
    </P
><DIV
CLASS="REFSECT2"
><H3
>      Notes
     </H3
><P
>      <B
CLASS="COMMAND"
>ALTER USER</B
> statement
 is a <SPAN
CLASS="PRODUCTNAME"
>Postgres</SPAN
>
 language extension.
     </P
><P
>      Refer to <B
CLASS="COMMAND"
>CREATE/DROP USER</B
>
  to create or remove a user
      account.
     </P
><P
>      In the current release (v6.4), the IN GROUP clause is parsed
      but has no affect.  When it is fully implemented, it is
      intended to modify the pg_group relation.
     </P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><H2
>     Usage
    </H2
><P
>     Change a user password
    </P
><PRE
CLASS="PROGRAMLISTING"
>ALTER USER davide WITH PASSWORD hu8jmn3;
    </PRE
><P
>     Change a user's valid until date
    </P
><PRE
CLASS="PROGRAMLISTING"
>ALTER USER manuel VALID UNTIL 'Jan 31 2030';
    </PRE
><P
>     Change a user's valid until date, specifying that his
authorisation should expire at midday on 4th May 1998 using
the time zone which is one hour ahead of UTC
    </P
><PRE
CLASS="PROGRAMLISTING"
>ALTER USER chris VALID UNTIL 'May 4 12:00:00 1998 +1';
    </PRE
><P
>     Give a user the ability to create other users and new databases.
    </P
><PRE
CLASS="PROGRAMLISTING"
>ALTER USER miriam CREATEUSER CREATEDB;
    </PRE
><P
>     Place a user in two groups
    </P
><PRE
CLASS="PROGRAMLISTING"
>ALTER USER miriam IN GROUP sales, payroll;
    </PRE
></DIV
><DIV
CLASS="REFSECT1"
><H2
>     Compatibility
    </H2
><P
>    </P
><DIV
CLASS="REFSECT2"
><H3
>      SQL92
     </H3
><P
>      There is no <B
CLASS="COMMAND"
>ALTER USER</B
> statement in
 <SPAN
CLASS="ACRONYM"
>SQL92</SPAN
>.
  The standard leaves
      the definition of users to the implementation.
     </P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="sql-altertable.html"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="user.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="sql-beginwork.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>ALTER TABLE</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="sql-commands.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>BEGIN WORK</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>