1999-07-22 17:09:15 +02:00
<!--
2001-12-08 04:24:40 +01:00
$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_trigger.sgml,v 1.9 2001/12/08 03:24:36 thomas Exp $
PostgreSQL documentation
1999-07-22 17:09:15 +02:00
-->
1999-07-06 19:16:42 +02:00
<refentry id="SQL-DROPTRIGGER">
2001-09-13 20:17:44 +02:00
<docinfo>
<date>2001-09-13</date>
</docinfo>
1999-07-06 19:16:42 +02:00
<refmeta>
1999-07-22 17:09:15 +02:00
<refentrytitle id="SQL-DROPTRIGGER-TITLE">
1998-09-07 17:53:12 +02:00
DROP TRIGGER
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 TRIGGER
1999-07-06 19:16:42 +02:00
</refname>
<refpurpose>
2001-09-03 14:57:50 +02:00
remove a trigger
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>
<date>1998-09-22</date>
</refsynopsisdivinfo>
<synopsis>
DROP TRIGGER <replaceable class="PARAMETER">name</replaceable> ON <replaceable class="PARAMETER">table</replaceable>
</synopsis>
<refsect2 id="R2-SQL-DROPTRIGGER-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 trigger.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="PARAMETER">table</replaceable></term>
<listitem>
<para>
The name of a table.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect2>
<refsect2 id="R2-SQL-DROPTRIGGER-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>
1998-10-30 20:34:40 +01:00
1999-07-06 19:16:42 +02:00
<variablelist>
<varlistentry>
<term><computeroutput>
DROP
</computeroutput></term>
<listitem>
<para>
The message returned if the trigger is successfully dropped.
1998-12-29 03:24:47 +01:00
</para>
</listitem>
</varlistentry>
1999-07-06 19:16:42 +02:00
<varlistentry>
<term><computeroutput>
ERROR: DropTrigger: there is no trigger <replaceable class="PARAMETER">name</replaceable> on relation "<replaceable class="parameter">table</replaceable>"
</computeroutput></term>
<listitem>
<para>
This message occurs if the trigger specified does not exist.
</para>
</listitem>
</varlistentry>
</variablelist>
1998-12-29 03:24:47 +01:00
</para>
1999-07-06 19:16:42 +02:00
</refsect2>
</refsynopsisdiv>
<refsect1 id="R1-SQL-DROPTRIGGER-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>
1998-09-07 17:53:12 +02:00
<command>DROP TRIGGER</command> will remove all references to an existing
trigger definition. To execute this command the current
2001-09-13 20:17:44 +02:00
user must be the owner of the table for which the trigger is defined.
1999-07-06 19:16:42 +02:00
</para>
1998-12-29 03:24:47 +01:00
</refsect1>
2001-09-13 20:17:44 +02:00
<refsect1 id="SQL-DROPTRIGGER-examples">
<title>Examples</title>
1999-07-06 19:16:42 +02:00
<para>
1998-09-22 17:48:03 +02:00
Destroy the <literal>if_dist_exists</literal> trigger
1999-07-06 19:16:42 +02:00
on table <literal>films</literal>:
2001-09-13 20:17:44 +02:00
<programlisting>
1998-09-22 17:48:03 +02:00
DROP TRIGGER if_dist_exists ON films;
2001-09-13 20:17:44 +02:00
</programlisting>
1999-07-06 19:16:42 +02:00
</para>
</refsect1>
1998-09-07 17:53:12 +02:00
2001-09-13 20:17:44 +02:00
<refsect1 id="SQL-DROPTRIGGER-compatibility">
<title>Compatibility</title>
1998-09-07 17:53:12 +02:00
2001-09-13 20:17:44 +02:00
<variablelist>
<varlistentry>
<term>SQL92</term>
<listitem>
<para>
There is no <command>DROP TRIGGER</command> statement in
<acronym>SQL92</acronym>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>SQL99</term>
<listitem>
<para>
The <command>DROP TRIGGER</command> statement in
<productname>PostgreSQL</productname> is incompatible with
SQL99. In SQL99, trigger names are not local to tables, so the
command is simply <literal>DROP TRIGGER
<replaceable>name</replaceable></literal>.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>See Also</title>
<simplelist type="inline">
<member><xref linkend="sql-createtrigger"></member>
</simplelist>
1998-09-07 17:53:12 +02:00
</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:
-->