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

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

MySQL SIGNAL 语句

您可以使用该 SIGNAL 语句从存储程序（例如，存储过程、存储函数、触发器或事件）向调用方返回错误或警告条件。该 SIGNAL 语句使您可以控制返回哪些信息，例如 value 和 message 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

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

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

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

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

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

MySQL RESIGNAL 语句

除了 SIGNAL 语句之外，MySQL 还提供了 RESIGNAL 用于引发警告或错误条件的语句。

该 RESIGNAL 语句 SIGNAL 在功能和语法方面类似于语句，不同之处在于：

您必须 RESIGNAL 在错误或警告处理程序中使用该语句，否则，您将收到一条错误消息，指出“处理程序未激活时重新发出信号”。请注意，您可以 SIGNAL 在存储过程中的任何位置使用statement。
您可以省略 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

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

CALL Divide(10,0,@result);

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

MySQL SIGNAL 语句

MySQL RESIGNAL 语句

本页目录