37.3. 用C编写事件触发器函数

本节描述事件触发器函数接口的底层细节。只有在用C编写事件触发器函数的时候才会需要这些信息。 如果你使用一种高级语言，那么这些细节已经为你处理了。在大多数情况下， 应该在用C编写事件触发器之前考虑用过程语言。每一个过程语言的文档解释了如何用那种语言编写一个事件触发器。

事件触发器函数必须使用"version 1"函数管理接口。

当通过事件触发器管理调用一个函数的时候，并不传递任何正规参数，而是传递一个 "context"指针指向EventTriggerData结构。 C函数可以检查它们是从事件触发器管理调用还是通过执行宏：

CALLED_AS_EVENT_TRIGGER(fcinfo)

扩展到：

((fcinfo)->context != NULL && IsA((fcinfo)->context, EventTriggerData))

如果返回真，那么传递fcinfo->context到类型EventTriggerData * 是安全的，并且利用指向的EventTriggerData结构。 函数必须不改变EventTriggerData结构或它指向的任何数据。

struct EventTriggerData是在 commands/event_trigger.h里定义的：

typedef struct EventTriggerData
{
    NodeTag     type;
    const char *event;      /* event name */
    Node       *parsetree;  /* parse tree */
    const char *tag;        /* command tag */
} EventTriggerData;

成员定义如下：

一个事件触发器函数必须返回一个NULL指针（不是 SQL null值，也就是，不要设置isNull为真）。