CREATE TRIGGER

特権とロック

CREATE TRIGGER コマンドの実行には特権が必要です。CREATE TRIGGER を使用する前に、%CREATE_TRIGGER 特権を得る必要があります。特権がない場合は、SQLCODE -99 エラー (特権違反) が返されます。適切な付与特権を持っていれば、GRANT コマンドを使用して、%CREATE_TRIGGER 特権を割り当てることができます。

埋め込み SQL では、以下のように $SYSTEM.Security.Login()Opens in a new tab メソッドを使用して適切な特権を持ったユーザとしてログインできます。

   DO $SYSTEM.Security.Login("_SYSTEM","SYS")
   &sql(      )

$SYSTEM.Security.Login メソッドを呼び出すには、%Service_Login:Use 特権が必要です。詳細は、"インターシステムズ・クラス・リファレンス" の "%SYSTEM.SecurityOpens in a new tab" を参照してください。

CREATE TRIGGER は、テーブル・クラスの定義に [DdlAllowed] が含まれている場合を除き、永続クラスを定義して作成したテーブルでは使用できません。使用すると、操作は SQLCODE -300 エラーで失敗し、%msg が“DDL がクラス schema.tablename に対して有効になっていません”に設定されます。

CREATE TRIGGER 文は table に対してテーブル・レベルのロックを取得します。これにより、他のプロセスはこのテーブルのデータを変更できなくなります。このロックは CREATE TRIGGER 処理が終了すると自動的に解除されます。

その他のトリガ定義方法

FOREACH = ROW/OBJECT 文を組み込むことで、SQL トリガを Caché オブジェクトとして定義できます。以下はオブジェクト・トリガの例です。

Trigger SQLJournal [ CodeMode = objectgenerator, Event = INSERT/UPDATE, ForEach = ROW/OBJECT, Time = AFTER ]
{  /* ObjectScript trigger code
      that updates a journal file
      after a row is inserted or updated. */
}

trigname

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

トリガ名は、修飾、未修飾のどちらでもかまいません。修飾されたトリガ名は次のようになります。

schema.trigger

event

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

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

トリガ起動のタイミングは、BEFORE キーワードまたは AFTER キーワードで指定します。これらのキーワードで、トリガ操作をトリガの event の発生前に実行するか、発生後に実行するかを指定します。BEFORE トリガが実行される時点は、指定した event の実行前で、その event の検証が終了した後です。例えば、BEFORE DELETE トリガを実行できるのは、DELETE 文が指定の行に対して有効で、DELETE の実行 (外部キー参照の整合性チェックなど) に必要な特権がプロセスに与えられている場合のみです。指定した event をプロセスで実行できない場合は、event に対してエラー・コードが発行され、BEFORE トリガは実行できません。

以下に、組み合わせ可能な 8 つの event タイプの中の 4 つの例を示します。

CREATE TRIGGER TrigBI BEFORE INSERT ON Sample.Person
       INSERT INTO TLog VALUES ('before insert');

CREATE TRIGGER TrigAU AFTER UPDATE ON Sample.Person
       INSERT INTO TLog VALUES ('after update');

CREATE TRIGGER TrigBUOF BEFORE UPDATE OF Home_City,Home_State ON Sample.Person
       INSERT INTO TLog VALUES ('before address update');

CREATE TRIGGER TrigAD AFTER DELETE ON Sample.Person
       INSERT INTO TLog VALUES ('after delete');

ORDER

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

複数のトリガに同じ ORDER 値を割り当てることができます。また、ORDER が 0 (明示的または暗黙的) のトリガを複数作成することもできます。タイミング、イベント、および順序が同じ複数のトリガは、任意の順序でまとめて実行されます。

トリガはタイミング、順序、イベントの順に実行されます。BEFORE INSERT トリガと BEFORE INSERT/UPDATE トリガがある場合は、ORDER 値が最も小さいトリガが最初に実行されます。BEFORE INSERT トリガと BEFORE INSERT/UPDATE トリガがあり、ORDER 値が同じ場合は、INSERT が INSERT/UPDATE よりも前に実行されます。タイミングと順序が同じ場合、シングル・イベント・トリガは常にマルチ・イベント・トリガの前に実行されるためです。2 つ (またはそれ以上) のトリガでタイミング、順序、イベントの値が同じ場合は、命令の実行はランダムになります。

