mirror of
https://github.com/postgres/postgres.git
synced 2025-05-21 15:54:08 +03:00
3c49c6facb
Since some preparation work had already been done, the only source changes left were changing empty-element tags like <xref linkend="foo"> to <xref linkend="foo"/>, and changing the DOCTYPE. The source files are still named *.sgml, but they are actually XML files now. Renaming could be considered later. In the build system, the intermediate step to convert from SGML to XML is removed. Everything is build straight from the source files again. The OpenSP (or the old SP) package is no longer needed. The documentation toolchain instructions are updated and are much simpler now. Peter Eisentraut, Alexander Lakhin, Jürgen Purtz
133 lines
3.5 KiB
Plaintext
133 lines
3.5 KiB
Plaintext
<!--
|
|
doc/src/sgml/ref/alter_trigger.sgml
|
|
PostgreSQL documentation
|
|
-->
|
|
|
|
<refentry id="sql-altertrigger">
|
|
<indexterm zone="sql-altertrigger">
|
|
<primary>ALTER TRIGGER</primary>
|
|
</indexterm>
|
|
|
|
<refmeta>
|
|
<refentrytitle>ALTER TRIGGER</refentrytitle>
|
|
<manvolnum>7</manvolnum>
|
|
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>ALTER TRIGGER</refname>
|
|
<refpurpose>change the definition of a trigger</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<synopsis>
|
|
ALTER TRIGGER <replaceable class="parameter">name</replaceable> ON <replaceable class="parameter">table_name</replaceable> RENAME TO <replaceable class="parameter">new_name</replaceable>
|
|
ALTER TRIGGER <replaceable class="parameter">name</replaceable> ON <replaceable class="parameter">table_name</replaceable> DEPENDS ON EXTENSION <replaceable class="parameter">extension_name</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. 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.
|
|
</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_name</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
The name of the table on which this trigger acts.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><replaceable class="parameter">new_name</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
The new name for the trigger.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><replaceable class="parameter">extension_name</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
The name of the extension that the trigger is to depend on.
|
|
</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"/>, not by
|
|
<command>ALTER TRIGGER</command>, because <command>ALTER TRIGGER</command> 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>
|
|
|
|
<para>
|
|
To mark a trigger as being dependent on an extension:
|
|
<programlisting>
|
|
ALTER TRIGGER emp_stamp ON emp DEPENDS ON EXTENSION emplib;
|
|
</programlisting></para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Compatibility</title>
|
|
|
|
<para>
|
|
<command>ALTER TRIGGER</command> is a <productname>PostgreSQL</productname>
|
|
extension of the SQL standard.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
|
|
<simplelist type="inline">
|
|
<member><xref linkend="sql-altertable"/></member>
|
|
</simplelist>
|
|
</refsect1>
|
|
</refentry>
|