| <!-- |
| $PostgreSQL: pgsql/doc/src/sgml/ref/drop_foreign_data_wrapper.sgml,v 1.2 2009/06/19 15:28:25 petere Exp $ |
| PostgreSQL documentation |
| --> |
| |
| <refentry id="SQL-DROPFOREIGNDATAWRAPPER"> |
| <refmeta> |
| <refentrytitle id="sql-dropforeigndatawrapper-title">DROP FOREIGN DATA WRAPPER</refentrytitle> |
| <manvolnum>7</manvolnum> |
| <refmiscinfo>SQL - Language Statements</refmiscinfo> |
| </refmeta> |
| |
| <refnamediv> |
| <refname>DROP FOREIGN DATA WRAPPER</refname> |
| <refpurpose>remove a foreign-data wrapper</refpurpose> |
| </refnamediv> |
| |
| <indexterm zone="sql-dropforeigndatawrapper"> |
| <primary>DROP FOREIGN DATA WRAPPER</primary> |
| </indexterm> |
| |
| <refsynopsisdiv> |
| <synopsis> |
| DROP FOREIGN DATA WRAPPER [ IF EXISTS ] <replaceable class="parameter">name</replaceable> [ CASCADE | RESTRICT ] |
| </synopsis> |
| </refsynopsisdiv> |
| |
| <refsect1> |
| <title>Description</title> |
| |
| <para> |
| <command>DROP FOREIGN DATA WRAPPER</command> removes an existing |
| foreign-data wrapper. To execute this command, the current user |
| must be the owner of the foreign-data wrapper. |
| </para> |
| </refsect1> |
| |
| <refsect1> |
| <title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry> |
| <term><literal>IF EXISTS</literal></term> |
| <listitem> |
| <para> |
| Do not throw an error if the foreign-data wrapper does not |
| exist. A notice is issued in this case. |
| </para> |
| </listitem> |
| </varlistentry> |
| |
| <varlistentry> |
| <term><replaceable class="parameter">name</replaceable></term> |
| <listitem> |
| <para> |
| The name of an existing foreign-data wrapper. |
| </para> |
| </listitem> |
| </varlistentry> |
| |
| <varlistentry> |
| <term><literal>CASCADE</literal></term> |
| <listitem> |
| <para> |
| Automatically drop objects that depend on the foreign-data |
| wrapper (such as servers). |
| </para> |
| </listitem> |
| </varlistentry> |
| |
| <varlistentry> |
| <term><literal>RESTRICT</literal></term> |
| <listitem> |
| <para> |
| Refuse to drop the foreign-data wrappers if any objects depend |
| on it. This is the default. |
| </para> |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| </refsect1> |
| |
| <refsect1> |
| <title>Examples</title> |
| |
| <para> |
| Drop the foreign-data wrapper <literal>dbi</>: |
| <programlisting> |
| DROP FOREIGN DATA WRAPPER dbi; |
| </programlisting> |
| </para> |
| </refsect1> |
| |
| <refsect1> |
| <title>Compatibility</title> |
| |
| <para> |
| <command>DROP FOREIGN DATA WRAPPER</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"> |
| <member><xref linkend="sql-createforeigndatawrapper" endterm="sql-createforeigndatawrapper-title"></member> |
| <member><xref linkend="sql-alterforeigndatawrapper" endterm="sql-alterforeigndatawrapper-title"></member> |
| </simplelist> |
| </refsect1> |
| |
| </refentry> |