2008-12-19 17:25:19 +01:00
<!--
2010-09-20 22:08:53 +02:00
doc/src/sgml/ref/drop_user_mapping.sgml
2008-12-19 17:25:19 +01:00
PostgreSQL documentation
-->
<refentry id="SQL-DROPUSERMAPPING">
2014-02-24 03:25:35 +01:00
<indexterm zone="sql-dropusermapping">
<primary>DROP USER MAPPING</primary>
</indexterm>
2008-12-19 17:25:19 +01:00
<refmeta>
2010-04-03 09:23:02 +02:00
<refentrytitle>DROP USER MAPPING</refentrytitle>
2009-06-19 17:28:25 +02:00
<manvolnum>7</manvolnum>
2008-12-19 17:25:19 +01:00
<refmiscinfo>SQL - Language Statements</refmiscinfo>
</refmeta>
<refnamediv>
<refname>DROP USER MAPPING</refname>
<refpurpose>remove a user mapping for a foreign server</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
2009-09-19 12:23:27 +02:00
DROP USER MAPPING [ IF EXISTS ] FOR { <replaceable class="parameter">user_name</replaceable> | USER | CURRENT_USER | PUBLIC } SERVER <replaceable class="parameter">server_name</replaceable>
2008-12-19 17:25:19 +01:00
</synopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>
<command>DROP USER MAPPING</command> removes an existing user
2009-01-20 10:10:20 +01:00
mapping from foreign server.
</para>
<para>
The owner of a foreign server can drop user mappings for that server
for any user. Also, a user can drop a user mapping for his own
user name if <literal>USAGE</> privilege on the server has been
granted to the user.
2008-12-19 17:25:19 +01:00
</para>
</refsect1>
<refsect1>
<title>Parameters</title>
<variablelist>
<varlistentry>
<term><literal>IF EXISTS</literal></term>
<listitem>
<para>
Do not throw an error if the user mapping does not exist. A
notice is issued in this case.
</para>
</listitem>
</varlistentry>
<varlistentry>
2009-09-19 12:23:27 +02:00
<term><replaceable class="parameter">user_name</replaceable></term>
2008-12-19 17:25:19 +01:00
<listitem>
<para>
User name of the mapping. <literal>CURRENT_USER</>
and <literal>USER</> match the name of the current
user. <literal>PUBLIC</> is used to match all present and
future user names in the system.
</para>
</listitem>
</varlistentry>
<varlistentry>
2009-09-19 12:23:27 +02:00
<term><replaceable class="parameter">server_name</replaceable></term>
2008-12-19 17:25:19 +01:00
<listitem>
<para>
Server name of the user mapping.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>Examples</title>
<para>
Drop a user mapping <literal>bob</>, server <literal>foo</> if it exists:
<programlisting>
DROP USER MAPPING IF EXISTS FOR bob SERVER foo;
2011-08-07 09:49:45 +02:00
</programlisting></para>
2008-12-19 17:25:19 +01:00
</refsect1>
<refsect1>
<title>Compatibility</title>
<para>
<command>DROP USER MAPPING</command> conforms to ISO/IEC 9075-9
(SQL/MED). The <literal>IF EXISTS</> clause is
a <productname>PostgreSQL</> extension.
</para>
</refsect1>
<refsect1>
<title>See Also</title>
<simplelist type="inline">
2010-04-03 09:23:02 +02:00
<member><xref linkend="sql-createusermapping"></member>
<member><xref linkend="sql-alterusermapping"></member>
2008-12-19 17:25:19 +01:00
</simplelist>
</refsect1>
</refentry>