granicus.if.org Git - postgresql/blob - doc/src/sgml/ref/drop_event_trigger.sgml

   1 <!--
   2 doc/src/sgml/ref/drop_event_trigger.sgml
   3 PostgreSQL documentation
   4 -->
   5
   6 <refentry id="SQL-DROPEVENTTRIGGER">
   7  <refmeta>
   8   <refentrytitle>DROP EVENT TRIGGER</refentrytitle>
   9   <manvolnum>7</manvolnum>
  10   <refmiscinfo>SQL - Language Statements</refmiscinfo>
  11  </refmeta>
  12
  13  <refnamediv>
  14   <refname>DROP EVENT TRIGGER</refname>
  15   <refpurpose>remove an event trigger</refpurpose>
  16  </refnamediv>
  17
  18  <indexterm zone="sql-dropeventtrigger">
  19   <primary>DROP EVENT TRIGGER</primary>
  20  </indexterm>
  21
  22  <refsynopsisdiv>
  23 <synopsis>
  24 DROP EVENT TRIGGER [ 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 EVENT TRIGGER</command> removes an existing event trigger.
  33    To execute this command, the current user must be the owner of the event
  34    trigger.
  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 event trigger does not exist. A notice
  48       is issued 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 the event trigger to remove.
  58      </para>
  59     </listitem>
  60    </varlistentry>
  61
  62    <varlistentry>
  63     <term><literal>CASCADE</literal></term>
  64     <listitem>
  65      <para>
  66       Automatically drop objects that depend on the trigger.
  67      </para>
  68     </listitem>
  69    </varlistentry>
  70
  71    <varlistentry>
  72     <term><literal>RESTRICT</literal></term>
  73     <listitem>
  74      <para>
  75       Refuse to drop the trigger if any objects depend on it.  This is
  76       the default.
  77      </para>
  78     </listitem>
  79    </varlistentry>
  80   </variablelist>
  81  </refsect1>
  82
  83  <refsect1 id="sql-dropeventtrigger-examples">
  84   <title>Examples</title>
  85
  86   <para>
  87    Destroy the trigger <literal>snitch</literal>:
  88
  89 <programlisting>
  90 DROP EVENT TRIGGER snitch;
  91 </programlisting></para>
  92  </refsect1>
  93
  94  <refsect1 id="sql-dropeventtrigger-compatibility">
  95   <title>Compatibility</title>
  96
  97   <para>
  98    There is no <command>DROP EVENT TRIGGER</command> statement in the
  99    SQL standard.
 100   </para>
 101
 102  </refsect1>
 103
 104  <refsect1>
 105   <title>See Also</title>
 106
 107   <simplelist type="inline">
 108    <member><xref linkend="sql-createeventtrigger"></member>
 109    <member><xref linkend="sql-altereventtrigger"></member>
 110   </simplelist>
 111  </refsect1>
 112
 113 </refentry>