以下の例は、ORDER 値がどのように機能するかを示します。以下のどの CREATE TRIGGER 文でも、同じイベントで実行するトリガが作成されます。

CREATE TRIGGER TrigA BEFORE DELETE ON doctable
       INSERT INTO TLog VALUES ('doc deleted');
  -- Assigned ORDER=0

CREATE TRIGGER TrigB BEFORE DELETE ORDER 4 ON doctable
       INSERT INTO TReport VALUES ('doc deleted')
  -- Specified as ORDER=4

CREATE TRIGGER TrigC BEFORE DELETE ORDER 2 ON doctable
       INSERT INTO Ttemps VALUES ('doc deleted')
  -- Specified as ORDER=2

CREATE TRIGGER TrigD BEFORE DELETE ON doctable
       INSERT INTO Tflags VALUES ('doc deleted')
  -- Also assigned ORDER=0

これらのトリガは、(TrigA または TrigD)、TrigC、TrigB の順に実行されます。TrigA と TrigD は同じ ORDER 値となるので、任意の順序で実行されます。

REFERENCING

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

REFERENCING OLD ROW AS oldalias NEW ROW AS newalias

REFERENCING OLD oldalias NEW newalias

action

トリガ動作は、以下の要素から構成されます。

• オプションの FOR EACH 節。使用できる値は、FOR EACH ROW、FOR EACH ROW_AND_OBJECT、および FOR EACH STATEMENT です。FOR EACH ROW は、このトリガが SQL ファイリング操作によって呼び出されたことを表します。 FOR EACH ROW_AND_OBJECT は、このトリガが SQL ファイリング操作または Caché Objects ファイリング操作によって呼び出されたことを表します。FOR EACH STATEMENT は、TSQL トリガとの互換性のために用意されています。

• オプションの WHEN 節。WHEN 節は、WHEN キーワードとその後の括弧で囲まれた (単純または複雑な) 述語条件から成ります。述語条件が True に評価されると、トリガが実行されます。WHEN 節は、LANGUAGE が SQL の場合にのみ使用できます。WHEN 節は、oldalias 値または newalias 値を参照できます。述語条件式の詳細、および使用可能な述語のリストは、本ドキュメントの "述語の概要" のページを参照してください。

• オプションの LANGUAGE 節。LANGUAGE SQL または LANGUAGE OBJECTSCRIPT を指定できます。既定は LANGUAGE SQL です。

• トリガが実行されたときに実行するユーザ記述のコードです。

フィールド参照および擬似フィールド参照

ObjectScript で記述するトリガ・コードには、{fieldname} で指定するフィールド参照を含めることができます。ここで、fieldname は現在のテーブルの既存フィールドを指定します。中括弧内に空白スペースは許可されません。

fieldname の後に *N (新)、*O (旧)、または *C (比較) を付けて、挿入、更新、または削除されたフィールドのデータ値の処理方法を以下のとおりに指定できます。

• {fieldname*N}

  • UPDATE の場合は、指定された変更が行われた後の新しいフィールド値を返します。

  • INSERT の場合は、挿入した値を返します。

  • DELETE の場合は、削除前のフィールド値を返します。

• {fieldname*O}

  • UPDATE の場合は、指定された変更が行われる前の元のフィールド値を返します。

  • INSERT の場合は、NULL を返します。

  • DELETE の場合は、削除前のフィールド値を返します。

• {fieldname*C}

  • UPDATE の場合は、新しい値が古い値と異なる場合に 1 (TRUE) を返します。そうでない場合は 0 (FALSE) を返します。

  • INSERT の場合は、挿入した値が NULL でない場合に 1 (TRUE) を返します。そうでない場合は 0 (FALSE) を返します。

  • DELETE の場合は、削除される値が NULL でない場合に 1 (TRUE) を返します。そうでない場合は 0 (FALSE) を返します。

UPDATE、INSERT、または DELETE では、{fieldname} は {fieldname*N} と同じ値を返します。

フィールド値を設定する文の中では改行ができません。詳細は、"Caché クラス定義リファレンス" の "SqlComputeCode" プロパティ・キーワードを参照してください。

