database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-06-17 17:02:08 +03:00
Code Activity

Docs: minor improvements for documentation about plpgsql triggers.

Browse Source 
Fabien Coelho, some further wordsmithing by me
This commit is contained in:
Tom Lane
2016-07-08 13:23:09 -04:00
parent 8ba4ccda45
commit 769159fd39
1 changed files with 21 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
doc/src/sgml/plpgsql.sgml
View File

@ -3660,17 +3660,26 @@ ASSERT <replaceable class="parameter">condition</replaceable> <optional> , <repl
<secondary>in PL/pgSQL</secondary>
</indexterm>
<para>
<application>PL/pgSQL</application> can be used to define trigger
procedures on data changes or database events.
A trigger procedure is created with the <command>CREATE FUNCTION</>
command, declaring it as a function with no arguments and a return type of
<type>trigger</> (for data change triggers) or
<type>event_trigger</> (for database event triggers).
Special local variables named <varname>PG_<replaceable>something</></> are
automatically defined to describe the condition that triggered the call.
</para>
<sect2 id="plpgsql-dml-trigger">
<title>Triggers on Data Changes</title>
<para>
<application>PL/pgSQL</application> can be used to define trigger
procedures. A trigger procedure is created with the
<command>CREATE FUNCTION</> command, declaring it as a function with
no arguments and a return type of <type>trigger</type>. Note that
the function must be declared with no arguments even if it expects
to receive arguments specified in <command>CREATE TRIGGER</> &mdash;
trigger arguments are passed via <varname>TG_ARGV</>, as described
A <link linkend="triggers">data change trigger</> is declared as a
function with no arguments and a return type of <type>trigger</>.
Note that the function must be declared with no arguments even if it
expects to receive some arguments specified in <command>CREATE TRIGGER</>
&mdash; such arguments are passed via <varname>TG_ARGV</>, as described
below.
</para>
@ -4218,8 +4227,9 @@ SELECT * FROM sales_summary_bytime;
<title>Triggers on Events</title>
<para>
<application>PL/pgSQL</application> can be used to define event
triggers. <productname>PostgreSQL</> requires that a procedure that
<application>PL/pgSQL</application> can be used to define
<link linkend="event-triggers">event triggers</>.
<productname>PostgreSQL</> requires that a procedure that
is to be called as an event trigger must be declared as a function with
no arguments and a return type of <literal>event_trigger</>.
</para>