Raising Error Conditions with MySQL SIGNAL / RESIGNAL Statements

摘要：在本教程中，您将学习如何使用SIGNAL和RESIGNAL语句在存储过程中引发错误条件。

MySQL 信号语句

您可以使用SIGNAL语句从存储程序（例如存储过程、存储函数、触发器或事件）向调用者返回错误或警告条件。 SIGNAL语句使您可以控制返回哪些信息，例如值和消息SQLSTATE 。

下面说明了SIGNAL语句的语法：

SIGNAL SQLSTATE | condition_name;
SET condition_information_item_name_1 = value_1,
    condition_information_item_name_1 = value_2, etc;Code language: SQL (Structured Query Language) (sql)

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
	-- ...
ENDCode language: SQL (Structured Query Language) (sql)

首先，它使用我们传递给存储过程的输入订单号对订单进行计数。

其次，如果订单号不为 1，则会引发SQLSTATE 45000错误，并显示一条错误消息，指出订单表中不存在订单号。

请注意， 45000是一个通用SQLSTATE值，它说明了未处理的用户定义异常。

如果我们调用存储过程AddOrderItem()并传递一个不存在的订单号，我们将收到一条错误消息。

CALL AddOrderItem(10,'S10_1678',1,95.7,1);Code language: JavaScript (javascript)

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;
ENDCode language: SQL (Structured Query Language) (sql)

让我们调用Divide()存储过程。

CALL Divide(10,0,@result);Code language: CSS (css)

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