<programlisting>
CREATE TRIGGER insert_measurement_trigger
BEFORE INSERT ON measurement
- FOR EACH ROW EXECUTE PROCEDURE measurement_insert_trigger();
+ FOR EACH ROW EXECUTE FUNCTION measurement_insert_trigger();
</programlisting>
We must redefine the trigger function each month so that it always
AS 'noddl' LANGUAGE C;
CREATE EVENT TRIGGER noddl ON ddl_command_start
- EXECUTE PROCEDURE noddl();
+ EXECUTE FUNCTION noddl();
</programlisting>
</para>
CREATE EVENT TRIGGER no_rewrite_allowed
ON table_rewrite
- EXECUTE PROCEDURE no_rewrite();
+ EXECUTE FUNCTION no_rewrite();
</programlisting>
</para>
</sect1>
<programlisting>
CREATE TRIGGER z_min_update
BEFORE UPDATE ON tablename
-FOR EACH ROW EXECUTE PROCEDURE suppress_redundant_updates_trigger();
+FOR EACH ROW EXECUTE FUNCTION suppress_redundant_updates_trigger();
</programlisting>
In most cases, you would want to fire this trigger last for each row.
Bearing in mind that triggers fire in name order, you would then
$$;
CREATE EVENT TRIGGER test_event_trigger_for_drops
ON sql_drop
- EXECUTE PROCEDURE test_event_trigger_for_drops();
+ EXECUTE FUNCTION test_event_trigger_for_drops();
</programlisting>
</para>
</sect2>
CREATE EVENT TRIGGER test_table_rewrite_oid
ON table_rewrite
- EXECUTE PROCEDURE test_event_trigger_table_rewrite_oid();
+ EXECUTE FUNCTION test_event_trigger_table_rewrite_oid();
</programlisting>
</para>
</sect2>
<entry><type>character_data</type></entry>
<entry>
Statement that is executed by the trigger (currently always
- <literal>EXECUTE PROCEDURE
+ <literal>EXECUTE FUNCTION
<replaceable>function</replaceable>(...)</literal>)
</entry>
</row>
CREATE TABLE image (title text, raster lo);
CREATE TRIGGER t_raster BEFORE UPDATE OR DELETE ON image
- FOR EACH ROW EXECUTE PROCEDURE lo_manage(raster);
+ FOR EACH ROW EXECUTE FUNCTION lo_manage(raster);
</programlisting>
<para>
CREATE TRIGGER test_valid_id_trig
BEFORE INSERT OR UPDATE ON test
- FOR EACH ROW EXECUTE PROCEDURE valid_id();
+ FOR EACH ROW EXECUTE FUNCTION valid_id();
</programlisting>
</para>
</sect1>
CREATE EVENT TRIGGER perl_a_snitch
ON ddl_command_start
- EXECUTE PROCEDURE perlsnitch();
+ EXECUTE FUNCTION perlsnitch();
</programlisting>
</para>
</sect1>
$emp_stamp$ LANGUAGE plpgsql;
CREATE TRIGGER emp_stamp BEFORE INSERT OR UPDATE ON emp
- FOR EACH ROW EXECUTE PROCEDURE emp_stamp();
+ FOR EACH ROW EXECUTE FUNCTION emp_stamp();
</programlisting>
</example>
CREATE TRIGGER emp_audit
AFTER INSERT OR UPDATE OR DELETE ON emp
- FOR EACH ROW EXECUTE PROCEDURE process_emp_audit();
+ FOR EACH ROW EXECUTE FUNCTION process_emp_audit();
</programlisting>
</example>
CREATE TRIGGER emp_audit
INSTEAD OF INSERT OR UPDATE OR DELETE ON emp_view
- FOR EACH ROW EXECUTE PROCEDURE update_emp_view();
+ FOR EACH ROW EXECUTE FUNCTION update_emp_view();
</programlisting>
</example>
CREATE TRIGGER maint_sales_summary_bytime
AFTER INSERT OR UPDATE OR DELETE ON sales_fact
- FOR EACH ROW EXECUTE PROCEDURE maint_sales_summary_bytime();
+ FOR EACH ROW EXECUTE FUNCTION maint_sales_summary_bytime();
INSERT INTO sales_fact VALUES(1,1,1,10,3,15);
INSERT INTO sales_fact VALUES(1,2,1,20,5,35);
CREATE TRIGGER emp_audit_ins
AFTER INSERT ON emp
REFERENCING NEW TABLE AS new_table
- FOR EACH STATEMENT EXECUTE PROCEDURE process_emp_audit();
+ FOR EACH STATEMENT EXECUTE FUNCTION process_emp_audit();
CREATE TRIGGER emp_audit_upd
AFTER UPDATE ON emp
REFERENCING OLD TABLE AS old_table NEW TABLE AS new_table
- FOR EACH STATEMENT EXECUTE PROCEDURE process_emp_audit();
+ FOR EACH STATEMENT EXECUTE FUNCTION process_emp_audit();
CREATE TRIGGER emp_audit_del
AFTER DELETE ON emp
REFERENCING OLD TABLE AS old_table
- FOR EACH STATEMENT EXECUTE PROCEDURE process_emp_audit();
+ FOR EACH STATEMENT EXECUTE FUNCTION process_emp_audit();
</programlisting>
</example>
END;
$$ LANGUAGE plpgsql;
-CREATE EVENT TRIGGER snitch ON ddl_command_start EXECUTE PROCEDURE snitch();
+CREATE EVENT TRIGGER snitch ON ddl_command_start EXECUTE FUNCTION snitch();
</programlisting>
</example>
</sect2>
CREATE TABLE mytab (num integer, description text, modcnt integer);
CREATE TRIGGER trig_mytab_modcount BEFORE INSERT OR UPDATE ON mytab
- FOR EACH ROW EXECUTE PROCEDURE trigfunc_modcount('modcnt');
+ FOR EACH ROW EXECUTE FUNCTION trigfunc_modcount('modcnt');
</programlisting>
Notice that the trigger function itself does not know the column
elog NOTICE "tclsnitch: $TG_event $TG_tag"
$$ LANGUAGE pltcl;
-CREATE EVENT TRIGGER tcl_a_snitch ON ddl_command_start EXECUTE PROCEDURE tclsnitch();
+CREATE EVENT TRIGGER tcl_a_snitch ON ddl_command_start EXECUTE FUNCTION tclsnitch();
</programlisting>
</para>
</sect1>
CREATE EVENT TRIGGER <replaceable class="parameter">name</replaceable>
ON <replaceable class="parameter">event</replaceable>
[ WHEN <replaceable class="parameter">filter_variable</replaceable> IN (filter_value [, ... ]) [ AND ... ] ]
- EXECUTE PROCEDURE <replaceable class="parameter">function_name</replaceable>()
+ EXECUTE { FUNCTION | PROCEDURE } <replaceable class="parameter">function_name</replaceable>()
</synopsis>
</refsynopsisdiv>
A user-supplied function that is declared as taking no argument and
returning type <literal>event_trigger</literal>.
</para>
+
+ <para>
+ In the syntax of <literal>CREATE EVENT TRIGGER</literal>, the keywords
+ <literal>FUNCTION</literal> and <literal>PROCEDURE</literal> are
+ equivalent, but the referenced function must in any case be a function,
+ not a procedure. The use of the keyword <literal>PROCEDURE</literal>
+ here is historical and deprecated.
+ </para>
</listitem>
</varlistentry>
$$;
CREATE EVENT TRIGGER abort_ddl ON ddl_command_start
- EXECUTE PROCEDURE abort_any_command();
+ EXECUTE FUNCTION abort_any_command();
</programlisting></para>
</refsect1>
[ REFERENCING { { OLD | NEW } TABLE [ AS ] <replaceable class="parameter">transition_relation_name</replaceable> } [ ... ] ]
[ FOR [ EACH ] { ROW | STATEMENT } ]
[ WHEN ( <replaceable class="parameter">condition</replaceable> ) ]
- EXECUTE PROCEDURE <replaceable class="parameter">function_name</replaceable> ( <replaceable class="parameter">arguments</replaceable> )
+ EXECUTE { FUNCTION | PROCEDURE } <replaceable class="parameter">function_name</replaceable> ( <replaceable class="parameter">arguments</replaceable> )
<phrase>where <replaceable class="parameter">event</replaceable> can be one of:</phrase>
and returning type <literal>trigger</literal>, which is executed when
the trigger fires.
</para>
+
+ <para>
+ In the syntax of <literal>CREATE TRIGGER</literal>, the keywords
+ <literal>FUNCTION</literal> and <literal>PROCEDURE</literal> are
+ equivalent, but the referenced function must in any case be a function,
+ not a procedure. The use of the keyword <literal>PROCEDURE</literal>
+ here is historical and deprecated.
+ </para>
</listitem>
</varlistentry>
CREATE TRIGGER check_update
BEFORE UPDATE ON accounts
FOR EACH ROW
- EXECUTE PROCEDURE check_account_update();
+ EXECUTE FUNCTION check_account_update();
</programlisting>
The same, but only execute the function if column <literal>balance</literal>
CREATE TRIGGER check_update
BEFORE UPDATE OF balance ON accounts
FOR EACH ROW
- EXECUTE PROCEDURE check_account_update();
+ EXECUTE FUNCTION check_account_update();
</programlisting>
This form only executes the function if column <literal>balance</literal>
BEFORE UPDATE ON accounts
FOR EACH ROW
WHEN (OLD.balance IS DISTINCT FROM NEW.balance)
- EXECUTE PROCEDURE check_account_update();
+ EXECUTE FUNCTION check_account_update();
</programlisting>
Call a function to log updates of <literal>accounts</literal>, but only if
AFTER UPDATE ON accounts
FOR EACH ROW
WHEN (OLD.* IS DISTINCT FROM NEW.*)
- EXECUTE PROCEDURE log_account_update();
+ EXECUTE FUNCTION log_account_update();
</programlisting>
Execute the function <function>view_insert_row</function> for each row to insert
CREATE TRIGGER view_insert
INSTEAD OF INSERT ON my_view
FOR EACH ROW
- EXECUTE PROCEDURE view_insert_row();
+ EXECUTE FUNCTION view_insert_row();
</programlisting>
Execute the function <function>check_transfer_balances_to_zero</function> for each
AFTER INSERT ON transfer
REFERENCING NEW TABLE AS inserted
FOR EACH STATEMENT
- EXECUTE PROCEDURE check_transfer_balances_to_zero();
+ EXECUTE FUNCTION check_transfer_balances_to_zero();
</programlisting>
Execute the function <function>check_matching_pairs</function> for each row to
AFTER UPDATE ON paired_items
REFERENCING NEW TABLE AS newtab OLD TABLE AS oldtab
FOR EACH ROW
- EXECUTE PROCEDURE check_matching_pairs();
+ EXECUTE FUNCTION check_matching_pairs();
</programlisting>
</para>
CREATE TABLE
test=# create trigger tcndata_tcn_trigger
test-# after insert or update or delete on tcndata
-test-# for each row execute procedure triggered_change_notification();
+test-# for each row execute function triggered_change_notification();
CREATE TRIGGER
test=# listen tcn;
LISTEN
);
CREATE TRIGGER tsvectorupdate BEFORE INSERT OR UPDATE
-ON messages FOR EACH ROW EXECUTE PROCEDURE
+ON messages FOR EACH ROW EXECUTE FUNCTION
tsvector_update_trigger(tsv, 'pg_catalog.english', title, body);
INSERT INTO messages VALUES('title here', 'the body text is here');
$$ LANGUAGE plpgsql;
CREATE TRIGGER tsvectorupdate BEFORE INSERT OR UPDATE
- ON messages FOR EACH ROW EXECUTE PROCEDURE messages_trigger();
+ ON messages FOR EACH ROW EXECUTE FUNCTION messages_trigger();
</programlisting>
</para>
LANGUAGE C;
CREATE TRIGGER tbefore BEFORE INSERT OR UPDATE OR DELETE ON ttest
- FOR EACH ROW EXECUTE PROCEDURE trigf();
+ FOR EACH ROW EXECUTE FUNCTION trigf();
CREATE TRIGGER tafter AFTER INSERT OR UPDATE OR DELETE ON ttest
- FOR EACH ROW EXECUTE PROCEDURE trigf();
+ FOR EACH ROW EXECUTE FUNCTION trigf();
</programlisting>
</para>
CreateTrigStmt:
CREATE TRIGGER name TriggerActionTime TriggerEvents ON
qualified_name TriggerReferencing TriggerForSpec TriggerWhen
- EXECUTE PROCEDURE func_name '(' TriggerFuncArgs ')'
+ EXECUTE FUNCTION_or_PROCEDURE func_name '(' TriggerFuncArgs ')'
{
CreateTrigStmt *n = makeNode(CreateTrigStmt);
n->trigname = $3;
| CREATE CONSTRAINT TRIGGER name AFTER TriggerEvents ON
qualified_name OptConstrFromTable ConstraintAttributeSpec
FOR EACH ROW TriggerWhen
- EXECUTE PROCEDURE func_name '(' TriggerFuncArgs ')'
+ EXECUTE FUNCTION_or_PROCEDURE func_name '(' TriggerFuncArgs ')'
{
CreateTrigStmt *n = makeNode(CreateTrigStmt);
n->trigname = $4;
| /*EMPTY*/ { $$ = NULL; }
;
+FUNCTION_or_PROCEDURE:
+ FUNCTION
+ | PROCEDURE
+ ;
+
TriggerFuncArgs:
TriggerFuncArg { $$ = list_make1($1); }
| TriggerFuncArgs ',' TriggerFuncArg { $$ = lappend($1, $3); }
create trigger check_fkeys_pkey_exist
before insert or update on fkeys
for each row
- execute procedure
+ execute function
check_primary_key ('fkey1', 'fkey2', 'pkeys', 'pkey1', 'pkey2');
create trigger check_fkeys_pkey2_exist
before insert or update on fkeys
for each row
- execute procedure check_primary_key ('fkey3', 'fkeys2', 'pkey23');
+ execute function check_primary_key ('fkey3', 'fkeys2', 'pkey23');
--
-- For fkeys2:
-- (fkey21, fkey22) --> pkeys (pkey1, pkey2)
create trigger check_fkeys_pkey_exist
before insert or update on fkeys
for each row
- execute procedure
+ execute function
check_primary_key ('fkey1', 'fkey2', 'pkeys', 'pkey1', 'pkey2');
create trigger check_fkeys_pkey2_exist
before insert or update on fkeys
for each row
- execute procedure check_primary_key ('fkey3', 'fkeys2', 'pkey23');
+ execute function check_primary_key ('fkey3', 'fkeys2', 'pkey23');
--
-- For fkeys2: