1997-08-31 13:42:21 +02:00
|
|
|
/*-------------------------------------------------------------------------
|
|
|
|
*
|
1999-02-14 00:22:53 +01:00
|
|
|
* trigger.h
|
2000-05-29 03:59:17 +02:00
|
|
|
* Declarations for trigger handling.
|
1997-08-31 13:42:21 +02:00
|
|
|
*
|
2007-01-05 23:20:05 +01:00
|
|
|
* Portions Copyright (c) 1996-2007, PostgreSQL Global Development Group
|
2000-01-31 05:35:57 +01:00
|
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
|
|
|
*
|
2007-11-30 22:22:54 +01:00
|
|
|
* $PostgreSQL: pgsql/src/include/commands/trigger.h,v 1.64 2007/11/30 21:22:54 tgl Exp $
|
1997-08-31 13:42:21 +02:00
|
|
|
*
|
|
|
|
*-------------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
#ifndef TRIGGER_H
|
|
|
|
#define TRIGGER_H
|
|
|
|
|
1998-12-15 13:47:01 +01:00
|
|
|
#include "nodes/execnodes.h"
|
1999-07-16 19:07:40 +02:00
|
|
|
#include "nodes/parsenodes.h"
|
1997-09-01 10:10:12 +02:00
|
|
|
|
2000-05-29 03:59:17 +02:00
|
|
|
/*
|
|
|
|
* TriggerData is the node type that is passed as fmgr "context" info
|
|
|
|
* when a function is called by the trigger manager.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#define CALLED_AS_TRIGGER(fcinfo) \
|
|
|
|
((fcinfo)->context != NULL && IsA((fcinfo)->context, TriggerData))
|
|
|
|
|
1997-09-08 04:41:22 +02:00
|
|
|
typedef uint32 TriggerEvent;
|
1997-09-01 10:10:12 +02:00
|
|
|
|
1997-09-07 07:04:48 +02:00
|
|
|
typedef struct TriggerData
|
|
|
|
{
|
2000-05-29 03:59:17 +02:00
|
|
|
NodeTag type;
|
1997-09-08 04:41:22 +02:00
|
|
|
TriggerEvent tg_event;
|
|
|
|
Relation tg_relation;
|
|
|
|
HeapTuple tg_trigtuple;
|
|
|
|
HeapTuple tg_newtuple;
|
|
|
|
Trigger *tg_trigger;
|
2004-10-30 22:53:06 +02:00
|
|
|
Buffer tg_trigtuplebuf;
|
|
|
|
Buffer tg_newtuplebuf;
|
1998-02-26 05:46:47 +01:00
|
|
|
} TriggerData;
|
1997-09-01 10:10:12 +02:00
|
|
|
|
2000-05-29 03:59:17 +02:00
|
|
|
/* TriggerEvent bit flags */
|
1997-09-01 10:10:12 +02:00
|
|
|
|
1997-09-07 07:04:48 +02:00
|
|
|
#define TRIGGER_EVENT_INSERT 0x00000000
|
|
|
|
#define TRIGGER_EVENT_DELETE 0x00000001
|
|
|
|
#define TRIGGER_EVENT_UPDATE 0x00000002
|
|
|
|
#define TRIGGER_EVENT_OPMASK 0x00000003
|
|
|
|
#define TRIGGER_EVENT_ROW 0x00000004
|
|
|
|
#define TRIGGER_EVENT_BEFORE 0x00000008
|
1997-09-01 10:10:12 +02:00
|
|
|
|
2004-09-10 20:40:09 +02:00
|
|
|
/* More TriggerEvent flags, used only within trigger.c */
|
|
|
|
|
|
|
|
#define AFTER_TRIGGER_DONE 0x00000010
|
|
|
|
#define AFTER_TRIGGER_IN_PROGRESS 0x00000020
|
|
|
|
#define AFTER_TRIGGER_DEFERRABLE 0x00000040
|
|
|
|
#define AFTER_TRIGGER_INITDEFERRED 0x00000080
|
1999-09-29 18:06:40 +02:00
|
|
|
|
1997-09-04 15:26:19 +02:00
|
|
|
#define TRIGGER_FIRED_BY_INSERT(event) \
|
1997-09-07 07:04:48 +02:00
|
|
|
(((TriggerEvent) (event) & TRIGGER_EVENT_OPMASK) == \
|
|
|
|
TRIGGER_EVENT_INSERT)
|
1997-09-01 10:10:12 +02:00
|
|
|
|
1997-09-04 15:26:19 +02:00
|
|
|
#define TRIGGER_FIRED_BY_DELETE(event) \
|
1997-09-07 07:04:48 +02:00
|
|
|
(((TriggerEvent) (event) & TRIGGER_EVENT_OPMASK) == \
|
|
|
|
TRIGGER_EVENT_DELETE)
|
1997-09-01 10:10:12 +02:00
|
|
|
|
1997-09-04 15:26:19 +02:00
|
|
|
#define TRIGGER_FIRED_BY_UPDATE(event) \
|
1997-09-07 07:04:48 +02:00
|
|
|
(((TriggerEvent) (event) & TRIGGER_EVENT_OPMASK) == \
|
|
|
|
TRIGGER_EVENT_UPDATE)
|
1997-09-04 15:26:19 +02:00
|
|
|
|
1997-09-07 07:04:48 +02:00
|
|
|
#define TRIGGER_FIRED_FOR_ROW(event) \
|
|
|
|
((TriggerEvent) (event) & TRIGGER_EVENT_ROW)
|
1997-09-04 15:26:19 +02:00
|
|
|
|
1997-09-07 07:04:48 +02:00
|
|
|
#define TRIGGER_FIRED_FOR_STATEMENT(event) \
|
|
|
|
(!TRIGGER_FIRED_FOR_ROW (event))
|
1997-09-04 15:26:19 +02:00
|
|
|
|
1997-09-07 07:04:48 +02:00
|
|
|
#define TRIGGER_FIRED_BEFORE(event) \
|
|
|
|
((TriggerEvent) (event) & TRIGGER_EVENT_BEFORE)
|
1997-09-04 15:26:19 +02:00
|
|
|
|
1997-09-07 07:04:48 +02:00
|
|
|
#define TRIGGER_FIRED_AFTER(event) \
|
|
|
|
(!TRIGGER_FIRED_BEFORE (event))
|
1997-09-01 10:10:12 +02:00
|
|
|
|
2007-03-20 00:38:32 +01:00
|
|
|
/*
|
|
|
|
* Definitions for the replication role based firing.
|
|
|
|
*/
|
|
|
|
#define SESSION_REPLICATION_ROLE_ORIGIN 0
|
|
|
|
#define SESSION_REPLICATION_ROLE_REPLICA 1
|
|
|
|
#define SESSION_REPLICATION_ROLE_LOCAL 2
|
|
|
|
extern int SessionReplicationRole;
|
|
|
|
|
2007-11-15 22:14:46 +01:00
|
|
|
#define TRIGGER_FIRES_ON_ORIGIN 'O'
|
|
|
|
#define TRIGGER_FIRES_ALWAYS 'A'
|
|
|
|
#define TRIGGER_FIRES_ON_REPLICA 'R'
|
|
|
|
#define TRIGGER_DISABLED 'D'
|
1997-09-01 10:10:12 +02:00
|
|
|
|
2007-02-14 02:58:58 +01:00
|
|
|
extern Oid CreateTrigger(CreateTrigStmt *stmt, Oid constraintOid);
|
2002-07-12 20:43:19 +02:00
|
|
|
|
|
|
|
extern void DropTrigger(Oid relid, const char *trigname,
|
2006-06-16 22:23:45 +02:00
|
|
|
DropBehavior behavior, bool missing_ok);
|
2002-07-12 20:43:19 +02:00
|
|
|
extern void RemoveTriggerById(Oid trigOid);
|
1997-08-31 13:42:21 +02:00
|
|
|
|
2002-04-26 21:29:47 +02:00
|
|
|
extern void renametrig(Oid relid, const char *oldname, const char *newname);
|
|
|
|
|
2005-08-24 00:40:47 +02:00
|
|
|
extern void EnableDisableTrigger(Relation rel, const char *tgname,
|
2007-03-20 00:38:32 +01:00
|
|
|
char fires_when, bool skip_system);
|
2005-08-24 00:40:47 +02:00
|
|
|
|
2000-01-31 05:35:57 +01:00
|
|
|
extern void RelationBuildTriggers(Relation relation);
|
|
|
|
|
2002-10-14 18:51:30 +02:00
|
|
|
extern TriggerDesc *CopyTriggerDesc(TriggerDesc *trigdesc);
|
2000-01-31 05:35:57 +01:00
|
|
|
|
2002-10-14 18:51:30 +02:00
|
|
|
extern void FreeTriggerDesc(TriggerDesc *trigdesc);
|
2000-01-31 05:35:57 +01:00
|
|
|
|
2002-11-23 04:59:09 +01:00
|
|
|
extern void ExecBSInsertTriggers(EState *estate,
|
2003-08-04 02:43:34 +02:00
|
|
|
ResultRelInfo *relinfo);
|
2002-11-23 04:59:09 +01:00
|
|
|
extern void ExecASInsertTriggers(EState *estate,
|
2003-08-04 02:43:34 +02:00
|
|
|
ResultRelInfo *relinfo);
|
2001-01-22 01:50:07 +01:00
|
|
|
extern HeapTuple ExecBRInsertTriggers(EState *estate,
|
2001-10-25 07:50:21 +02:00
|
|
|
ResultRelInfo *relinfo,
|
|
|
|
HeapTuple trigtuple);
|
2001-01-22 01:50:07 +01:00
|
|
|
extern void ExecARInsertTriggers(EState *estate,
|
2001-10-25 07:50:21 +02:00
|
|
|
ResultRelInfo *relinfo,
|
|
|
|
HeapTuple trigtuple);
|
2002-11-23 04:59:09 +01:00
|
|
|
extern void ExecBSDeleteTriggers(EState *estate,
|
2003-08-04 02:43:34 +02:00
|
|
|
ResultRelInfo *relinfo);
|
2002-11-23 04:59:09 +01:00
|
|
|
extern void ExecASDeleteTriggers(EState *estate,
|
2003-08-04 02:43:34 +02:00
|
|
|
ResultRelInfo *relinfo);
|
2001-06-01 04:41:36 +02:00
|
|
|
extern bool ExecBRDeleteTriggers(EState *estate,
|
2003-08-04 02:43:34 +02:00
|
|
|
ResultRelInfo *relinfo,
|
2007-11-30 22:22:54 +01:00
|
|
|
ItemPointer tupleid);
|
2001-06-01 04:41:36 +02:00
|
|
|
extern void ExecARDeleteTriggers(EState *estate,
|
2001-10-25 07:50:21 +02:00
|
|
|
ResultRelInfo *relinfo,
|
|
|
|
ItemPointer tupleid);
|
2002-11-23 04:59:09 +01:00
|
|
|
extern void ExecBSUpdateTriggers(EState *estate,
|
2003-08-04 02:43:34 +02:00
|
|
|
ResultRelInfo *relinfo);
|
2002-11-23 04:59:09 +01:00
|
|
|
extern void ExecASUpdateTriggers(EState *estate,
|
2003-08-04 02:43:34 +02:00
|
|
|
ResultRelInfo *relinfo);
|
2001-06-01 04:41:36 +02:00
|
|
|
extern HeapTuple ExecBRUpdateTriggers(EState *estate,
|
2003-08-04 02:43:34 +02:00
|
|
|
ResultRelInfo *relinfo,
|
|
|
|
ItemPointer tupleid,
|
2007-11-30 22:22:54 +01:00
|
|
|
HeapTuple newtuple);
|
2001-06-01 04:41:36 +02:00
|
|
|
extern void ExecARUpdateTriggers(EState *estate,
|
2001-10-25 07:50:21 +02:00
|
|
|
ResultRelInfo *relinfo,
|
|
|
|
ItemPointer tupleid,
|
|
|
|
HeapTuple newtuple);
|
1999-09-29 18:06:40 +02:00
|
|
|
|
2004-09-10 20:40:09 +02:00
|
|
|
extern void AfterTriggerBeginXact(void);
|
|
|
|
extern void AfterTriggerBeginQuery(void);
|
2005-03-25 22:58:00 +01:00
|
|
|
extern void AfterTriggerEndQuery(EState *estate);
|
2005-04-11 21:51:16 +02:00
|
|
|
extern void AfterTriggerFireDeferred(void);
|
|
|
|
extern void AfterTriggerEndXact(bool isCommit);
|
2004-09-10 20:40:09 +02:00
|
|
|
extern void AfterTriggerBeginSubXact(void);
|
|
|
|
extern void AfterTriggerEndSubXact(bool isCommit);
|
|
|
|
extern void AfterTriggerSetState(ConstraintsSetStmt *stmt);
|
2006-09-04 23:15:56 +02:00
|
|
|
extern void AfterTriggerCheckTruncate(List *relids);
|
1999-09-29 18:06:40 +02:00
|
|
|
|
|
|
|
|
2000-01-06 21:47:01 +01:00
|
|
|
/*
|
|
|
|
* in utils/adt/ri_triggers.c
|
|
|
|
*/
|
2005-05-30 09:20:59 +02:00
|
|
|
extern bool RI_FKey_keyequal_upd_pk(Trigger *trigger, Relation pk_rel,
|
2005-10-15 04:49:52 +02:00
|
|
|
HeapTuple old_row, HeapTuple new_row);
|
2005-05-30 09:20:59 +02:00
|
|
|
extern bool RI_FKey_keyequal_upd_fk(Trigger *trigger, Relation fk_rel,
|
2005-10-15 04:49:52 +02:00
|
|
|
HeapTuple old_row, HeapTuple new_row);
|
2007-02-14 02:58:58 +01:00
|
|
|
extern bool RI_Initial_Check(Trigger *trigger,
|
2007-11-15 22:14:46 +01:00
|
|
|
Relation fk_rel, Relation pk_rel);
|
2001-10-28 07:26:15 +01:00
|
|
|
|
2007-02-14 02:58:58 +01:00
|
|
|
/* result values for RI_FKey_trigger_type: */
|
2005-05-30 09:20:59 +02:00
|
|
|
#define RI_TRIGGER_PK 1 /* is a trigger on the PK relation */
|
|
|
|
#define RI_TRIGGER_FK 2 /* is a trigger on the FK relation */
|
|
|
|
#define RI_TRIGGER_NONE 0 /* is not an RI trigger function */
|
|
|
|
|
2005-10-15 04:49:52 +02:00
|
|
|
extern int RI_FKey_trigger_type(Oid tgfoid);
|
2005-05-30 09:20:59 +02:00
|
|
|
|
2001-11-05 18:46:40 +01:00
|
|
|
#endif /* TRIGGER_H */
|