CREATE TRIGGER

name	作成するトリガの名前。識別子です。トリガ名は修飾、未修飾のどちらでもかまいません。修飾する場合は、そのスキーマ名はテーブルのスキーマ名と同じである必要があります。
BEFORE event AFTER event	トリガ・イベントのタイミング (BEFORE または AFTER) とタイプ。指定できる event オプションは、INSERT、DELETE、UPDATE、および UPDATE OF です。UPDATE OF 節の後には、列名またはコンマで区切られた列名のリストが続きます。UPDATE OF 節は、LANGUAGE が SQL の場合にのみ指定できます。
ORDER integer	オプション — テーブルに、同じタイミングおよびイベントに対して複数のトリガが存在する場合にトリガを引き出す順番。順番の指定を省略したトリガには、順番 0 が割り当てられます。
ON table	トリガが作成されるテーブル。テーブル名は修飾、未修飾のどちらでもかまいません。修飾する場合は、トリガがテーブルと同じスキーマにある必要があります。
REFERENCING OLD ROW AS alias REFERENCING NEW ROW AS alias	オプション — REFERENCING OLD ROW を指定すると、UPDATE または DELETE トリガの実行中に、列の元の値を参照できます。REFERENCING NEW ROW を指定すると、INSERT または UPDATE トリガの実行中に、列の新しい値を参照できます。REFERENCING 節は、LANGUAGE が SQL の場合にのみ使用できます。
action	トリガのプログラム・コード。LANGUAGE SQL または LANGUAGE OBJECTSCRIPT (Caché ObjectScript) キーワード節を使用して、action の先頭にプログラム言語を指定します。LANGUAGE 節を省略する場合は、SQL が既定です。

CREATE TRIGGER コマンドはトリガを作成します。トリガは、指定されたテーブルに新しい行が挿入されるなどのトリガ・イベントが発生したときに引き出されます (実行されます)。トリガの起動で、ユーザ指定のトリガ・コードが、INSERT、DELETE、または UPDATE コマンドと連動して実行されます。トリガ・コードの実行は、起動アクションの実行の前後どちらにも指定できます。トリガは指定したテーブルおよび指定した INSERT、DELETE、または UPDATE の動作により異なります。

CREATE TRIGGER コマンドの実行には特権が必要です。CREATE TRIGGER を使用する前に、%CREATE_TRIGGER 特権を得る必要があります。この設定を行わないと、SQLCODE -99 (特権違反) になります。適切な付与特権を持っていれば、GRANT コマンドを使用して、%CREATE_TRIGGER 特権を割り当てることができます。埋め込み SQL では、以下のように $SYSTEM.Security.Login メソッドを使用して適切な特権を持ったユーザとしてログインできます。

トリガ名にはテーブル名と同様の識別子要件があります。しかし一意性の要件は異なります。トリガ名はスキーマ内のテーブルに対して一意である必要があります。したがって、スキーマ内の異なるテーブルを参照しているトリガの名前が同じ場合もあります。トリガとそのトリガが関連するテーブルは同じスキーマ内に存在している必要があります。同じスキーマ内では、トリガとテーブルに同じ名前を使用できません。トリガの名前付け規約に違反すると、CREATE TRIGGER の実行時に SQLCODE -400 エラーが発生します。

トリガ名が未修飾の場合、トリガ・スキーマ名は既定で table のスキーマと同じになります。どちらも未修飾であれば、システムの既定スキーマが使用されます。トリガ名を修飾する場合は、トリガ・スキーマ名をテーブル・スキーマ名と同じにする必要があります。テーブル・スキーマ名が指定されていない場合は、トリガ・スキーマ名が使用されます。スキーマ名が一致しないと SQLCODE -366 エラーになります。これはトリガ名とテーブル名の両方が修飾されていて、異なるスキーマ名を指定しているときにのみ起こります。

