Edit of CREATE TRIGGER - Firebird Wiki

[[FrontPage]]へ~
-[[リファレンスガイド]]へ~
--[[Firebird SQLリファレンス]]へ~
&br;
----
*Firebird SQLリファレンス:CREATE TRIGGER, ALTER TRIGGER, DROP TRIGGER [#i75fc7cb]

#contents

----
&br;
&aname(create_trigger);
*CREATE TRIGGER [#odfa4c9c]
　トリガを作成します。同時に、それが起動されるタイミングや動作を定義します。 DSQL,isqlで使用できます。
　この文書は、公開されているIB6のSQLレファレンスを基とし、1.5.1までの 各リリースノートにおける追加内容に関して反映・統合されています。

**構文 [#n0b6c113]

Firebird 1.5以降:(マルチアクショントリガ機能追加)
 CREATE TRIGGER name FOR table
    [ACTIVE | INACTIVE]
    {BEFORE | AFTER} <multiple_action>
    [POSITION number]
    AS <trigger_body> terminator

<multiple_action> ::=
    <single_action> [OR <single_action> [OR <single_action>]]

<single_action> ::= {INSERT | UPDATE | DELETE}

IB6/Firebird 1.0:
 CREATE TRIGGER name FOR table [ACTIVE | INACTIVE]
    {BEFORE | AFTER} {DELETE | INSERT | UPDATE}
    [POSITION number]
    AS <trigger_body> terminator

<trigger_body> = [<variable_declaration_list>] <block>

Firebird 1.5以降:(初期化できるようになった)
 <variable_declaration_list> =
    DECLARE VARIABLE var <datatype> [{'=' | DEFAULT} value];
    [DECLARE VARIABLE var <datatype> [{'=' | DEFAULT} value]; …]

IB6/Firebird 1.0:
 <variable_declaration_list> =
    DECLARE VARIABLE var <datatype>;
    [DECLARE VARIABLE var <datatype>; …]

<block> =
    BEGIN
        <compound_statement>
        [<compound_statement> …]
    END

<compound_statement> = {<block> | statement;}

<datatype> = SMALLINT | INTEGER | BIGINT | FLOAT | DOUBLE PRECISION
    | {DECIMAL | NUMERIC} [(precision [, scale])]
    | {DATE | TIME | TIMESTAMP}
    | {CHAR | CHARACTER | CHARACTER VARYING | VARCHAR}
        [(int)] [CHARACTER SET charname]
    | {NCHAR | NATIONAL CHARACTER | NATIONAL CHAR} [VARYING] [(int)]

**詳細の説明 [#v205c88c]
　CREATE TRIGGER により、データベースに新しいトリガを定義します。 トリガとは、テーブルやビューにおいて行の追加・削除、変更が行われたときに 自動的に起動される、自己完結した１つのプログラムです。
(訳注:この機能により、テーブルやビューに対して加工を行ったり、ログの自動取得 などの様々な機能を付加することが出来ます。)

&br;

トリガは、アプリケーションなどから直接呼び出されることはありません。 アプリケーションやユーザにより、INSERT,UPDATE,DELETEなどによって行の操作が 行われたとき、関連付けられたトリガが自動的に呼び出されて実行されます。
　ただし、リードオンリーのビューに対して UPDATE に対するトリガを定義した 場合、更新による実行を試みようとしてもにそれが実行されることは決してありません。

&br;

トリガの定義はヘッダと本体の２つで構成されいます。
-ヘッダの定義内容には、以下のようなものがあります。
--トリガの名前。データベース内において、他のオブジェクトも含めて一意な名前 である必要があります。
--トリガが関連付けられるテーブルの名前。
--トリガが実行されるタイミングの指定。
-本体の定義には、以下のものが含まれます。
--必要ならば、ローカル変数と型定義のリスト。Firebird1.5では、変数の宣言時に 値を初期化出来るようになりました。
--BEGIN で始まり END で括られる、プロシージャ・トリガ記述言語により記述された いくつかの文で構成されるブロック。ブロック内には、別のブロックを含むことが 出来ます。つまり、ブロックの多重ネストが可能となっています。

''重要'' トリガの本体部分の記述では、終端文字としてセミコロンを使用します。 このため、isqlによりストアドプロシージャの定義を行う場合は、SET TERM により 終端文字をセミコロン以外に変更する必要があります。また、このような場合は、 CREATE TRIGGER 文を終了させた後に、終端文字を元のセミコロンに戻しましょう。

トリガは、テーブルに関連付けます。テーブルに対するすべての特権をもつ所有者 はもとより、所有者によりテーブルに対してアクセスできる特権を与えられたすべて のユーザーが、トリガを実行することが出来ます。 (訳注:EXECUTE特権はなくても実行できるということ。)

ユーザーやプロシージャに対して特権を与えるのと同様に、トリガに対しても GRANT文により特権を与えることが出来ます。この場合、"TO username"の代わりに "TO TRIGGER trigger_name"を使用して下さい。特権を削除する場合は、同様にして REVOKE文を使用してください。

ユーザーがトリガが起動される要因となる操作を行うときに、以下の条件のいずれか に当てはまる場合は、起動されたトリガは起動要因となった操作に対する特権を所有 します。
-トリガ自体が、すでに特権を所有している場合。
-起動要因を発生させたユーザーが、その要因に対する特権を所有している場合。

処理内容を記述するプロシージャ・トリガ記述言語に関しては、 CREATE PROCEDUREのプロシージャ・トリガ記述言語を参照して下さい。

Firebird 1.5 以降では、マルチアクショントリガの定義が可能となりました。&br;
　これは複数の行操作(INSET/UPDATE/DELETE)に対して、同じトリガを関連付けることが出来る機能です。具体的には、関連付ける操作を OR で結びます。&br;
　また、この機能追加に伴い、起動要因となった操作を識別するためのコンテキスト変数が追加されました。追加された変数は、INSERTING、UPDATING、DELETINGです。 この機能の追加により、似た処理が多い別々の行操作用トリガ定義を１つにまとめる 事が出来るため、可読性と保守性の向上が期待できます。

※isqlの場合、SET TRIGGERSによりデータベースに定義されたトリガのリストが 参照できます。また、SET TRIGGER trigger_name により、指定したトリガの現在の メタデータを参照できます。

**用例 [#xad0a59a]
すべて、isqlでの例です。
-トリガSAVE_SALARY_CHANGEは、テーブルEMPLOYEEが更新された時に列SALARYの値が 変更されていた場合、SALARY_HISTORYにログを取得します。
 SET TERM !! ;
 
 CREATE TRIGGER SAVE_SALARY_CHANGE FOR EMPLOYEE
 AFTER UPDATE AS
 BEGIN
  IF (OLD.SALARY <> NEW.SALARY) THEN
    INSERT INTO SALARY_HISTORY
      (EMP_NO, CHANGE_DATE, UPDATER_ID, OLD_SALARY, PERCENT_CHANGE)
      VALUES (OLD.EMP_NO, 'now', USER, OLD.SALARY,
      (NEW.SALARY - OLD.SALARY) * 100 / OLD.SALARY);
 END !!
 
 SET TERM ; !!
-トリガSET_CUST_NOは、テーブルCUSTOMERに新行を追加するときに、列CUST_NOに ジェネレータで生成されたユニークなカスタマ番号を付与します。BEFOREが指定 されているため、このトリガは挿入前に実行されます。
 SET TERM !! ;
 
 CREATE TRIGGER SET_CUST_NO FOR CUSTOMER
 BEFORE INSERT AS
 BEGIN
   NEW.CUST_NO = GEN_ID(CUST_NO_GEN, 1);
 END !!
 
 SET TERM ; !!
-トリガPOST_NEW_ORDERは、テーブルSALESに行が挿入されると、"new_order"という 名前のイベントをポストします。
 SET TERM !! ;
 
 CREATE TRIGGER POST_NEW_ORDER FOR SALES
 AFTER INSERT AS
 BEGIN
   POST_EVENT 'new_order';
 END !!
 
 SET TERM ; !!
-BFFORE,AFTRE,POSITION指定による実行順序制御の例です。本体部分は省略されていますので 注意して下さい。
--定義ヘッダです。
 CREATE TRIGGER A FOR accounts
 BEFORE UPDATE
 POSITION 5 … /*Trigger body follows*/
 
 CREATE TRIGGER B FOR accounts
 BEFORE UPDATE
 POSITION 0 … /*Trigger body follows*/
 
 CREATE TRIGGER C FOR accounts
 AFTER UPDATE
 POSITION 5 … /*Trigger body follows*/
 
 CREATE TRIGGER D FOR accounts
 AFTER UPDATE
 POSITION 3 … /*Trigger body follows*/
--次のようにしてテーブルacountが更新(UODATE)されると、以下の順序で処理が 行われます。
 UPDATE accounts SET account_status = 'on_hold'
 WHERE account_balance <0;

+トリガ B 実行
+トリガ A 実行
+行更新の実行
+トリガ D 実行
+トリガ C 実行
**参照 [#ef83da76]
ALTER EXCEPTION , ALTER TRIGGER , CREATE EXCEPTION , CREATE PROCEDURE , DROP EXCEPTION , DROP TRIGGER , EXECUTE PROCEDURE

これ以上の情報が欲しい場合は、Data Definition Guideの creating and using triggers を参照して下さい。

&br;
&aname(alter_trigger);
*ALTER TRIGGER [#t403c3ae]
　既存のトリガを変更します。 DSQL,isqlで使用できます&br;
　この文書は、公開されているIB6のSQLレファレンスを基とし、1.5.1までの 各リリースノートにおける追加内容に関して反映・統合されています。
**構文 [#x2201d5e]
Firebird1.5以降:(マルチアクショントリガ機能追加)
 ALTER TRIGGER name
     [ACTIVE | INACTIVE]
     [{BEFORE | AFTER} <multiple_action>]
     [POSITION number]
     [AS <trigger_body> terminator]

<multiple_action> ::=
     <single_action> [OR <single_action> [OR <single_action>]]

<single_action> ::= {INSERT | UPDATE | DELETE}

IB6/Firebird 1.0:
 ALTER TRIGGER name
     [ACTIVE | INACTIVE]
     [{BEFORE | AFTER} {DELETE | INSERT | UPDATE}]
     [POSITION number]
     [AS <trigger_body>] [terminator]

**詳細の説明 [#pcfd23c3]
　ALTER TRIGGER により、既存のトリガの定義を変更できます。ALTER TRIGGERは、 CREATE TRIGGER と似ていますがほとんどの引数を省略できます。その場合は、 デフォルト値もしくはCREATE TRIGGERまたは最後の ALTER TRIGGER で設定された 現在値が設定されます。

ALTER TRIGGER では次のような変更が可能です。
-ヘッダ情報のみの変更。トリガの活性化設定、アクションとの関連付け、 実行タイミング、実行順序の制御値などです。
-本体部分のみの変更。ASに続くトリガ処理内容を記述した部分の変更です。
-ヘッダと本体両方の変更。この場合は、トリガの再定義と同じようなことに なります。

Firebird 1.5 以降では、マルチアクショントリガの定義が可能となりました。&br;
　これは複数の行操作(INSET/UPDATE/DELETE)に対して、同じトリガを関連付けること が出来る機能です。具体的には、関連付ける操作を OR で結びます。&br;
　マルチアクション定義の関連付けのみの変更も可能です。

トリガの変更が出来るのは、作成者、SYSDBAユーザーおよびOSの管理者権限 を持ったユーザーのみです。

※テーブルのCHECK制約によって自動的に定義されたトリガを変更するためには、 ALTER TABLE を使用して制約の変更を行う必要があります。

**用例 [#o6f54197]
すべて、isqlでの例です。

-トリガSET_CUST_NOを非活性化します。
 ALTER TRIGGER SET_CUST_NO INACTIVE;
-トリガSET_CUST_NOを変更します。行が追加されたとき、同時に NEW_CUSTNO に 行を追加します。
 SET TERM !! ;
 
 ALTER TRIGGER SET_CUST_NO FOR CUSTOMER
 BEFORE INSERT AS
 BEGIN
   NEW.CUST_NO = GEN_ID(CUST_NO_GEN, 1);
   INSERT INTO NEW_CUSTOMERS(NEW.CUST_NO, TODAY)
 END !!
 
 SET TERM ; !!
**参照 [#gd2d38ad]

CREATE TRIGGER , DROP TRIGGER

これ以上の情報が欲しい場合は、Data Definition Guideの triggers を参照して 下さい。

&br;
&aname(drop_procedure);
**DROP TRIGGER [#lfaad852]
データベースより、既存であるユーザー定義のトリガを削除します。 DSQL,isqlで使用できます。
**構文 [#a81a6c88]
 DROP TRIGGER name

|引数|説明|h
|name|削除を行いたい、既存のトリガの名前です。|

**詳細の説明 [#q837caf2]
　DROP TRIGGER により、ユーザーが定義したトリガをデータベースから削除します。&br;
　システム定義のトリガやCHECK制約で作成されたトリガは削除できません。 そのようなトリガ定義を削除する場合は、ALTER TABLE を使用します。

トリガが有効なトランザクションで使用されている場合、そのトランザクションが 終了するまで削除は行われません。

トリガの削除が出来るのは、作成者、SYSDBAユーザーまたは OS の管理者権限を 持ったユーザーのみです。

※　一時的にトリガを使用しない場合には、ALTER TRIGGER に INACTIVE を指定して 非活性化することにより実現しましょう。
**用例 [#p9c27e89]
　isqlで、トリガの削除を行う例です。
 DROP TRIGGER POST_NEW_ORDER;
**参照 [#xc735de2]
　ALTER TRIGGER , CREATE TRIGGER

タイムスタンプを変更しない

テキスト整形のルールを表示する

Edit of CREATE TRIGGER[TOC]