Fix ENABLE/DISABLE TRIGGER to handle recursion correctly
authorAlvaro Herrera <alvherre@alvh.no-ip.org>
Thu, 4 Aug 2022 18:02:02 +0000 (20:02 +0200)
committerAlvaro Herrera <alvherre@alvh.no-ip.org>
Fri, 5 Aug 2022 07:46:58 +0000 (09:46 +0200)
Using ATSimpleRecursion() in ATPrepCmd() to do so as bbb927b4db9b did is
not correct, because ATPrepCmd() can't distinguish between triggers that
may be cloned and those that may not, so would wrongly try to recurse
for the latter category of triggers.

So this commit restores the code in EnableDisableTrigger() that
86f575948c77 had added to do the recursion, which would do it only for
triggers that may be cloned, that is, row-level triggers.  This also
changes tablecmds.c such that ATExecCmd() is able to pass the value of
ONLY flag down to EnableDisableTrigger() using its new 'recurse'
parameter.

This also fixes what seems like an oversight of 86f575948c77 that the
recursion to partition triggers would only occur if EnableDisableTrigger()
had actually changed the trigger.  It is more apt to recurse to inspect
partition triggers even if the parent's trigger didn't need to be
changed: only then can we be certain that all descendants share the same
state afterwards.

Backpatch all the way back to 11, like bbb927b4db9b.  Care is taken not
to break ABI compatibility (and that no catversion bump is needed.)

Co-authored-by: Amit Langote <amitlangote09@gmail.com>
Reviewed-by: Dmitry Koval <d.koval@postgrespro.ru>
Discussion: https://postgr.es/m/CA+HiwqG-cZT3XzGAnEgZQLoQbyfJApVwOTQaCaas1mhpf+4V5A@mail.gmail.com

src/backend/commands/tablecmds.c
src/backend/commands/trigger.c
src/backend/nodes/copyfuncs.c
src/backend/nodes/equalfuncs.c
src/include/commands/trigger.h
src/include/nodes/parsenodes.h
src/test/regress/expected/triggers.out
src/test/regress/sql/triggers.sql

index 1f539879b63215498946bcec91588e53b18adfaa..14faa61380acf836e34982726084f41a81a82156 100644 (file)
@@ -467,7 +467,8 @@ static void ATExecSetRelOptions(Relation rel, List *defList,
                    AlterTableType operation,
                    LOCKMODE lockmode);
 static void ATExecEnableDisableTrigger(Relation rel, const char *trigname,
-                          char fires_when, bool skip_system, LOCKMODE lockmode);
+                          char fires_when, bool skip_system, bool recurse,
+                          LOCKMODE lockmode);
 static void ATExecEnableDisableRule(Relation rel, const char *rulename,
                        char fires_when, LOCKMODE lockmode);
 static void ATPrepAddInherit(Relation child_rel);
@@ -3407,9 +3408,7 @@ AlterTableLookupRelation(AlterTableStmt *stmt, LOCKMODE lockmode)
  * expressions that need to be evaluated with respect to the old table
  * schema.
  *
- * ATRewriteCatalogs performs phase 2 for each affected table.  (Note that
- * phases 2 and 3 normally do no explicit recursion, since phase 1 already
- * did it --- although some subcommands have to recurse in phase 2 instead.)
+ * ATRewriteCatalogs performs phase 2 for each affected table.
  * Certain subcommands need to be performed before others to avoid
  * unnecessary conflicts; for example, DROP COLUMN should come before
  * ADD COLUMN.  Therefore phase 1 divides the subcommands into multiple
@@ -3417,6 +3416,12 @@ AlterTableLookupRelation(AlterTableStmt *stmt, LOCKMODE lockmode)
  *
  * ATRewriteTables performs phase 3 for those tables that need it.
  *
+ * For most subcommand types, phases 2 and 3 do no explicit recursion,
+ * since phase 1 already does it.  However, for certain subcommand types
+ * it is only possible to determine how to recurse at phase 2 time; for
+ * those cases, phase 1 sets the cmd->recurse flag (or, in some older coding,
+ * changes the command subtype of a "Recurse" variant XXX to be cleaned up.)
+ *
  * Thanks to the magic of MVCC, an error anywhere along the way rolls back
  * the whole operation; we don't have to do anything special to clean up.
  *