Caché はトリガ名 (SQLNAME) を使用して、対応する Caché 識別子を生成します。Caché 識別子には英数字 (文字および数字) のみが使用され、その長さは最大 25 文字です。この Caché 識別子名を生成するために、Caché は最初にトリガ名から句読点を削除し、次に 25 文字 (未満) の一意の識別子を生成します。その際、トリガ名の一意性を維持するために、必要に応じて最後の文字を数字に置き換えます。トリガの名前を付ける際には、この名前生成に伴う以下の制約について考慮する必要があります。

INSERT として指定されたトリガは、指定されたテーブルに行が挿入されたときに引き出されます (実行されます)。DELETE として指定されたトリガは、指定されたテーブルから行が削除されたときに引き出されます。UPDATE として指定されたトリガは、指定されたテーブルの行が更新されたときに引き出されます。

UPDATE OF として指定されたトリガは、指定されたテーブルの行で 1 つ以上の指定された列が更新されたときにのみ、引き出されます。列名はコンマ区切りのリストで指定します。列名は任意の順序で指定できますが、重複して使用することはできません。重複していると、コンパイル時に SQLCODE -58 エラーが発生します。UPDATE OF 節はトリガ・コード LANGUAGE が SQL (既定) の場合のみ有効です。

BEFORE トリガが引き出される (実行される) のは、指定した event の実行前ですが、event の検証よりも後です。例えば、DELETE 文が指定の行に対して有効で、DELETE の実行 (外部キー参照の整合性チェックも含む) に必要な特権がプロセスに与えられている場合にのみ、BEFORE DELETE トリガが引き出されます。プロセスが指定の event を実行できない場合、event に対してエラー・コードが発行され、BEFORE トリガは引き出されません。

ORDER 節は、1 つのテーブルに同じタイミングとイベントを持つトリガが複数あるときに、トリガが引き出される順番を決定します。例えば、2 つの AFTER DELETE トリガのような場合です。ORDER の整数値が最小のトリガが最初に実行され、その後は、次に高い整数値を持つトリガが順次実行されます。ORDER 節が指定されない場合は、ORDER 値に 0 (ゼロ) が割り当てられてトリガが生成されます。したがって、ORDER 節を持たないトリガは、必ず ORDER 節を持つトリガの前に実行されます。

REFERENCING 節では、行の元の値、新しい値、またはその両方に対してエイリアスを指定できます。元の値とは、UPDATE または DELETE トリガのトリガ動作が実行される前の行の値のことです。新しい値とは、UPDATE または INSERT トリガのトリガ動作が実行された後の行の値のことです。UPDATE トリガの場合は、以下のようにして、元の行値と新しい値の両方にエイリアスを指定できます。

LANGUAGE SQL の場合、既定でトリガ文は SQL プロシージャ・ブロックです。SQL プロシージャ・ブロックは、1 つの SQL プロシージャ文とその後のセミコロン、またはキーワード BEGIN で始まりキーワード END で終わる 1 つ以上の SQL プロシージャ文と各文の後のセミコロンから成ります。

LANGUAGE SQL の場合、CREATE TRIGGER 文はオプションで REFERENCING 節、WHEN 節、および/または UPDATE OF 節を含むことができます。UPDATE OF 節は、トリガに指定された 1 つ以上の列で UPDATE が実行されるときにのみ、トリガを実行することを指定します。LANGUAGE OBJECTSCRIPT の CREATE TRIGGER 文では、これらの節を含むことができません。

SQL トリガ・コードは埋め込み SQL として実行されます。Caché は自動的に、トリガ・コード内で使用されているすべての変数をリセット (NEW) します。各 SQL 文の実行後に、Caché は SQLCODE をチェックします。エラーが発生すると、Caché は %ok 変数に 0 をセットし、トリガ・コードの処理および関連する INSERT、UPDATE、または DELETE を中止してロールバックします。

