【原創】mysql 錯誤緩衝堆棧

什麼是錯誤緩衝堆棧呢？ 舉個很簡單的例子，比如執行下面一條語句：

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。