@@ -3791,10 +3796,10 @@ ATPrepCmd(List **wqueue, Relation rel, AlterTableCmd *cmd,
    tab = ATGetQueueEntry(wqueue, rel);
 
    /*
-    * Copy the original subcommand for each table.  This avoids conflicts
-    * when different child tables need to make different parse
-    * transformations (for example, the same column may have different column
-    * numbers in different children).
+    * Copy the original subcommand for each table, so we can scribble on it.
+    * This avoids conflicts when different child tables need to make
+    * different parse transformations (for example, the same column may have
+    * different column numbers in different children).
     */
    cmd = copyObject(cmd);
 
@@ -4038,8 +4043,9 @@ ATPrepCmd(List **wqueue, Relation rel, AlterTableCmd *cmd,
        case AT_DisableTrigAll:
        case AT_DisableTrigUser:
            ATSimplePermissions(rel, ATT_TABLE | ATT_FOREIGN_TABLE);
-           if (rel->rd_rel->relkind == RELKIND_PARTITIONED_TABLE)
-               ATSimpleRecursion(wqueue, rel, cmd, recurse, lockmode);
+           /* Set up recursion for phase 2; no other prep needed */
+           if (recurse)
+               cmd->recurse = true;
            pass = AT_PASS_MISC;
            break;
        case AT_EnableRule:     /* ENABLE/DISABLE RULE variants */
@@ -4339,35 +4345,51 @@ ATExecCmd(List **wqueue, AlteredTableInfo *tab, Relation rel,
            break;
        case AT_EnableTrig:     /* ENABLE TRIGGER name */
            ATExecEnableDisableTrigger(rel, cmd->name,
-                                      TRIGGER_FIRES_ON_ORIGIN, false, lockmode);
+                                      TRIGGER_FIRES_ON_ORIGIN, false,
+                                      cmd->recurse,
+                                      lockmode);
            break;
        case AT_EnableAlwaysTrig:   /* ENABLE ALWAYS TRIGGER name */
            ATExecEnableDisableTrigger(rel, cmd->name,
-                                      TRIGGER_FIRES_ALWAYS, false, lockmode);
+                                      TRIGGER_FIRES_ALWAYS, false,
+                                      cmd->recurse,
+                                      lockmode);
            break;
        case AT_EnableReplicaTrig:  /* ENABLE REPLICA TRIGGER name */
            ATExecEnableDisableTrigger(rel, cmd->name,
-                                      TRIGGER_FIRES_ON_REPLICA, false, lockmode);
+                                      TRIGGER_FIRES_ON_REPLICA, false,
+                                      cmd->recurse,
+                                      lockmode);
            break;
        case AT_DisableTrig:    /* DISABLE TRIGGER name */
            ATExecEnableDisableTrigger(rel, cmd->name,
-                                      TRIGGER_DISABLED, false, lockmode);
+                                      TRIGGER_DISABLED, false,
+                                      cmd->recurse,
+                                      lockmode);
            break;
        case AT_EnableTrigAll:  /* ENABLE TRIGGER ALL */
            ATExecEnableDisableTrigger(rel, NULL,
-                                      TRIGGER_FIRES_ON_ORIGIN, false, lockmode);
+                                      TRIGGER_FIRES_ON_ORIGIN, false,
+                                      cmd->recurse,
+                                      lockmode);
            break;
        case AT_DisableTrigAll: /* DISABLE TRIGGER ALL */
            ATExecEnableDisableTrigger(rel, NULL,
-                                      TRIGGER_DISABLED, false, lockmode);
+                                      TRIGGER_DISABLED, false,
+                                      cmd->recurse,
+                                      lockmode);
            break;
        case AT_EnableTrigUser: /* ENABLE TRIGGER USER */
            ATExecEnableDisableTrigger(rel, NULL,
-                                      TRIGGER_FIRES_ON_ORIGIN, true, lockmode);
+                                      TRIGGER_FIRES_ON_ORIGIN, true,
+                                      cmd->recurse,
+                                      lockmode);
            break;
        case AT_DisableTrigUser:    /* DISABLE TRIGGER USER */
            ATExecEnableDisableTrigger(rel, NULL,
-                                      TRIGGER_DISABLED, true, lockmode);
+                                      TRIGGER_DISABLED, true,
+                                      cmd->recurse,
+                                      lockmode);
            break;
 
        case AT_EnableRule:     /* ENABLE RULE name */
