Doc: note that statement-level view triggers require an INSTEAD OF trigger.

Tom Lane <tgl@sss.pgh.pa.us>

Commit: ff301166a9a6f23527277b89495ce56973a409f3
Author: Tom Lane <tgl@sss.pgh.pa.us>
Date: 2018-03-18T19:10:28Z
Releases: 10.4
Doc: note that statement-level view triggers require an INSTEAD OF trigger.

If a view lacks an INSTEAD OF trigger, DML on it can only work by rewriting
the command into a command on the underlying base table(s).  Then we will
fire triggers attached to those table(s), not those for the view.  This
seems appropriate from a consistency standpoint, but nowhere was the
behavior explicitly documented, so let's do that.

There was some discussion of throwing an error or warning if a statement
trigger is created on a view without creating a row INSTEAD OF trigger.
But a simple implementation of that would result in dump/restore ordering
hazards.  Given that it's been like this all along, and we hadn't heard
a complaint till now, a documentation improvement seems sufficient.

Per bug #15106 from Pu Qun.  Back-patch to all supported branches.

Discussion: https://postgr.es/m/152083391168.1215.16892140713507052796@wrigleys.postgresql.org

Files

PathChange+/−
doc/src/sgml/ref/create_trigger.sgml modified +13 −0
doc/src/sgml/trigger.sgml modified +9 −3

Documentation touched

Discussion