在本教程中,您将学习如何使用SIGNAL
和RESIGNAL
语句来引发存储过程中的错误条件。
MySQL SIGNAL语句
使用SIGNAL
语句在存储的程序(例如存储过程,存储函数,触发器或事件)中向调用者返回错误或警告条件。 SIGNAL
语句提供了对返回值(如值和消息SQLSTATE
)的信息的控制。
以下说明SIGNAL
语句的语法:
SIGNAL SQLSTATE | condition_name;
SET condition_information_item_name_1 = value_1,
condition_information_item_name_1 = value_2, etc;
SIGNAL
关键字是由DECLARE CONDITION
语句声明的SQLSTATE
值或条件名称。 请注意,SIGNAL
语句必须始终指定使用SQLSTATE
值定义的SQLSTATE
值或命名条件。
要向调用者提供信息,请使用SET
子句。如果要使用值返回多个条件信息项名称,则需要用逗号分隔每个名称/值对。
condition_information_item_name
可以是MESSAGE_TEXT
,MYSQL_ERRORNO
,CURSOR_NAME
等。
以下存储过程将订单行项目添加到现有销售订单中。 如果订单号码不存在,它会发出错误消息。
DELIMITER $$
CREATE PROCEDURE AddOrderItem(in orderNo int,
in productCode varchar(45),
in qty int,in price double, in lineNo int )
BEGIN
DECLARE C INT;
SELECT COUNT(orderNumber) INTO C
FROM orders
WHERE orderNumber = orderNo;
-- check if orderNumber exists
IF(C != 1) THEN
SIGNAL SQLSTATE '45000'
SET MESSAGE_TEXT = 'Order No not found in orders table';
END IF;
-- more code below
-- ...
END $$
DELIMITER ;
首先,它使用传递给存储过程的输入订单号对订单进行计数。
第二步,如果订单数不是1
,它会引发SQLSTATE 45000的错误以及orders
表中不存在订单号的错误消息。
请注意,
45000
是一个通用SQLSTATE
值,用于说明未处理的用户定义异常。
如果调用存储过程AddOrderItem()
,但是传递不存在的订单号,那么将收到一条错误消息。
CALL AddOrderItem(10,'S10_1678',1,95.7,1);
执行上面代码,得到以下结果 -
mysql> CALL AddOrderItem(10,'S10_1678',1,95.7,1);
1644 - Order No not found in orders table
mysql>
MySQL RESIGNAL语句
除了SIGNAL
语句,MySQL还提供了用于引发警告或错误条件的RESIGNAL
语句。
RESIGNAL
语句在功能和语法方面与SIGNAL
语句相似,只是:
- 必须在错误或警告处理程序中使用
RESIGNAL
语句,否则您将收到一条错误消息,指出“RESIGNAL when handler is not active
”。 请注意,您可以在存储过程中的任何位置使用SIGNAL
语句。 - 可以省略
RESIGNAL
语句的所有属性,甚至可以省略SQLSTATE
值。
如果单独使用RESIGNAL
语句,则所有属性与传递给条件处理程序的属性相同。
以下存储过程在将发送给调用者之前更改错误消息。
DELIMITER $$
CREATE PROCEDURE Divide(IN numerator INT, IN denominator INT, OUT result double)
BEGIN
DECLARE division_by_zero CONDITION FOR SQLSTATE '22012';
DECLARE CONTINUE HANDLER FOR division_by_zero
RESIGNAL SET MESSAGE_TEXT = 'Division by zero / Denominator cannot be zero';
--
IF denominator = 0 THEN
SIGNAL division_by_zero;
ELSE
SET result := numerator / denominator;
END IF;
END $$
DELIMITER ;
下面我们来调用Divide()
存储过程。
CALL Divide(10,0,@result);
执行上面语句,得到以下结果 -
mysql> CALL Divide(10,0,@result);
1644 - Division by zero / Denominator cannot be zero
在本教程中,我们向您展示了如何使用SIGNAL
和RESIGNAL
语句引发存储程序中的错误条件。