MySQL中的SIGNAL语句

在数据库编程中，有效地管理错误和警告至关重要。MySQL为此目的提供了一个强大的工具：SIGNAL语句。让我们深入了解一下SIGNAL是什么，它如何工作，以及为什么它是您SQL工具箱中不可或缺的一部分。

SIGNAL语句是什么？

SIGNAL语句是MySQL内生成自定义错误信息或警告的方式，这些自定义的错误信息或警告来自存储过程、触发器和事件。它允许你从内部“返回”一个具有指定特性（如唯一错误号、SQLSTATE值或自定义文本消息）的错误。在引入SIGNAL之前，开发人员必须使用诸如故意调用不存在的表以触发错误的变通方法。幸运的是，SIGNAL显著简化了这个过程，并且执行它不需要任何特殊权限。

语法和用途

SIGNAL语句的语法如下：

SIGNAL condition_value
    [SET signal_information_item [, signal_information_item] ...]

这里condition_value可以是一个SQLSTATE值或用户定义的condition_name。可选的SET子句允许你通过为各种条件信息项分配值来提供附加信息。

条件信息项

当发出一个错误信号时，你可能会包括几项信息，例如：

• CLASS_ORIGIN: 一个字符串，表示发生错误的主要类别的原始标识。
• SUBCLASS_ORIGIN: 一个字符串，表示错误的次要类别的原始标识。
• MESSAGE_TEXT: 用于描述错误的自定义消息文本，这通常用来给出向最终用户显示的错误信息。
• MYSQL_ERRNO: MySQL特有的错误编号，与内部错误代码相对应的无符号小整数（SMALLINT UNSIGNED）。
• CONSTRAINT_CATALOG: 发生违反约束错误时，约束所属的目录的名称。
• CONSTRAINT_SCHEMA: 发生违反约束错误时，该约束所在的数据库的名称。
• CONSTRAINT_NAME: 当涉及到约束违规时，触发错误的具体约束的名称。
• CATALOG_NAME: 出错时相关联的目录名称。
• SCHEMA_NAME: 错误发生时相关的数据库架构（或称为“数据库”）的名称。
• TABLE_NAME: 当错误与特定表相关时，该表的名称。
• COLUMN_NAME: 若错误与某个特定的列相关，则为该列的名称。
• CURSOR_NAME: 如果错误和游标操作相关，表示那个游标的名称。

每项都必须设置与预期数据类型相符的值。

SIGNAL实际应用

以下是使用SIGNAL语句的示例过程：

CREATE PROCEDURE p (pval INT)
BEGIN
  IF pval = 0 THEN
    SIGNAL SQLSTATE '01000';
  ELSEIF pval = 1 THEN
    SIGNAL SQLSTATE '45000'
      SET MESSAGE_TEXT = '发生了错误';
  -- 其他条件...
END;

根据输入参数pval的不同，会发出不同的SQLSTATE值，每个都可能伴随着消息和错误号。

SIGNAL如何工作？

• SQLSTATE值： 这是一个5字符的字符串文字，代表要发出的错误。它不应该以'00'开头，因为那表示成功。
• 命名条件： 使用先前声明的命名条件来指示特定错误。
• SET子句： 可选择性地包含关于错误的更多细节，使用一系列赋值操作。

执行SIGNAL时遵循的规则包括遵守SQLSTATE有效性和命名条件的作用域限制。

SIGNAL的影响

SIGNAL执行后，根据SQLSTATE值的前两个字符（称为错误类别）影响MySQL的行为：

• 类别'01' 表示警告，这会增加warning_count系统变量的数值，但不会终止过程。
• 类别'02' 表示“未找到”条件，由NOT FOUND处理程序捕获，对游标无影响。
• 类别> '02' 代表异常，SQLEXCEPTION处理程序会被激活，函数中未处理的信号将导致终止。

检索错误信息

SIGNAL执行后，你可以使用像SHOW WARNINGS这样的命令或通过查询诊断区域与GET DIAGNOSTICS语句来获取错误详细信息。C API层面的工具（mysql_sqlstate()，mysql_errno()，mysql_error()）也允许以编程方式访问这些信息。