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
2021-07-23 00:33:47 +02:00
trigger.
</para>
<para>
The <literal>RENAME</literal> clause changes the name of
2003-04-15 15:25:08 +02:00
the given trigger without otherwise changing the trigger
2021-07-23 00:33:47 +02:00
definition.
If the table that the trigger is on is a partitioned table,
then corresponding clone triggers in the partitions are
renamed too.
</para>
<para>
The <literal>DEPENDS ON EXTENSION</literal> clause marks
2016-04-05 23:38:54 +02:00
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
Improve <xref> vs. <command> formatting in the documentation
SQL commands are generally marked up as <command>, except when a link
to a reference page is used using <xref>. But the latter doesn't
create monospace markup, so this looks strange especially when a
paragraph contains a mix of links and non-links.
We considered putting <command> in the <refentrytitle> on the target
side, but that creates some formatting side effects elsewhere.
Generally, it seems safer to solve this on the link source side.
We can't put the <xref> inside the <command>; the DTD doesn't allow
this. DocBook 5 would allow the <command> to have the linkend
attribute itself, but we are not there yet.
So to solve this for now, convert the <xref>s to <link> plus
<command>. This gives the correct look and also gives some more
flexibility what we can put into the link text (e.g., subcommands or
other clauses). In the future, these could then be converted to
DocBook 5 style.
I haven't converted absolutely all xrefs to SQL command reference
pages, only those where we care about the appearance of the link text
or where it was otherwise appropriate to make the appearance match a
bit better. Also in some cases, the links where repetitive, so in
those cases the links where just removed and replaced by a plain
<command>. In cases where we just want the link and don't
specifically care about the generated link text (typically phrased
"for further information see <xref ...>") the xref is kept.
Reported-by: Dagfinn Ilmari Mannsåker <ilmari@ilmari.org>
Discussion: https://www.postgresql.org/message-id/flat/87o8pco34z.fsf@wibble.ilmari.org
2020-10-03 16:16:51 +02:00
<link linkend="sql-altertable"><command>ALTER TABLE</command></link>, 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>