[11/15開催: PostgreSQL Conference Japan 2019 参加受付中] 
他のバージョンの文書 11 | 10 | 9.6 | 9.5 | 9.4 | 9.3 | 9.2 | 9.1 | 9.0 | 8.4 | 8.3 | 8.2 | 8.1 | 8.0 | 7.4 | 7.3 | 7.2

CREATE TRIGGER

名前

CREATE TRIGGER -- 新しいトリガの定義

概要

CREATE TRIGGER name { BEFORE | AFTER } { event [ OR ... ] }
    ON table [ FOR [ EACH ] { ROW | STATEMENT } ]
    EXECUTE PROCEDURE funcname ( arguments )

説明

CREATE TRIGGERは新しいトリガを作成します。 そのトリガは指定したテーブルと関連付けられ、特定のイベントが発生した時に指定した関数funcnameを実行します。

トリガは、行への操作が開始される前(制約条件のチェックとINSERTUPDATEまたはDELETEが行われる前)、あるいは、操作が完了した後(制約条件がチェックされ、INSERTUPDATEまたはDELETEが完了した後)のいずれでも起動を指定することができます。 イベントの前にトリガが起動すると、そのトリガは対象行に対する操作を省略することも、(INSERTUPDATEの操作時のみ)挿入された行を変更することもできます。 イベントの後にトリガが起動すると、最終の挿入、更新あるいは削除を含んだ全ての変更がトリガに"可視"となります。

FOR EACH ROW付きのトリガは、その操作によって変更される行毎に1回呼び出されます。 例えば、10行に影響を与えるDELETE操作は、対象リレーション上のON DELETEトリガを、行が削除される度に1回ずつ、独立して10回呼び出すことになります。 反対に、FOR EACH STATEMENT付きのトリガは、その操作によって何行変更されたかに関わらず、任意の操作毎に1回のみ実行されます。 (特に、0行を変更する操作でも、適用すべきFOR EACH STATEMENTトリガを実行します。)

同じ種類の複数のトリガが同一イベントに定義された場合、名前のアルファベット順で実行されます。

SELECTは行を全く変更しませんので、SELECTトリガを作成することはできません。 この場合は、ルールやビューの方がより適しています。

トリガに関するより詳細については、第32章を参照してください。

パラメータ

name

新しいトリガに付与する名前です。 この名前は、同じテーブルの他のトリガとは異なる名前にする必要があります。

BEFORE
AFTER

関数の呼び出しをイベントの前に行うか後に行うかを決定します。

event

INSERTUPDATEDELETEのいずれかです。 これは、トリガを起動するイベントを指定するものです。 ORを使用して、複数のイベントを指定することができます。

table

トリガを作成するテーブルの名前です (スキーマ修飾名でも可)。

FOR EACH ROW
FOR EACH STATEMENT

これは、トリガプロシージャの起動を、トリガイベントによって影響を受ける行毎に1回行うか、SQL文毎に1回のみ行うかを指定します。 どちらも指定されない場合は、FOR EACH STATEMENTがデフォルトです。

funcname

引数を取らず、trigger型を返す、ユーザが提供する関数であり、トリガが起動した時に実行されます。

arguments

トリガ実行時に関数に渡される引数をカンマで区切ったリストです(省略可能)。 引数は、リテラル文字列定数です。 単純な名前および数値定数もここに記述できますが、全て文字列に変換されます。 関数内でどのようにこのトリガ引数にアクセスするかについては、トリガ関数を実装した言語の説明を参照してください。 これは、通常の関数引数とは異なる場合があります。

注釈

テーブルにトリガを作成するには、ユーザはそのテーブルに対しTRIGGER権限を持つ必要があります。

PostgreSQL 7.3より前のバージョンでは、トリガ関数をtrigger型ではなくプレースホルダ用のopaque型を返すように宣言する必要がありました。 古いダンプファイルのロードをサポートするため、CREATE TRIGGERではopaque型を返すよう宣言された関数を受け入れます。 しかし、注意を促すメッセージを表示し、宣言された関数の戻り値型をtriggerに変換します。

トリガを削除するには、DROP TRIGGERコマンドを使用してください。

項32.4に完全な例があります。

互換性

PostgreSQLにおけるCREATE TRIGGER文はSQL:1999標準のサブセットを実装したものです。 (SQL-92にはトリガについての規定はありません。) 次の機能が欠落しています。

SQL:1999では、複数のトリガは、作成時刻順に起動すべきであると規定しています。 PostgreSQLでは名前順であり、その動作の判断がより簡単になっています。

ORを使用した単一トリガにおける複数の動作指定機能は、標準SQLに対する PostgreSQLの拡張です。

関連項目

CREATE FUNCTION, ALTER TRIGGER, DROP TRIGGER