1999-07-22 17:09:15 +02:00
<!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/drop_trigger.sgml,v 1.6 1999/07/22 15:09:11 thomas Exp $
Postgres documentation
-->
1999-07-06 19:16:42 +02:00
<refentry id="SQL-DROPTRIGGER">
<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>
1998-09-07 17:53:12 +02:00
Removes the definition of 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
user must be the owner of the trigger.
1999-07-06 19:16:42 +02:00
</para>
<refsect2 id="R2-SQL-DROPTRIGGER-3">
<refsect2info>
<date>1998-09-22</date>
</refsect2info>
<title>
1998-09-07 17:53:12 +02:00
Notes
1999-07-06 19:16:42 +02:00
</title>
<para>
1998-09-22 17:48:03 +02:00
<command>DROP TRIGGER</command> is a <productname>Postgres</productname>
1998-09-07 17:53:12 +02:00
language extension.
1999-07-06 19:16:42 +02:00
</para>
<para>
1998-09-22 17:48:03 +02:00
Refer to <command>CREATE TRIGGER</command> for
1998-09-07 17:53:12 +02:00
information on how to create triggers.
1999-07-06 19:16:42 +02:00
</para>
</refsect2>
1998-12-29 03:24:47 +01:00
</refsect1>
1998-09-07 17:53:12 +02:00
1999-07-06 19:16:42 +02:00
<refsect1 id="R1-SQL-DROPTRIGGER-2">
<title>
1998-09-07 17:53:12 +02:00
Usage
1999-07-06 19:16:42 +02:00
</title>
<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>:
<programlisting>
1998-09-22 17:48:03 +02:00
DROP TRIGGER if_dist_exists ON films;
1999-07-06 19:16:42 +02:00
</programlisting>
</para>
</refsect1>
1998-09-07 17:53:12 +02:00
1999-07-06 19:16:42 +02:00
<refsect1 id="R1-SQL-DROPTRIGGER-3">
<title>
1998-09-07 17:53:12 +02:00
Compatibility
1999-07-06 19:16:42 +02:00
</title>
1998-09-07 17:53:12 +02:00
1999-07-06 19:16:42 +02:00
<refsect2 id="R2-SQL-DROPTRIGGER-4">
<refsect2info>
<date>1998-09-22</date>
</refsect2info>
<title>
1998-09-07 17:53:12 +02:00
SQL92
1999-07-06 19:16:42 +02:00
</title>
<para>
1998-09-22 17:48:03 +02:00
There is no <command>DROP TRIGGER</command> statement in
1999-07-06 19:16:42 +02:00
<acronym>SQL92</acronym>.
</para>
1998-09-07 17:53:12 +02:00
</refsect2>
</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:
-->