1999-07-22 17:09:15 +02:00
<!--
2000-01-14 23:11:38 +01:00
$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_user.sgml,v 1.10 2000/01/14 22:11:32 petere Exp $
1999-07-22 17:09:15 +02:00
Postgres documentation
-->
1999-07-06 19:16:42 +02:00
<refentry id="SQL-DROPUSER">
<refmeta>
1999-07-22 17:09:15 +02:00
<refentrytitle id="SQL-DROPUSER-TITLE">
1998-09-07 17:53:12 +02:00
DROP USER
1999-07-06 19:16:42 +02:00
</refentrytitle>
<refmiscinfo>SQL - Language Statements</refmiscinfo>
</refmeta>
<refnamediv>
<refname>
1998-09-07 17:53:12 +02:00
DROP USER
1999-07-06 19:16:42 +02:00
</refname>
<refpurpose>
2000-01-14 23:11:38 +01:00
Removes a user
1999-07-06 19:16:42 +02:00
</refpurpose>
1998-12-29 03:24:47 +01:00
</refnamediv>
1999-07-06 19:16:42 +02:00
<refsynopsisdiv>
<refsynopsisdivinfo>
1999-07-22 17:09:15 +02:00
<date>1999-07-20</date>
1999-07-06 19:16:42 +02:00
</refsynopsisdivinfo>
<synopsis>
DROP USER <replaceable class="PARAMETER">name</replaceable>
</synopsis>
1998-09-07 17:53:12 +02:00
1999-07-06 19:16:42 +02:00
<refsect2 id="R2-SQL-DROPUSER-1">
<refsect2info>
<date>1998-09-22</date>
</refsect2info>
<title>
1998-09-07 17:53:12 +02:00
Inputs
1999-07-06 19:16:42 +02:00
</title>
<para>
<variablelist>
<varlistentry>
<term><replaceable class="PARAMETER">name</replaceable></term>
<listitem>
<para>
The name of an existing user.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect2>
1998-09-07 17:53:12 +02:00
1999-07-06 19:16:42 +02:00
<refsect2 id="R2-SQL-DROPUSER-2">
<refsect2info>
<date>1998-09-22</date>
</refsect2info>
<title>
1998-09-07 17:53:12 +02:00
Outputs
1999-07-06 19:16:42 +02:00
</title>
<para>
<variablelist>
<varlistentry>
2000-01-14 23:11:38 +01:00
<term><computeroutput>DROP USER</computeroutput></term>
1999-07-06 19:16:42 +02:00
<listitem>
<para>
The message returned if the user is successfully deleted.
</para>
</listitem>
</varlistentry>
2000-01-14 23:11:38 +01:00
1999-07-06 19:16:42 +02:00
<varlistentry>
<term><computeroutput>
2000-01-14 23:11:38 +01:00
ERROR: DROP USER: user "<replaceable class="parameter">name</replaceable>" does not exist
1999-07-06 19:16:42 +02:00
</computeroutput></term>
<listitem>
<para>
This message occurs if the username is not found.
</para>
</listitem>
</varlistentry>
2000-01-14 23:11:38 +01:00
<varlistentry>
<term><computeroutput>
DROP USER: user "<replaceable class="parameter">name</replaceable>" owns database "<replaceable class="parameter">name</replaceable>", cannot be removed
</computeroutput></term>
<listitem>
<para>
You must drop the database first or change its ownership.
</para>
</listitem>
</varlistentry>
1999-07-06 19:16:42 +02:00
</variablelist>
1998-12-29 03:24:47 +01:00
</para>
1999-07-06 19:16:42 +02:00
</refsect2>
</refsynopsisdiv>
<refsect1 id="R1-SQL-DROPUSER-1">
<refsect1info>
<date>1998-09-22</date>
</refsect1info>
<title>
1998-09-07 17:53:12 +02:00
Description
1999-07-06 19:16:42 +02:00
</title>
<para>
2000-01-14 23:11:38 +01:00
<command>DROP USER</command> removes the specified user from the database.
It does not remove tables, views, or other objects owned by the user. If the
user owns any database you get an error.
1999-07-06 19:16:42 +02:00
</para>
2000-01-14 23:11:38 +01:00
<para>
Use <xref linkend="SQL-CREATEUSER" endterm="SQL-CREATEUSER-title">
to add new users, and <xref linkend="SQL-ALTERUSER"
endterm="SQL-ALTERUSER-title"> to change a user's properties.
<productname>PostgreSQL</productname>
comes with a script <xref linkend="APP-DROPUSER"
endterm="APP-DROPUSER-title">
which has the same functionality as this command (in fact, it calls this command)
but can be run from the command shell.
</para>
1998-12-29 03:24:47 +01:00
</refsect1>
1999-07-06 19:16:42 +02:00
<refsect1 id="R1-SQL-DROPUSER-2">
<title>
1998-09-07 17:53:12 +02:00
Usage
1999-07-06 19:16:42 +02:00
</title>
<para>
1998-09-07 17:53:12 +02:00
To drop a user account:
2000-01-14 23:11:38 +01:00
<programlisting>
DROP USER jonathan;
</programlisting>
1999-07-06 19:16:42 +02:00
</para>
</refsect1>
1998-09-07 17:53:12 +02:00
1999-07-06 19:16:42 +02:00
<refsect1 id="R1-SQL-DROPUSER-3">
<title>
1998-09-07 17:53:12 +02:00
Compatibility
1999-07-06 19:16:42 +02:00
</title>
1998-09-07 17:53:12 +02:00
1999-07-06 19:16:42 +02:00
<refsect2 id="R2-SQL-DROPUSER-4">
<refsect2info>
<date>1998-09-22</date>
</refsect2info>
<title>
1998-09-07 17:53:12 +02:00
SQL92
1999-07-06 19:16:42 +02:00
</title>
<para>
1998-09-22 17:48:03 +02:00
There is no <command>DROP USER</command> in <acronym>SQL92</acronym>.
1999-07-06 19:16:42 +02:00
</para>
1998-09-07 17:53:12 +02:00
</refsect2>
</refsect1>
1999-07-06 19:16:42 +02:00
</refentry>
1998-09-07 17:53:12 +02:00
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
1999-07-06 19:16:42 +02:00
sgml-omittag:nil
1998-09-07 17:53:12 +02:00
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:
-->