用 C编写事件触发器函数

用 C 编写事件触发器函数

这一节描述了事件触发器函数接口的低层细节。只有在用 C 编写事件 触发器函数时才需要用到这里的信息。如果使用更高层的语言，那么这些细节已经被处理好了。在大部分情况下都应该优先考虑使用过程语言来编写你的事件触发器。每一种过程语言的文档都解释了如何用它编写事件触发器。

事件触发器函数必须使用“版本1”的函数管理器接口。

当一个函数被事件触发器管理器调用时，向它传递的并不是普通参数， 而是一个指向EventTriggerData结构的“context”指针。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;      /* 事件名称 */
    Node       *parsetree;  /* 解析树 */
    const char *tag;        /* 命令标签 */
} EventTriggerData;

其中的成员定义如下：

type

总是T_EventTriggerData。

event

描述要为其调用这个函数的事件，可以是 "ddl_command_start"、"ddl_command_end"、 "sql_drop"、"table_rewrite"之一。这些事件的含义请见事件触发器行为总览。

parsetree

该命令的解析树的指针。其细节可以参考 SeaboxSQL 的源代码。 解析树结构可能会在未经通知的情况下改变。

tag

与事件触发器的事件相关联的命令标签，例如 "CREATE FUNCTION"。

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