@@ -12325,9 +12347,11 @@ copy_relation_data(SMgrRelation src, SMgrRelation dst,
  */
 static void
 ATExecEnableDisableTrigger(Relation rel, const char *trigname,
-                          char fires_when, bool skip_system, LOCKMODE lockmode)
+                          char fires_when, bool skip_system, bool recurse,
+                          LOCKMODE lockmode)
 {
-   EnableDisableTrigger(rel, trigname, fires_when, skip_system, lockmode);
+   EnableDisableTriggerNew(rel, trigname, fires_when, skip_system, recurse,
+                           lockmode);
 }
 
 /*
index 023a9bc8b6f203f37ef334e28ea97f0bfe5b7b57..1a70ae6c4537830ef5ca8fd70ae8f39298233f08 100644 (file)
@@ -1786,14 +1786,16 @@ renametrig(RenameStmt *stmt)
  *            enablement/disablement, this also defines when the trigger
  *            should be fired in session replication roles.
  * skip_system: if true, skip "system" triggers (constraint triggers)
+ * recurse: if true, recurse to partitions
  *
  * Caller should have checked permissions for the table; here we also
  * enforce that superuser privilege is required to alter the state of
  * system triggers
  */
 void
-EnableDisableTrigger(Relation rel, const char *tgname,
-                    char fires_when, bool skip_system, LOCKMODE lockmode)
+EnableDisableTriggerNew(Relation rel, const char *tgname,
+                       char fires_when, bool skip_system, bool recurse,
+                       LOCKMODE lockmode)
 {
    Relation    tgrel;
    int         nkeys;
@@ -1859,6 +1861,34 @@ EnableDisableTrigger(Relation rel, const char *tgname,
            changed = true;
        }
 
+       /*
+        * When altering FOR EACH ROW triggers on a partitioned table, do the
+        * same on the partitions as well, unless ONLY is specified.
+        *
+        * Note that we recurse even if we didn't change the trigger above,
+        * because the partitions' copy of the trigger may have a different
+        * value of tgenabled than the parent's trigger and thus might need to
+        * be changed.
+        */
+       if (recurse &&
+           rel->rd_rel->relkind == RELKIND_PARTITIONED_TABLE &&
+           (TRIGGER_FOR_ROW(oldtrig->tgtype)))
+       {
+           PartitionDesc partdesc = RelationGetPartitionDesc(rel);
+           int         i;
+
+           for (i = 0; i < partdesc->nparts; i++)
+           {
+               Relation    part;
+
+               part = heap_open(partdesc->oids[i], lockmode);
+               EnableDisableTriggerNew(part, NameStr(oldtrig->tgname),
+                                       fires_when, skip_system, recurse,
+                                       lockmode);
+               heap_close(part, NoLock);   /* keep lock till commit */
+           }
+       }
+
        InvokeObjectPostAlterHook(TriggerRelationId,
                                  HeapTupleGetOid(tuple), 0);
    }
@@ -1882,6 +1912,19 @@ EnableDisableTrigger(Relation rel, const char *tgname,
        CacheInvalidateRelcache(rel);
 }
 
+/*
+ * ABI-compatible wrapper for the above.  To keep as close possible to the old
+ * behavior, this never recurses.  Do not call this function in new code.
+ */
+void
+EnableDisableTrigger(Relation rel, const char *tgname,
+                    char fires_when, bool skip_system,
+                    LOCKMODE lockmode)
+{
+   EnableDisableTriggerNew(rel, tgname, fires_when, skip_system,
+                           true, lockmode);
+}
+
 
 /*
  * Build trigger data to attach to the given relcache entry.
index 48bf386f190e7814c22c89498cae1478541c6194..fa9aef5c21096f62bfd064d4f560441f4854f803 100644 (file)
@@ -3150,6 +3150,7 @@ _copyAlterTableCmd(const AlterTableCmd *from)
    COPY_NODE_FIELD(def);
    COPY_SCALAR_FIELD(behavior);
    COPY_SCALAR_FIELD(missing_ok);
+   COPY_SCALAR_FIELD(recurse);
 
    return newnode;
 }
index cf5238e9e085cf8eb21c1fcd0d9102e88a41b708..d6bb67d3c141cabeca93190c8c48145159cdd91a 100644 (file)
@@ -1094,6 +1094,7 @@ _equalAlterTableCmd(const AlterTableCmd *a, const AlterTableCmd *b)
    COMPARE_NODE_FIELD(def);
    COMPARE_SCALAR_FIELD(behavior);
    COMPARE_SCALAR_FIELD(missing_ok);
+   COMPARE_SCALAR_FIELD(recurse);
 
    return true;
 }
index 8aacbf80f3aa6cc4eebdf21cca12efcb4eb69ed1..14e065b75e13490d49762c76d81c45120d21a414 100644 (file)
@@ -172,8 +172,11 @@ extern Oid get_trigger_oid(Oid relid, const char *name, bool missing_ok);
 
 extern ObjectAddress renametrig(RenameStmt *stmt);
 
+extern void EnableDisableTriggerNew(Relation rel, const char *tgname,
+                                   char fires_when, bool skip_system, bool recurse,
+                                   LOCKMODE lockmode);
 extern void EnableDisableTrigger(Relation rel, const char *tgname,
-                    char fires_when, bool skip_system, LOCKMODE lockmode);
+                                char fires_when, bool skip_system, LOCKMODE lockmode);
 
 extern void RelationBuildTriggers(Relation relation);
 
index e364f8f38683124b9f826c9c494871dd3a922d0d..520390d6ee07e60987f509d931139873f0e75bc2 100644 (file)
@@ -1816,6 +1816,7 @@ typedef struct AlterTableCmd  /* one subcommand of an ALTER TABLE */
                                 * constraint, or parent table */
    DropBehavior behavior;      /* RESTRICT or CASCADE for DROP cases */
    bool        missing_ok;     /* skip error if missing? */
