| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 34. 트리거 | Fast Forward | Next |
본절에서는 트리거 함수와의 인터페이스에 대해 저레벨의 상세정보를 설명합니다. 이 정보는 C언어로 트리거 함수를 작성할 때에게만 필요합니다. 고레벨인 언어로 작성하면, 이러한 자세한 상세정보는 당신을 위해 취급될 것 입니다. 대부분의 경우, C로 트리거를 작성하기 전에 절차상의 언어를 사용하는 것을 검토해야 합니다. 각 문서화된 절차상 언어는 그 언어를 사용한 트리거 언어의 작성 방법을 설명합니다.
트리거 함수는"version 1"함수 매니저 인터페이스를 사용하지 않으면 안됩니다.
함수가 트리거 매니저로부터 불려 갈 때는, 통상 인수가 건네받는 것이 아니라, TriggerData구조체를 가리키는"context"포인터가 건네받습니다. C함수는, 트리거 매니저로부터 불려 갔는지 어떤지를 이하의 매크로를 실행하는 것으로 검사할 수가 있습니다.
CALLED_AS_TRIGGER(fcinfo)
이것은 이하에 전개됩니다.
((fcinfo)->context != NULL && IsA((fcinfo)->context, TriggerData))
만약 이것이 true값을 돌려주는 경우,fcinfo->context를TriggerData *타입에 캐스트 해, 가리켜진TriggerData구조를 사용하는 것은 안전합니다. 그 함수는,TriggerData구조나 그것이 가리키는 어떠한 데이터도 변경해서는 안됩니다 .
struct TriggerData는commands/trigger.h안에서 정의되고 있습니다.
typedef struct TriggerData
{
NodeTag type;
TriggerEvent tg_event;
Relation tg_relation;
HeapTuple tg_trigtuple;
HeapTuple tg_newtuple;
Trigger *tg_trigger;
Buffer tg_trigtuplebuf;
Buffer tg_newtuplebuf;
} TriggerData;
멤버는 아래와 같이 정의되고 있습니다.
항상T_TriggerData입니다.
그 함수가 불려 간 이벤트를 설명합니다. tg_event를 조사하기 위해서 아래와 같은 매크로를 사용할 수 있습니다.
트리거가 BEFORE로 발행되었을 경우 true값을 돌려줍니다.
트리거가 AFTER로 발행되었을 경우 true값을 돌려줍니다.
트리거가 행 수준의 이벤트로 발행되었을 경우 true값을 돌려줍니다.
트리거가 문장 수준의 이벤트로 발행되었을 경우 true값을 돌려줍니다.
트리거가INSERT명령으로 발행되었을 경우 true값을 돌려줍니다.
트리거가UPDATE명령으로 발행되었을 경우 true값을 돌려줍니다.
트리거가DELETE명령으로 발행되었을 경우 true 값을 돌려줍니다.
트리거가 생성된 관계를 기술하는 구조의 포인터입니다. 이 구조에 대한 자세한 것은,utils/rel.h를 참조해 주세요. 가장 흥미로운 것은,tg_relation->rd_att(관계 튜플에 대한 기술자)과tg_relation->rd_rel->relname입니다(관계명, 이 타입은 char*이 아니고NameData입니다. 이름을 복사할 경우는,char*를 얻기 위해서SPI_getrelname(tg_relation)를 사용해 주세요).
트리거가 생성된 행의 포인터입니다. 이것은 삽입, 삭제, 혹은 갱신되는 행입니다. 만약INSERT/DELETE로 이 트리거가 생성되었을 때, 이 행을 다른 것으로 대체하고 싶지 않은(INSERT의 경우) 경우나, 그 행을 생략하고 싶지 않은 경우는, 이것을 이 함수로부터 반환해주세요.
트리거가UPDATE로 생성되었을 경우는, 그 행의 새로운 버전의 포인터입니다. INSERT혹은DELETE의 경우는,NULL입니다. UPDATE이벤트 때, 이 행을 다른 것으로 대체하고 싶지 않은 경우나 생략하고 싶지 않은경우는, 이것을 이 함수로부터 반환해주세요.
이하와 같이utils/rel.h로 정의된,Trigger구조의 포인터입니다.
typedef struct Trigger
{
Oid tgoid;
char *tgname;
Oid tgfoid;
int16 tgtype;
bool tgenabled;
bool tgisconstraint;
Oid tgconstrrelid;
bool tgdeferrable;
bool tginitdeferred;
int16 tgnargs;
int16 tgnattr;
int16 *tgattr;
char **tgargs;
} Trigger;
여기서,tgname가 트리거의 이름,tgnargs가tgargs내의 인수의 수, tgargs는CREATE TRIGGER문으로 지정된 인수에 있는 포인터의 배열입니다. 다른 멤버는 내부에서만 사용됩니다.
tg_trigtuple를 포함한 버퍼입니다. 그러한 튜플이 존재하지 않는 경우나 디스크 버퍼내에 저장되어 있지 않은 경우는InvalidBuffer입니다.
tg_newtuple를 포함한 버퍼입니다. 그러한 튜플이 존재하지 않는 경우나 디스크 버퍼내에 저장되어 있지 않은 경우는InvalidBuffer입니다.
트리거 함수는 반드시 HeapTuple 포인터나 NULL 포인터( SQL Null 값이 아닙니다 . 즉, isNull을 true값으로 정하지 마세요.)를 반환해야 합니다. 조작 대상의 행을 변경하고 싶지 않은 경우는, tg_trigtuple나tg_newtuple을 적절하게 돌려주세요.