LANGUAGE OBJECTSCRIPT の場合、トリガ文は、中括弧で囲まれた 1 つ以上の Caché ObjectScript 文からなるブロックです。こうしたトリガ・コードでラベルを指定するには、ラベル行の先頭にコロンを付けて、その行が最初の列で始まることを示します。Caché はコロンを削除して、残りの行をラベルとして処理します。

Note:

ラベル用のコロン接頭語の使用は、ホスト変数参照用のコロン接頭語の使用よりも優先されます。この競合を回避するために、埋め込み SQL トリガ・コード行の先頭にホスト変数参照を記述しないことをお勧めします。トリガ・コード行の先頭にホスト変数参照を記述する必要がある場合は、二重のコロン接頭語を使用することで、それがホスト変数でありラベルでないことを明示してください。

Caché ObjectScript で記述するトリガ・コードには、{fieldname} で指定するフィールド参照を含めることができます。ここで、fieldname は現在のテーブルの既存フィールドを指定します。中括弧内に空白スペースは許可されません。現在のフィールドは、{*} のようにアスタリスクを使用して指定できます。UPDATE トリガ・コードでは、fieldname の後に *N、*O、または *C を続けることで、変更フィールドのデータ値の処理方法を指定できます。{fieldname*N} は、指定された変更が実行された後の新しいフィールド値を返します。これが既定です。{fieldname*O} は、指定された変更が実行される前の元のフィールド値を返します。{fieldname*C} は、フィールド値が変更されたかどうかを示すブーリアン値 (変更の場合は 1、未変更の場合は 0) を返します。

また、Caché ObjectScript で記述するトリガ・コードには、擬似フィールド参照変数の {%%CLASSNAME}、{%%CLASSNAMEQ}、{%%TABLENAME}、および {%%ID} を含めることもできます。擬似フィールドは、クラスのコンパイル時に特定の値に変換されます。{%%CLASSNAME} と {%%CLASSNAMEQ} は、ともに SQL テーブル定義を投影するクラスの名前に変換されます。{%%CLASSNAME} は引用符なし文字列を返し、{%%CLASSNAMEQ} は引用符付き文字列を返します。{%%TABLENAME} はテーブルの完全修飾名に変換され、引用符付き文字列を返します。{%%ID} は RowID 名に変換されます。この参照は、RowID フィールドの名前がわからないときに有用です。これらの擬似フィールド・キーワードは、すべて大文字と小文字が区別されません。

致命的なランタイム・エラーによってデータベース操作が失敗すると、Caché は SQLCODE -415 エラーを発行します。トリガ処理が失敗すると、Caché は失敗したトリガのタイプにより SQLCODE エラー・コードの -130 から -135 のうちの 1 つを発行します。トリガ・コード内で %ok 変数を 0 に設定することで、トリガを失敗させることができます。また、%msg 変数にトリガの失敗時に返すメッセージを含む文字列を設定することもできます。

  DO $SYSTEM.Security.Login("_SYSTEM","SYS")
  &sql(CREATE TABLE TestDummy (
     TESTNUM     INT NOT NULL,
     FIRSTWORD   CHAR (30) NOT NULL,
     LASTWORD    CHAR (30) NOT NULL,
     CONSTRAINT TestDummyPK PRIMARY KEY (TESTNUM))
  )
  WRITE !,"SQL table code is: ",SQLCODE
  &sql(CREATE TRIGGER TrigTestDummy AFTER INSERT ON TestDummy
  BEGIN
    INSERT INTO LogFile VALUES ('INSERT into TestDummy');
  END)
  WRITE !,"SQL trigger code is: ",SQLCODE

CREATE TRIGGER Trigger_1 AFTER INSERT ON Table_1
  REFERENCING NEW ROW AS new_row
  BEGIN
    INSERT INTO Log_Table VALUES ('INSERT into Table_1');
    INSERT INTO New_Log_Table VALUES 
      ('INSERT into Table_1', new_row.ID);
  END