什么是错误缓冲堆栈呢? 举个很简单的例子,比如执行下面一条语句:

mysql> INSERT INTO t_datetime VALUES(2,'4','5');
ERROR 1292 (22007): Incorrect datetime value: '4' for column 'log_time' at row 1


上面1292这个代码指示的错误信息保存在哪里呢? 就保存在错误缓冲堆栈, 在MySQL里面叫 DIAGNOSTICS AREA。 关于这个概念,一直在MySQL5.7才得到确定的更新。 

在MySQL5.5之前,想要得到这块区域的数据,就只能通过C的API来获取,从SQL层面是无法检索到的。MySQL5.5 先推出了这个概念。

在MySQL5.6发布后,不但可以检索这块区域,而且还可以重新封装,得到我们想要的数据。但是这块区域依然是只能保存一次错误代码,很容易被重置。

在MySQL5.7发布后,可以更加容易的检索这块区域,而且把这里的数据放到一个STACK里,重置的条件更加宽松。以下举例子来说明。


示例表结构如下,

CREATE TABLE `t_datetime` (
  `id` int(11) NOT NULL,
  `log_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  `end_time` datetime NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;


用来记录错误数据的日志表。

CREATE TABLE tb_log (errorno int,errortext TEXT,error_timestamp DATETIME);




在MySQL5.6环境下,我要这样写一段繁杂的代码来获取错误信息。

DELIMITER $$
USE `new_feature`$$
DROP PROCEDURE IF EXISTS `sp_do_insert`$$
CREATE DEFINER=`root`@`localhost` PROCEDURE `sp_do_insert`(
IN f_id INT,
IN f_log_time VARCHAR(255),
IN f_end_time VARCHAR(255)
)
BEGIN
  DECLARE done1 TINYINT DEFAULT 0; -- 保存是否发生异常的布尔值。
  DECLARE i TINYINT DEFAULT 1;
  DECLARE v_errcount INT DEFAULT 0;  -- 获取一次错误数据条数
  DECLARE v_errno INT DEFAULT 0; -- 获取错误代码
  DECLARE v_msg TEXT; -- 获取错误详细信息
  DECLARE CONTINUE HANDLER FOR SQLEXCEPTION -- 定义一个异常处理块
  BEGIN
    SET done1 = 1; -- 发生异常,设置为1.
    get  diagnostics v_errcount = number;
    SET v_msg = '';
    WHILE i <= v_errcount
    DO
      GET  DIAGNOSTICS CONDITION i
        v_errno = MYSQL_ERRNO, v_msg = MESSAGE_TEXT;
        SET @stmt = CONCAT('select ',v_errno,',"',v_msg,'","',NOW(),'" into @errno',i,',@msg',i,',@log_timestamp',i,';');
        PREPARE s1 FROM @stmt;
        EXECUTE s1;
      SET i = i + 1;
    END WHILE;
    DROP PREPARE s1;
  END;
    INSERT INTO t_datetime (id,log_time,end_time) VALUES(f_id,f_log_time,f_end_time);
    IF done1 = 1 THEN -- 把错误数据记录到表tb_log里。
      SET i = 1;
      WHILE i <= v_errcount
      DO
        SET @stmt = CONCAT('insert into tb_log ');
        SET @stmt = CONCAT(@stmt,' select @errno',i,',@msg',i,',@log_timestamp');
        PREPARE s1 FROM @stmt;
        EXECUTE s1;
        SET i = i + 1;
      END WHILE;
      DROP PREPARE s1;
    END IF;
END$$
DELIMITER ;


MySQL5.7发布后,现在可以精简我的代码了。

DELIMITER $$
USE `new_feature`$$
DROP PROCEDURE IF EXISTS `sp_do_insert`$$
CREATE DEFINER=`root`@`localhost` PROCEDURE `sp_do_insert`(
IN f_id INT,
IN f_log_time VARCHAR(255),
IN f_end_time VARCHAR(255)
)
BEGIN
  DECLARE i TINYINT DEFAULT 1;
  DECLARE v_errcount INT DEFAULT 0; -- 获取一次错误数据条数
  DECLARE v_errno INT DEFAULT 0;  -- 获取错误代码
  DECLARE v_msg TEXT; -- 获取错误详细信息
  DECLARE CONTINUE HANDLER FOR SQLEXCEPTION  -- 定义一个异常处理块
  BEGIN
    get stacked diagnostics v_errcount = number;
    WHILE i <= v_errcount
    DO
      GET stacked DIAGNOSTICS CONDITION i -- 把错误数据分别保存在变量里
        v_errno = MYSQL_ERRNO, v_msg = MESSAGE_TEXT;
        INSERT INTO tb_log VALUES (v_errno,v_msg,NOW());
      SET i = i + 1;
    END WHILE;
  END;
    INSERT INTO t_datetime (id,log_time,end_time) VALUES(f_id,f_log_time,f_end_time);  
END$$
DELIMITER ;


现在来执行下:

mysql> call sp_do_insert(2,'4','5');
Query OK, 1 row affected (0.01 sec)


来检索表tb_log的数据。

mysql> select * from tb_log\G
*************************** 1. row ***************************
        errorno: 1265
      errortext: Data truncated for column 'log_time' at row 1
error_timestamp: 2015-11-17 11:53:10
*************************** 2. row ***************************
        errorno: 1265
      errortext: Data truncated for column 'end_time' at row 1
error_timestamp: 2015-11-17 11:53:10
*************************** 3. row ***************************
        errorno: 1062
      errortext: Duplicate entry '2' for key 'PRIMARY'
error_timestamp: 2015-11-17 11:53:10
3 rows in set (0.00 sec)



总结下, 如果先用到DIAGNOSTICS AREA, 最好是在存储过程里面写代码封装SQL。