doc/src/sgml/ref/drop_language.sgml

   1 <!--
   2 $PostgreSQL$
   3 PostgreSQL documentation
   4 -->
   5
   6 <refentry id="SQL-DROPLANGUAGE">
   7  <refmeta>
   8   <refentrytitle id="SQL-DROPLANGUAGE-TITLE">DROP LANGUAGE</refentrytitle>
   9   <manvolnum>7</manvolnum>
  10   <refmiscinfo>SQL - Language Statements</refmiscinfo>
  11  </refmeta>
  12
  13  <refnamediv>
  14   <refname>DROP LANGUAGE</refname>
  15   <refpurpose>remove a procedural language</refpurpose>
  16  </refnamediv>
  17
  18  <indexterm zone="sql-droplanguage">
  19   <primary>DROP LANGUAGE</primary>
  20  </indexterm>
  21
  22  <refsynopsisdiv>
  23 <synopsis>
  24 DROP [ PROCEDURAL ] LANGUAGE [ IF EXISTS ] <replaceable class="PARAMETER">name</replaceable> [ CASCADE | RESTRICT ]
  25 </synopsis>
  26  </refsynopsisdiv>
  27
  28  <refsect1>
  29   <title>Description</title>
  30
  31   <para>
  32    <command>DROP LANGUAGE</command> removes the definition of a
  33    previously registered procedural language.  You must be a superuser
  34    or the owner of the language to use <command>DROP LANGUAGE</>.
  35   </para>
  36  </refsect1>
  37
  38  <refsect1>
  39   <title>Parameters</title>
  40
  41   <variablelist>
  42
  43    <varlistentry>
  44     <term><literal>IF EXISTS</literal></term>
  45     <listitem>
  46      <para>
  47       Do not throw an error if the language does not exist. A notice is issued
  48       in this case.
  49      </para>
  50     </listitem>
  51    </varlistentry>
  52
  53    <varlistentry>
  54     <term><replaceable class="PARAMETER">name</replaceable></term>
  55     <listitem>
  56      <para>
  57       The name of an existing procedural language.  For backward
  58       compatibility, the name can be enclosed by single quotes.
  59      </para>
  60     </listitem>
  61    </varlistentry>
  62
  63    <varlistentry>
  64     <term><literal>CASCADE</literal></term>
  65     <listitem>
  66      <para>
  67       Automatically drop objects that depend on the language (such as
  68       functions in the language).
  69      </para>
  70     </listitem>
  71    </varlistentry>
  72
  73    <varlistentry>
  74     <term><literal>RESTRICT</literal></term>
  75     <listitem>
  76      <para>
  77       Refuse to drop the language if any objects depend on it.  This
  78       is the default.
  79      </para>
  80     </listitem>
  81    </varlistentry>
  82   </variablelist>
  83  </refsect1>
  84
  85  <refsect1>
  86   <title>Examples</title>
  87
  88   <para>
  89    This command removes the procedural language
  90    <literal>plsample</literal>:
  91
  92 <programlisting>
  93 DROP LANGUAGE plsample;
  94 </programlisting>
  95   </para>
  96  </refsect1>
  97
  98  <refsect1>
  99   <title>Compatibility</title>
 100
 101   <para>
 102    There is no <command>DROP LANGUAGE</command> statement in the SQL
 103    standard.
 104   </para>
 105  </refsect1>
 106
 107  <refsect1>
 108   <title>See Also</title>
 109
 110   <simplelist type="inline">
 111    <member><xref linkend="sql-alterlanguage" endterm="sql-alterlanguage-title"></member>
 112    <member><xref linkend="sql-createlanguage" endterm="sql-createlanguage-title"></member>
 113    <member><xref linkend="app-droplang"></member>
 114   </simplelist>
 115  </refsect1>
 116
 117 </refentry>