| <!-- |
| $PostgreSQL: pgsql/doc/src/sgml/ref/alter_trigger.sgml,v 1.10 2006/09/16 00:30:16 momjian Exp $ |
| PostgreSQL documentation |
| --> |
| |
| <refentry id="SQL-ALTERTRIGGER"> |
| <refmeta> |
| <refentrytitle id="sql-altertrigger-title">ALTER TRIGGER</refentrytitle> |
| <refmiscinfo>SQL - Language Statements</refmiscinfo> |
| </refmeta> |
| |
| <refnamediv> |
| <refname>ALTER TRIGGER</refname> |
| <refpurpose>change the definition of a trigger</refpurpose> |
| </refnamediv> |
| |
| <indexterm zone="sql-altertrigger"> |
| <primary>ALTER TRIGGER</primary> |
| </indexterm> |
| |
| <refsynopsisdiv> |
| <synopsis> |
| ALTER TRIGGER <replaceable class="PARAMETER">name</replaceable> ON <replaceable class="PARAMETER">table</replaceable> RENAME TO <replaceable class="PARAMETER">newname</replaceable> |
| </synopsis> |
| </refsynopsisdiv> |
| |
| <refsect1> |
| <title>Description</title> |
| |
| <para> |
| <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 |
| definition. |
| </para> |
| |
| <para> |
| You must own the table on which the trigger acts to be allowed to change its properties. |
| </para> |
| </refsect1> |
| |
| <refsect1> |
| <title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry> |
| <term><replaceable class="PARAMETER">name</replaceable></term> |
| <listitem> |
| <para> |
| The name of an existing trigger to alter. |
| </para> |
| </listitem> |
| </varlistentry> |
| |
| <varlistentry> |
| <term><replaceable class="PARAMETER">table</replaceable></term> |
| <listitem> |
| <para> |
| The name of the table on which this trigger acts. |
| </para> |
| </listitem> |
| </varlistentry> |
| |
| <varlistentry> |
| <term><replaceable class="PARAMETER">newname</replaceable></term> |
| <listitem> |
| <para> |
| The new name for the trigger. |
| </para> |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| </refsect1> |
| |
| <refsect1> |
| <title>Notes</title> |
| |
| <para> |
| The ability to temporarily enable or disable a trigger is provided by |
| <xref linkend="SQL-ALTERTABLE" endterm="SQL-ALTERTABLE-TITLE">, not by |
| <command>ALTER TRIGGER</>, because <command>ALTER TRIGGER</> has no |
| convenient way to express the option of enabling or disabling all of |
| a table's triggers at once. |
| </para> |
| </refsect1> |
| |
| <refsect1> |
| <title>Examples</title> |
| |
| <para> |
| To rename an existing trigger: |
| <programlisting> |
| ALTER TRIGGER emp_stamp ON emp RENAME TO emp_track_chgs; |
| </programlisting> |
| </para> |
| </refsect1> |
| |
| <refsect1> |
| <title>Compatibility</title> |
| |
| <para> |
| <command>ALTER TRIGGER</command> is a <productname>PostgreSQL</> |
| extension of the SQL standard. |
| </para> |
| </refsect1> |
| |
| <refsect1> |
| <title>See Also</title> |
| |
| <simplelist type="inline"> |
| <member><xref linkend="sql-altertable" endterm="sql-altertable-title"></member> |
| </simplelist> |
| </refsect1> |
| </refentry> |