13.6.7.2 DECLARE ... HANDLER 구문

DECLARE handler_action HANDLER
    FOR condition_value [, condition_value] ...
    statement

handler_action:
    CONTINUE
  | EXIT
  | UNDO

condition_value:
    mysql_error_code
  | SQLSTATE [VALUE] sqlstate_value
  | condition_name
  | SQLWARNING
  | NOT FOUND
  | SQLEXCEPTION 

DECLARE ... HANDLER 문은 하나 이상의 조건을 처리하는 핸들러를 지정합니다. 이러한 조건 중 하나가 발생하면, 지정된 statement 가 실행됩니다. statement 는 SET var_name = value 등의 간단한 명령문은 BEGIN 과 END 를 사용하여 작성된 복합 문이 될 수 있습니다 ( 섹션 13.6.1 "BEGIN ... END 복합 문"부분 을 참조하십시오) .

핸들러 선언은 변수 나 조건 선언 다음에 지정해야합니다.

handler_action 값은 핸들러 문을 실행 한 후 핸들러가 어떤 작업을 수행하는 방법을 보여줍니다.

DECLARE ... HANDLER 의 condition_value 이 핸들러를 활성화하는 구체적인 조건 또는 조건의 클래스를 나타냅니다.

조건이 발생했을 때 서버가 핸들러를 선택하는 방법은 섹션 13.6.7.6 "핸들러의 범위에 관한 규칙" 을 참조하십시오.

해당 핸들러가 선언되지 않은 조건이 발생하는 경우 수행되는 작업은 그 조건의 클래스에 따라 다릅니다.

다음 예제에서는 중복 키 에러를 발생시킨다 SQLSTATE '23000' 의 핸들러를 사용합니다.

mysql> CREATE TABLE test.t (s1 INT, PRIMARY KEY (s1));
Query OK, 0 rows affected (0.00 sec)

mysql> delimiter //

mysql> CREATE PROCEDURE handlerdemo ()
    -> BEGIN
    ->   DECLARE CONTINUE HANDLER FOR SQLSTATE '23000' SET @x2 = 1;
    ->   SET @x = 1;
    ->   INSERT INTO test.t VALUES (1);
    ->   SET @x = 2;
    ->   INSERT INTO test.t VALUES (1);
    ->   SET @x = 3;
    -> END;
    -> //
Query OK, 0 rows affected (0.00 sec)

mysql> CALL handlerdemo()//
Query OK, 0 rows affected (0.00 sec)

mysql> SELECT @x//
    +------+
    | @x   |
    +------+
    | 3    |
    +------+
    1 row in set (0.00 sec)

이 프로 시저를 실행 한 후 @x 가 3 으로되어 있는지 확인하십시오. 이 오류가 발생한 후 프로 시저의 마지막까지 계속 실행되었음을 보여줍니다. DECLARE ... HANDLER 문이 존재하지 않았다고하면 PRIMARY KEY 제약으로 인해 두 번째 INSERT 가 실패한 후에 MySQL은 기본 동작 ( EXIT )을 실행하기 위해 SELECT @x 는 2 를 반환했습니다 했다.

조건을 무시하려면 그 조건의 CONTINUE 핸들러를 선언하고 그것을 빈 블록에 연결합니다. 예 :

 DECLARE CONTINUE HANDLER FOR SQLWARNING BEGIN END;

블록 레이블 범위는 블록 내에서 선언 된 핸들러의 코드는 포함되지 않습니다. 따라서 핸들러에 연결된 문은 ITERATE 또는 LEAVE 를 사용하여 처리기 선언을 둘러싸고 블록의 라벨을 참조 할 수 없습니다. REPEAT 블록에 retry 레이블이 포함 된 다음의 예를 생각해 보겠습니다.

 CREATE PROCEDURE p ()
 BEGIN
   DECLARE i INT DEFAULT 3;
   retry :
     REPEAT
       BEGIN
         DECLARE CONTINUE HANDLER FOR SQLWARNING
           BEGIN
             ITERATE retry; # illegal
           END;
         IF i <0 THEN
           LEAVE retry; # legal
         END IF;
         SET i = i - 1;
       END;
     UNTIL FALSE END REPEAT;
 END;

retry 레이블은 블록의 IF 문 범위 내에 있습니다. CONTINUE 핸들러의 범위 내에 않기 때문에 거기에 대한 참조는 무효이며, 오류가 발생합니다.

 ERROR 1308 (42000) : LEAVE with no matching label : retry

핸들러의 외부 레이블에 대한 참조를 해결하려면 다음 방법 중 하나를 사용합니다.