This section describes the low-level details of the interface to an event trigger function. This information is only needed when writing event trigger functions in C. If you are using a higher-level language then these details are handled for you. In most cases you should consider using a procedural language before writing your event triggers in C. The documentation of each procedural language explains how to write an event trigger in that language. 本節ではトリガ関数とのインタフェースについて低レベルな詳細を説明します。 この情報はC言語でトリガ関数を作成する時にのみ必要です。 高レベルな言語で作成すれば、こうした詳細は代わりに扱ってもらえます。 たいていの場合、Cでトリガを作成する前に手続き言語を使用することを検討すべきです。 各手続き言語の文書で、その言語を使用したイベントトリガの作成方法を説明します。

Event trigger functions must use the <quote>version 1</quote> function manager interface. トリガ関数は「version 1」関数マネージャインタフェースを使わなくてはいけません。

When a function is called by the event trigger manager, it is not passed any normal arguments, but it is passed a <quote>context</quote> pointer pointing to a <structname>EventTriggerData</structname> structure. C functions can check whether they were called from the event trigger manager or not by executing the macro: 関数がイベントトリガマネージャから呼び出される時は、通常の引数が渡されるのではなく、EventTriggerData構造体を指す「context」ポインタが渡されます。 C関数は、イベントトリガマネージャから呼び出されたのかどうかを以下のマクロを実行することで検査することができます。

CALLED_AS_EVENT_TRIGGER(fcinfo)

which expands to: これは以下に展開されます。

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

If this returns true, then it is safe to cast <literal>fcinfo-&gt;context</literal> to type <literal>EventTriggerData *</literal> and make use of the pointed-to <structname>EventTriggerData</structname> structure. The function must <emphasis>not</emphasis> alter the <structname>EventTriggerData</structname> structure or any of the data it points to. もしこれが真を返す場合、fcinfo->contextをEventTriggerData *型にキャストし、指されたEventTriggerData構造体を使用することは安全です。 その関数は、TriggerData構造体やそれが指すどのようなデータも変更してはいけません。

<structname>struct EventTriggerData</structname> is defined in <filename>commands/event_trigger.h</filename>: struct EventTriggerDataはcommands/event_trigger.hの中で定義されています。

typedef struct EventTriggerData
{
    NodeTag     type;

    const char *event;      /* event name */
    Node       *parsetree;  /* parse tree */
    CommandTag  tag;        /* command tag */

    const char *event;      /* イベント名 */
    Node       *parsetree;  /* 解析ツリー */
    CommandTag  tag;        /* コマンドタグ */
} EventTriggerData;

where the members are defined as follows: メンバは下記のように定義されています。

An event trigger function must return a <symbol>NULL</symbol> pointer (<emphasis>not</emphasis> an SQL null value, that is, do not set <parameter>isNull</parameter> true). イベントトリガ関数はNULLポインタ（SQLのNULLではありません。したがって、isNullは真にはなりません）を返さなければなりません。