?
This document uses PHP Chinese website manual Release
目錄
- 21.1. CREATE TRIGGER語法
- 21.2. DROP TRIGGER語法
- 21.3. 使用觸發(fā)程序
MySQL 5.1包含對觸發(fā)程序的支持。觸發(fā)程序是與表有關(guān)的命名數(shù)據(jù)庫對象，當表上出現(xiàn)特定事件時，將激活該對象。例如，下述語句將創(chuàng)建1個表和1個INSERT觸發(fā)程序。觸發(fā)程序?qū)⒉迦氡碇心骋涣械闹导釉谝黄穑?/p>
mysql> CREATE TABLE account (acct_num INT, amount DECIMAL(10,2));
mysql> CREATE TRIGGER ins_sum BEFORE INSERT ON account
??? -> FOR EACH ROW SET @sum = @sum + NEW.amount;
在本章中，介紹了創(chuàng)建和撤銷觸發(fā)程序的語法，并給出了一些使用它們的示例。關(guān)于對觸發(fā)程序使用的限制，請參見附錄I：特性限制。
關(guān)于觸發(fā)程序的二進制日志功能，請參見20.4節(jié)，“存儲子程序和觸發(fā)程序的二進制日志功能”。
CREATE TRIGGER trigger_name trigger_time trigger_event
???ON tbl_name FOR EACH ROW trigger_stmt
觸發(fā)程序是與表有關(guān)的命名數(shù)據(jù)庫對象，當表上出現(xiàn)特定事件時，將激活該對象。
觸發(fā)程序與命名為tbl_name的表相關(guān)。tbl_name必須引用永久性表。不能將觸發(fā)程序與TEMPORARY表或視圖關(guān)聯(lián)起來。
trigger_time是觸發(fā)程序的動作時間。它可以是BEFORE或AFTER，以指明觸發(fā)程序是在激活它的語句之前或之后觸發(fā)。
trigger_event指明了激活觸發(fā)程序的語句的類型。trigger_event可以是下述值之一：
·???????? INSERT：將新行插入表時激活觸發(fā)程序，例如，通過INSERT、LOAD DATA和REPLACE語句。
·???????? UPDATE：更改某一行時激活觸發(fā)程序，例如，通過UPDATE語句。
·???????? DELETE：從表中刪除某一行時激活觸發(fā)程序，例如，通過DELETE和REPLACE語句。
請注意，trigger_event與以表操作方式激活觸發(fā)程序的SQL語句并不很類似，這點很重要。例如，關(guān)于INSERT的BEFORE觸發(fā)程序不僅能被INSERT語句激活，也能被LOAD DATA語句激活。
可能會造成混淆的例子之一是INSERT INTO .. ON DUPLICATE UPDATE ...語法：BEFORE INSERT觸發(fā)程序?qū)τ诿恳恍袑⒓せ睿?/span>后跟AFTER INSERT觸發(fā)程序，或BEFORE UPDATE和AFTER UPDATE觸發(fā)程序，具體情況取決于行上是否有重復鍵。
對于具有相同觸發(fā)程序動作時間和事件的給定表，不能有兩個觸發(fā)程序。例如，對于某一表，不能有兩個BEFORE UPDATE觸發(fā)程序。但可以有1個BEFORE UPDATE觸發(fā)程序和1個BEFORE INSERT觸發(fā)程序，或1個BEFORE UPDATE觸發(fā)程序和1個AFTER UPDATE觸發(fā)程序。
trigger_stmt是當觸發(fā)程序激活時執(zhí)行的語句。如果你打算執(zhí)行多個語句，可使用BEGIN ... END復合語句結(jié)構(gòu)。這樣，就能使用存儲子程序中允許的相同語句。請參見20.2.7節(jié)，“BEGIN ... END復合語句”。
在MySQL 5.1中，可以編寫包含按名稱對表進行直接引用的觸發(fā)程序，如下例中所示的名為testref的觸發(fā)程序：
CREATE TABLE test1(a1 INT);
CREATE TABLE test2(a2 INT);
CREATE TABLE test3(a3 INT NOT NULL AUTO_INCREMENT PRIMARY KEY);
CREATE TABLE test4(
? a4 INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
??b4 INT DEFAULT 0
);
?
DELIMITER |
?
CREATE TRIGGER testref BEFORE INSERT ON test1
? FOR EACH ROW BEGIN
??? INSERT INTO test2 SET a2 = NEW.a1;
??? DELETE FROM test3 WHERE a3 = NEW.a1;?
????UPDATE test4 SET b4 = b4 + 1 WHERE a4 = NEW.a1;
? END
|
?
DELIMITER ;
?
INSERT INTO test3 (a3) VALUES
??(NULL), (NULL), (NULL), (NULL), (NULL),
??(NULL), (NULL), (NULL), (NULL), (NULL);
?
INSERT INTO test4 (a4) VALUES
??(0), (0), (0), (0), (0), (0), (0), (0), (0), (0);
如果將下述值插入表test1，如下所示：
mysql> INSERT INTO test1 VALUES
????-> (1), (3), (1), (7), (1), (8), (4), (4);
Query OK, 8 rows affected (0.01 sec)
Records: 8? Duplicates: 0? Warnings: 0
那么4個表中的數(shù)據(jù)如下：
mysql> SELECT * FROM test1;
+------+
| a1?? |
+------+
|??? 1 |
|??? 3 |
|??? 1 |
|??? 7 |
|??? 1 |
|??? 8 |
|??? 4 |
|??? 4 |
+------+
8 rows in set (0.00 sec)
?
mysql> SELECT * FROM test2;
+------+
| a2?? |
+------+
|??? 1 |
|??? 3 |
|??? 1 |
|??? 7 |
|??? 1 |
|??? 8 |
|??? 4 |
|??? 4 |
+------+
8 rows in set (0.00 sec)
?
mysql> SELECT * FROM test3;
+----+
| a3 |
+----+
|? 2 |
|? 5 |
|? 6 |
|? 9 |
| 10 |
+----+
5 rows in set (0.00 sec)
?
mysql> SELECT * FROM test4;
+----+------+
| a4 | b4?? |
+----+------+
|? 1 |??? 3 |
|? 2 |??? 0 |
|? 3 |??? 1 |
|? 4 |??? 2 |
|? 5 |??? 0 |
|? 6 |??? 0 |
|? 7 |??? 1 |
|? 8 |??? 1 |
|? 9 |??? 0 |
| 10 |??? 0 |
+----+------+
10 rows in set (0.00 sec)
使用別名OLD和NEW，能夠引用與觸發(fā)程序相關(guān)的表中的列。OLD.col_name在更新或刪除它之前，引用已有行中的1列。NEW.col_name在更新它之后引用將要插入的新行的1列或已有行的1列。
激活觸發(fā)程序時，對于觸發(fā)程序引用的所有OLD和NEW列，需要具有SELECT權(quán)限，對于作為SET賦值目標的所有NEW列，需要具有UPDATE權(quán)限。
注釋：目前，觸發(fā)程序不會被級聯(lián)的 外鍵動作激活。該限制將會被盡早放寬。
CREATE TRIGGER語句需要SUPER權(quán)限。
DROP TRIGGER [schema_name.]trigger_name
舍棄觸發(fā)程序。方案名稱（schema_name）是可選的。如果省略了schema（方案），將從當前方案中舍棄觸發(fā)程序。
注釋：從MySQL 5.0.10之前的MySQL版本升級到5.0.10或更高版本時（包括所有的MySQL 5.1版本），必須在升級之前舍棄所有的觸發(fā)程序，并在隨后重新創(chuàng)建它們，否則，在升級之后DROP TRIGGER不工作。關(guān)于推薦的升級步驟，請參見2.10.1節(jié)，“從5.0版升級” 。
DROP TRIGGER語句需要SUPER權(quán)限。
在本節(jié)中，介紹了在MySQL 5.1中使用觸發(fā)程序的方法，并介紹了在使用觸發(fā)程序方面的限制。
觸發(fā)程序是與表有關(guān)的命名數(shù)據(jù)庫對象，當表上出現(xiàn)特定事件時，將激活該對象。在某些觸發(fā)程序的用法中，可用于檢查插入到表中的值，或?qū)Ω律婕暗闹颠M行計算。
觸發(fā)程序與表相關(guān)，當對表執(zhí)行INSERT、DELETE或UPDATE語句時，將激活觸發(fā)程序?？梢詫⒂|發(fā)程序設(shè)置為在執(zhí)行語句之前或之后激活。例如，可以在從表中刪除每一行之前，或在更新了每一行后激活觸發(fā)程序。
要想創(chuàng)建觸發(fā)程序或舍棄觸發(fā)程序，可使用CREATE TRIGGER或DROP TRIGGER語句。關(guān)于這些語句的語法，請參見21.1節(jié)，“CREATE TRIGGER語法”和21.2節(jié)，“DROP TRIGGER語法”。
下面給出了1個簡單的示例，在該示例中，針對INSERT語句，將觸發(fā)程序和表關(guān)聯(lián)了起來。其作用相當于累加器，能夠?qū)⒉迦氡碇心骋涣械闹导悠饋怼?/p>
在下面的語句中，創(chuàng)建了1個表，并為表創(chuàng)建了1個觸發(fā)程序：
mysql> CREATE TABLE account (acct_num INT, amount DECIMAL(10,2));
mysql> CREATE TRIGGER ins_sum BEFORE INSERT ON account
??? -> FOR EACH ROW SET @sum = @sum + NEW.amount;
CREATE TRIGGER語句創(chuàng)建了與賬戶表相關(guān)的、名為ins_sum的觸發(fā)程序。它還包括一些子句，這些子句指定了觸發(fā)程序激活時間、觸發(fā)程序事件、以及激活觸發(fā)程序時作些什么：
·???????? 關(guān)鍵字BEFORE指明了觸發(fā)程序的動作時間。在本例中，應在將每一行插入表之前激活觸發(fā)程序。這類允許的其他關(guān)鍵字是AFTER。
·???????? 關(guān)鍵字INSERT指明了激活觸發(fā)程序的事件。在本例中，INSERT語句將導致觸發(fā)程序的激活。你也可以為DELETE和UPDATE語句創(chuàng)建觸發(fā)程序。
·???????? 跟在FOR EACH ROW后面的語句定義了每次激活觸發(fā)程序時將執(zhí)行的程序，對于受觸發(fā)語句影響的每一行執(zhí)行一次。在本例中，觸發(fā)的語句是簡單的SET語句，負責將插入amount列的值加起來。該語句將列引用為NEW.amount，意思是“將要插入到新行的amount列的值”。
要想使用觸發(fā)程序，將累加器變量設(shè)置為0，執(zhí)行INSERT語句，然后查看變量的值：
mysql> SET @sum = 0;
mysql> INSERT INTO account VALUES(137,14.98),(141,1937.50),(97,-100.00);
mysql> SELECT @sum AS 'Total amount inserted';
+-----------------------+
| Total amount inserted |
+-----------------------+
| 1852.48?????????????? |
+-----------------------+
在本例中，執(zhí)行了INSERT語句后，@sum的值是14.98 + 1937.50 – 100，或1852.48。
要想銷毀觸發(fā)程序，可使用DROP TRIGGER語句。如果觸發(fā)程序不在默認的方案中，必須指定方案名稱：
mysql> DROP TRIGGER test.ins_sum;
觸發(fā)程序名稱存在于方案的名稱空間內(nèi)，這意味著，在1個方案中，所有的觸發(fā)程序必須具有唯一的名稱。位于不同方案中的觸發(fā)程序可以具有相同的名稱。
在1個方案中，所有的觸發(fā)程序名稱必須是唯一的，除了該要求外，對于能夠創(chuàng)建的觸發(fā)程序的類型還存在其他限制。尤其是，對于具有相同觸發(fā)時間和觸發(fā)事件的表，不能有2個觸發(fā)程序。例如，不能為某一表定義2個BEFORE INSERT觸發(fā)程序或2個AFTER UPDATE觸發(fā)程序。這幾乎不是有意義的限制，這是因為，通過在FOR EACH ROW之后使用BEGIN ... END復合語句結(jié)構(gòu)，能夠定義執(zhí)行多條語句的觸發(fā)程序。請參見本節(jié)后面給出的示例。
此外，激活觸發(fā)程序時，對觸發(fā)程序執(zhí)行的語句也存在一些限制：
·???????? 觸發(fā)程序不能調(diào)用將數(shù)據(jù)返回客戶端的存儲程序，也不能使用采用CALL語句的動態(tài)SQL（允許存儲程序通過參數(shù)將數(shù)據(jù)返回觸發(fā)程序）。
·???????? 觸發(fā)程序不能使用以顯式或隱式方式開始或結(jié)束事務(wù)的語句，如START TRANSACTION、COMMIT或ROLLBACK。
使用OLD和NEW關(guān)鍵字，能夠訪問受觸發(fā)程序影響的行中的列（OLD和NEW不區(qū)分大小寫）。在INSERT觸發(fā)程序中，僅能使用NEW.col_name，沒有舊行。在DELETE觸發(fā)程序中，僅能使用OLD.col_name，沒有新行。在UPDATE觸發(fā)程序中，可以使用OLD.col_name來引用更新前的某一行的列，也能使用NEW.col_name來引用更新后的行中的列。
用OLD命名的列是只讀的。你可以引用它，但不能更改它。對于用NEW命名的列，如果具有SELECT權(quán)限，可引用它。在BEFORE觸發(fā)程序中，如果你具有UPDATE權(quán)限，可使用“SET NEW.col_name = value”更改它的值。這意味著，你可以使用觸發(fā)程序來更改將要插入到新行中的值，或用于更新行的值。
在BEFORE觸發(fā)程序中，AUTO_INCREMENT列的NEW值為0，不是實際插入新記錄時將自動生成的序列號。
OLD和NEW是對觸發(fā)程序的MySQL擴展。
通過使用BEGIN ... END結(jié)構(gòu)，能夠定義執(zhí)行多條語句的觸發(fā)程序。在BEGIN塊中，還能使用存儲子程序中允許的其他語法，如條件和循環(huán)等。但是，正如存儲子程序那樣，定義執(zhí)行多條語句的觸發(fā)程序時，如果使用mysql程序來輸入觸發(fā)程序，需要重新定義語句分隔符，以便能夠在觸發(fā)程序定義中使用字符“;”。在下面的示例中，演示了這些要點。在該示例中，定義了1個UPDATE觸發(fā)程序，用于檢查更新每一行時將使用的新值，并更改值，使之位于0～100的范圍內(nèi)。它必須是BEFORE觸發(fā)程序，這是因為，需要在將值用于更新行之前對其進行檢查：
mysql> delimiter //
mysql> CREATE TRIGGER upd_check BEFORE UPDATE ON account
??? -> FOR EACH ROW
??? -> BEGIN
??? ->? ???IF NEW.amount < 0 THEN
??? ->?????? ??SET NEW.amount = 0;
??? ->???? ELSEIF NEW.amount > 100 THEN
??? ->?????? ??SET NEW.amount = 100;
??? ->???? END IF;
??? -> END;//
mysql> delimiter ;
較為簡單的方法是，單獨定義存儲程序，然后使用簡單的CALL語句從觸發(fā)程序調(diào)用存儲程序。如果你打算從數(shù)個觸發(fā)程序內(nèi)部調(diào)用相同的子程序，該方法也很有幫助。
在觸發(fā)程序的執(zhí)行過程中，MySQL處理錯誤的方式如下：
·???????? 如果BEFORE觸發(fā)程序失敗，不執(zhí)行相應行上的操作。
·???????? 僅當BEFORE觸發(fā)程序（如果有的話）和行操作均已成功執(zhí)行，才執(zhí)行AFTER觸發(fā)程序。
·???????? 如果在BEFORE或AFTER觸發(fā)程序的執(zhí)行過程中出現(xiàn)錯誤，將導致調(diào)用觸發(fā)程序的整個語句的失敗。
·???????? 對于事務(wù)性表，如果觸發(fā)程序失敗（以及由此導致的整個語句的失?。?，該語句所執(zhí)行的所有更改將回滾。對于非事務(wù)性表，不能執(zhí)行這類回滾，因而，即使語句失敗，失敗之前所作的任何更改依然有效。
這是MySQL參考手冊的翻譯版本，關(guān)于MySQL參考手冊，請訪問dev.mysql.com。原始參考手冊為英文版，與英文版參考手冊相比，本翻譯版可能不是最新的。