GetColumns()Opens in a new tab メソッドを使用すると、テーブルのために定義されているフィールド名をリストできます。詳細は、"Caché SQL の使用法" の “テーブルの定義” の章にある "列の名前と番号" を参照してください。

また、ObjectScript で記述するトリガ・コードには、擬似フィールド参照変数の {%%CLASSNAME}、{%%CLASSNAMEQ}、{%%OPERATION}、{%%TABLENAME}、および {%%ID} を含めることもできます。擬似フィールドは、クラスのコンパイル時に特定の値に変換されます。これらの擬似フィールド・キーワードは、すべて大文字と小文字が区別されません。

• {%%CLASSNAME} と {%%CLASSNAMEQ} は、ともに SQL テーブル定義を投影するクラスの名前に変換されます。{%%CLASSNAME} は引用符なし文字列を返し、{%%CLASSNAMEQ} は引用符付き文字列を返します。

• {%%OPERATION} は、トリガを呼び出した操作に応じて、文字列リテラル (INSERT、UPDATE、または DELETE のいずれか) に変換されます。

• {%%TABLENAME} はテーブルの完全修飾名に変換され、引用符付き文字列を返します。

• {%%ID} は RowID 名に変換されます。この参照は、RowID フィールドの名前がわからないときに役立ちます。

ストリーム・プロパティの参照

{StreamField}、{StreamField*O}、または {StreamField*N} など、ストリーム・フィールド/プロパティがトリガ定義で参照される場合は、{StreamField} 参照の値がストリームの OID (オブジェクト ID) 値となります。

BEFORE INSERT または BEFORE UPDATE トリガについては、新しい値が INSERT/UPDATE/ObjectSave によって指定される場合、{StreamField*N} 値が一時的ストリーム・オブジェクトの OID 、または新しいリテラル・ストリーム値のどちらかとなります。BEFORE UPDATE トリガについては、新しい値がストリーム・フィールド/プロパティに対して指定されていない場合、{StreamField*O} および {StreamField*N} は両方とも現在のフィールド/プロパティ・ストリーム・オブジェクトの OID になります。

SQLComputed プロパティの参照

一時 SqlComputed フィールド/プロパティ ("Calculated" または明示的な "Transient" のどちらか) がトリガ定義で参照される場合、そのトリガは Get()/Set() メソッドのオーバーライドを認識しません。プロパティの Get() または Set() メソッドをオーバーライドするのではなく、SQLCOMPUTED/SQLCOMPUTONCHANGE を使用してください。

Get()/Set() メソッドのオーバーライドを使用すると、{property*O} 値の決定に SQL が使用されて、オーバーライドされた Get()/Set() メソッドが使用されないという誤った結果がもたらされる可能性があります。プロパティがディスク上に格納されないため、{property*O} では SqlComputeCode が使用されて古い値が "再作成" されます。ただし、{property*N} は、オーバーライドされた Get()/Set() メソッドを使用してプロパティの値にアクセスします。その結果、プロパティが実際に変更されなかった場合でも、{property*O} と {property*N} は異なる場合があります (したがって、{property*C}=1) 。

ラベル

トリガ・コードには、行ラベル (タグ) が含まれる場合があります。トリガ・コードでラベルを指定するには、ラベル行の先頭にコロンを付けて、その行が最初の列で始まることを示します。Caché はコロンを削除して、残りの行をラベルとして処理します。ただし、トリガ・コードはプロシージャ・ブロックの範囲外で生成されるため、すべてのラベルはクラス定義に対して一意である必要があります。クラスのルーチンにコンパイルされるその他すべてのコードには、同じラベルを定義することはできません。これには、その他のトリガ、プロシージャ・ブロックを使用しないメソッド、SqlComputeCode などが含まれます。

メソッドの呼び出し

クラス・メソッドは開いているオブジェクトの有無に依存しないため、クラス・メソッドをトリガ・コード内から使用できます。クラス・メソッドを呼び出すには、##class(classname).Method() 構文を使用する必要があります。..Method() 構文では、現在開いているオブジェクトが必要なので、この構文は使用できません。

クラス・メソッドの引数として現在の行のフィールドの値を渡すことができますが、クラス・メソッド自体はフィールド構文を使用できません。