使用SIGNAL / RESIGNAL语句引发错误条件

---

简介：在本教程中，您将学习如何使用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关键字是一个SQLSTATE值或声明的条件名称 DECLARE CONDITION声明。请注意，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错误消息，表明订单表中不存在订单号。 请注意，这45000是一个通用SQLSTATE值，用于说明未处理的用户定义的异常。 如果我们调用存储过程  AddOrderItem()并传递一个不存在的订单号，我们将收到一条错误消息。

CALL AddOrderItem(10,'S10_1678',1,95.7,1);

ERROR 1644 (45000): Order No not found in orders table

---

MySQL RESIGNAL 语句

除了SIGNAL  语句之外，MySQL还提供了RESIGNAL  用于引发警告或错误情况的语句。 RESIGNAL  语句与SIGNAL  功能和语法方面的语句类似，不同之处在于：

• 您必须在错误或警告处理程序中使用RESIGNAL语句，否则，您将收到一条错误消息，指出“当处理程序未处于活动状态时RESIGNAL”。请注意，您可以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);

ERROR 1644 (22012): Division by zero / Denominator cannot be zero

在本教程中，我们向您展示了如何使用SIGNAL  和  RESIGNAL语句在存储的程序中引发错误条件。

---