+   bool        recurse;        /* exec-time recursion */
 } AlterTableCmd;
 
 
index 7efca65875e4f5ee0c2e29da17a91057ff272940..d2d95df7a58f65e8c8d9822c5b275b000258eaa0 100644 (file)
@@ -2476,24 +2476,42 @@ create table parent (a int) partition by list (a);
 create table child1 partition of parent for values in (1);
 create trigger tg after insert on parent
   for each row execute procedure trig_nothing();
+create trigger tg_stmt after insert on parent
+  for statement execute procedure trig_nothing();
 select tgrelid::regclass, tgname, tgenabled from pg_trigger
   where tgrelid in ('parent'::regclass, 'child1'::regclass)
   order by tgrelid::regclass::text;
- tgrelid | tgname | tgenabled 
----------+--------+-----------
- child1  | tg     | O
- parent  | tg     | O
-(2 rows)
+ tgrelid | tgname  | tgenabled 
+---------+---------+-----------
+ child1  | tg      | O
+ parent  | tg      | O
+ parent  | tg_stmt | O
+(3 rows)
 
-alter table only parent enable always trigger tg;
+alter table only parent enable always trigger tg;  -- no recursion because ONLY
+alter table parent enable always trigger tg_stmt;  -- no recursion because statement trigger
 select tgrelid::regclass, tgname, tgenabled from pg_trigger
   where tgrelid in ('parent'::regclass, 'child1'::regclass)
   order by tgrelid::regclass::text;
- tgrelid | tgname | tgenabled 
----------+--------+-----------
- child1  | tg     | O
- parent  | tg     | A
-(2 rows)
+ tgrelid | tgname  | tgenabled 
+---------+---------+-----------
+ child1  | tg      | O
+ parent  | tg      | A
+ parent  | tg_stmt | A
+(3 rows)
+
+-- The following is a no-op for the parent trigger but not so
+-- for the child trigger, so recursion should be applied.
+alter table parent enable always trigger tg;
+select tgrelid::regclass, tgname, tgenabled from pg_trigger
+  where tgrelid in ('parent'::regclass, 'child1'::regclass)
+  order by tgrelid::regclass::text;
+ tgrelid | tgname  | tgenabled 
+---------+---------+-----------
+ child1  | tg      | A
+ parent  | tg      | A
+ parent  | tg_stmt | A
+(3 rows)
 
 drop table parent, child1;
 -- Verify that firing state propagates correctly
index 5b2271a72795fecfd5dd8dae2edbede9c5d3466c..121b2c134285b0dfe024688576c0a35f3b886165 100644 (file)
@@ -1728,10 +1728,19 @@ create table parent (a int) partition by list (a);
 create table child1 partition of parent for values in (1);
 create trigger tg after insert on parent
   for each row execute procedure trig_nothing();
+create trigger tg_stmt after insert on parent
+  for statement execute procedure trig_nothing();
 select tgrelid::regclass, tgname, tgenabled from pg_trigger
   where tgrelid in ('parent'::regclass, 'child1'::regclass)
   order by tgrelid::regclass::text;
-alter table only parent enable always trigger tg;
+alter table only parent enable always trigger tg;  -- no recursion because ONLY
+alter table parent enable always trigger tg_stmt;  -- no recursion because statement trigger
+select tgrelid::regclass, tgname, tgenabled from pg_trigger
+  where tgrelid in ('parent'::regclass, 'child1'::regclass)
+  order by tgrelid::regclass::text;
+-- The following is a no-op for the parent trigger but not so
+-- for the child trigger, so recursion should be applied.
+alter table parent enable always trigger tg;
 select tgrelid::regclass, tgname, tgenabled from pg_trigger
   where tgrelid in ('parent'::regclass, 'child1'::regclass)
   order by tgrelid::regclass::text;