2002-04-24 04:53:13 +02:00
<!--
2010-09-20 22:08:53 +02:00
doc/src/sgml/ref/alter_trigger.sgml
2002-04-24 04:53:13 +02:00
PostgreSQL documentation
-->
2017-10-20 03:16:39 +02:00
<refentry id="sql-altertrigger">
2014-02-24 03:25:35 +01:00
<indexterm zone="sql-altertrigger">
<primary>ALTER TRIGGER</primary>
</indexterm>
2002-04-24 04:53:13 +02:00
<refmeta>
2010-04-03 09:23:02 +02:00
<refentrytitle>ALTER TRIGGER</refentrytitle>
2008-11-14 11:22:48 +01:00
<manvolnum>7</manvolnum>
2002-04-24 04:53:13 +02:00
<refmiscinfo>SQL - Language Statements</refmiscinfo>
</refmeta>
2003-04-15 15:25:08 +02:00
2002-04-24 04:53:13 +02:00
<refnamediv>
2003-04-15 15:25:08 +02:00
<refname>ALTER TRIGGER</refname>
<refpurpose>change the definition of a trigger</refpurpose>
2002-04-24 04:53:13 +02:00
</refnamediv>
2003-04-15 15:25:08 +02:00
2002-04-24 04:53:13 +02:00
<refsynopsisdiv>
2003-04-15 15:25:08 +02:00
<synopsis>
2017-10-09 04:00:57 +02:00
ALTER TRIGGER <replaceable class="parameter">name</replaceable> ON <replaceable class="parameter">table_name</replaceable> RENAME TO <replaceable class="parameter">new_name</replaceable>
2020-04-20 19:42:12 +02:00
ALTER TRIGGER <replaceable class="parameter">name</replaceable> ON <replaceable class="parameter">table_name</replaceable> [ NO ] DEPENDS ON EXTENSION <replaceable class="parameter">extension_name</replaceable>
2003-04-15 15:25:08 +02:00
</synopsis>
2002-04-24 04:53:13 +02:00
</refsynopsisdiv>
2003-04-15 15:25:08 +02:00
<refsect1>
<title>Description</title>
2002-04-24 04:53:13 +02:00
<para>
2003-04-15 15:25:08 +02:00
<command>ALTER TRIGGER</command> changes properties of an existing
trigger. The <literal>RENAME</literal> clause changes the name of
the given trigger without otherwise changing the trigger
2016-04-05 23:38:54 +02:00
definition. The <literal>DEPENDS ON EXTENSION</literal> clause marks
the trigger as dependent on an extension, such that if the extension is
dropped, the trigger will automatically be dropped as well.
2002-04-24 04:53:13 +02:00
</para>
<para>
2003-04-15 15:25:08 +02:00
You must own the table on which the trigger acts to be allowed to change its properties.
2002-04-24 04:53:13 +02:00
</para>
2003-04-15 15:25:08 +02:00
</refsect1>
<refsect1>
2003-09-09 20:28:53 +02:00
<title>Parameters</title>
2003-04-15 15:25:08 +02:00
<variablelist>
<varlistentry>
2017-10-09 04:00:57 +02:00
<term><replaceable class="parameter">name</replaceable></term>
2003-04-15 15:25:08 +02:00
<listitem>
<para>
The name of an existing trigger to alter.
</para>
</listitem>
</varlistentry>
<varlistentry>
2017-10-09 04:00:57 +02:00
<term><replaceable class="parameter">table_name</replaceable></term>
2003-04-15 15:25:08 +02:00
<listitem>
<para>
The name of the table on which this trigger acts.
</para>
</listitem>
</varlistentry>
<varlistentry>
2017-10-09 04:00:57 +02:00
<term><replaceable class="parameter">new_name</replaceable></term>
2003-04-15 15:25:08 +02:00
<listitem>
<para>
The new name for the trigger.
</para>
</listitem>
</varlistentry>
2016-04-05 23:38:54 +02:00
<varlistentry>
2017-10-09 04:00:57 +02:00
<term><replaceable class="parameter">extension_name</replaceable></term>
2016-04-05 23:38:54 +02:00
<listitem>
<para>
2020-04-20 19:42:12 +02:00
The name of the extension that the trigger is to depend on (or no longer
dependent on, if <literal>NO</literal> is specified). A trigger
that's marked as dependent on an extension is automatically dropped when
the extension is dropped.
2016-04-05 23:38:54 +02:00
</para>
</listitem>
</varlistentry>
2003-04-15 15:25:08 +02:00
</variablelist>
</refsect1>
2002-04-24 04:53:13 +02:00
2005-08-24 19:24:19 +02:00
<refsect1>
<title>Notes</title>
<para>
The ability to temporarily enable or disable a trigger is provided by
2017-11-23 15:39:47 +01:00
<xref linkend="sql-altertable"/>, not by
2017-10-09 03:44:17 +02:00
<command>ALTER TRIGGER</command>, because <command>ALTER TRIGGER</command> has no
2005-08-24 19:24:19 +02:00
convenient way to express the option of enabling or disabling all of
a table's triggers at once.
</para>
</refsect1>
2003-04-15 15:25:08 +02:00
<refsect1>
<title>Examples</title>
2002-04-24 04:53:13 +02:00
<para>
To rename an existing trigger:
2003-04-15 15:25:08 +02:00
<programlisting>
2002-04-24 04:53:13 +02:00
ALTER TRIGGER emp_stamp ON emp RENAME TO emp_track_chgs;
2016-04-05 23:38:54 +02:00
</programlisting></para>
<para>
To mark a trigger as being dependent on an extension:
<programlisting>
ALTER TRIGGER emp_stamp ON emp DEPENDS ON EXTENSION emplib;
2011-08-07 09:49:45 +02:00
</programlisting></para>
2002-04-24 04:53:13 +02:00
</refsect1>
2003-04-15 15:25:08 +02:00
<refsect1>
<title>Compatibility</title>
<para>
2017-10-09 03:44:17 +02:00
<command>ALTER TRIGGER</command> is a <productname>PostgreSQL</productname>
2003-04-15 15:25:08 +02:00
extension of the SQL standard.
</para>
2002-04-24 04:53:13 +02:00
</refsect1>
2005-08-24 19:24:19 +02:00
<refsect1>
<title>See Also</title>
<simplelist type="inline">
2017-11-23 15:39:47 +01:00
<member><xref linkend="sql-altertable"/></member>
2005-08-24 19:24:19 +02:00
</simplelist>
</refsect1>
2002-04-24 04:53:13 +02:00
</refentry>