[MySQL] DECLARE HANDLER 문 사용 방법 및 예시

 
소개

DECLARE ... HANDLER 문은 MySQL의 에러 처리 메커니즘을 제공하는 중요한 기능입니다. 저장 프로시저나 함수에서 발생 가능한 예외나 특정 조건(예: 경고, 에러 등)을 처리할 수 있도록 특별한 핸들러(handler)를 선언하는 데 사용됩니다. 이를 통해 예외 발생 시 프로시저를 강제 중단하지 않고 원하는 작업을 수행하거나 상황을 더 효율적으로 제어할 수 있습니다.

이 문법은 데이터베이스 응용 프로그램의 신뢰성과 안정성을 높이는 데 매우 유용합니다. 이번 포스트에서는 DECLARE ... HANDLER의 문법, 주요 사용법, 그리고 실제 적용 가능한 예제를 자세히 설명하겠습니다.



주요 특징

- 에러를 처리할 방법 지정: 특정 SQLSTATE 코드나 에러 코드가 발생했을 때 실행할 처리 방법을 정의.
- 실행 흐름 제어: 에러 처리 후 계속 실행, 종료, 혹은 반복 구문의 재시작 여부를 설정 가능.
- 다양한 이벤트 처리: 에러뿐만 아니라 경고나 조건 처리도 가능.



문법

DECLARE handler_type HANDLER
FOR {condition | SQLSTATE [VALUE] sqlstate_value | mysql_error_code}
    statement;

-- handler_type:
CONTINUE | EXIT | UNDO

파라미터 설명

- handler_type:
  - CONTINUE: 핸들러 실행 후에도 프로시저를 계속 실행합니다.
  - EXIT: 핸들러 실행 후 현재 블록을 종료하고 외부 블록으로 제어를 이동합니다.
  - UNDO: UNDO 처리(이는 MySQL에서 아직 완전히 지원되지 않음).

- condition: 미리 선언된 조건 이름(SQLSTATE 또는 MySQL 에러 코드) 혹은 기본 제공 상태를 지정.
- SQLSTATE [VALUE] sqlstate_value: SQLSTATE 코드(5자리 문자열)를 직접 지정.
- mysql_error_code: 특정 MySQL 에러 코드를 지정.

- statement: 핸들러 실행 시 수행할 SQL 문 또는 블록.



사용 예시

예제 1: 일반적인 에러 핸들러 선언과 처리
다음 예제는 중복 키 에러 발생 시 이를 적절히 처리하는 핸들러를 설정한 것입니다.

DELIMITER $$

CREATE PROCEDURE handle_duplicate_key_example()
BEGIN
    DECLARE CONTINUE HANDLER FOR SQLSTATE '23000' -- SQLSTATE: 중복 키 에러
    BEGIN
        SET @message = 'Duplicate key error handled! Proceeding with the next step.';
    END;

    -- 중복 키 에러를 유발하는 인서트
    INSERT INTO my_table (id, name) VALUES (1, 'John Doe');

    -- 계속 실행
    INSERT INTO log_table (log_message) VALUES ('Operation completed despite duplicate key error.');
END$$

DELIMITER ;

- 핸들러 설명: SQLSTATE '23000'은 중복 키 에러입니다. 핸들러가 이를 감지하면 에러 메시지를 설정한 후 계속 실행합니다.
- 핸들러 타입: CONTINUE를 지정했기 때문에 에러가 발생해도 프로시저가 강제 종료되지 않음.



예제 2: 특정 에러 발생 시 프로시저 종료
이번에는 특정 조건에서 프로시저 실행을 종료(EXIT)하도록 설정합니다.

DELIMITER $$

CREATE PROCEDURE exit_on_error_example()
BEGIN
    DECLARE EXIT HANDLER FOR SQLEXCEPTION
    BEGIN
        -- 에러 발생 시 처리 로직
        SET @error_message = 'A critical error occurred. Exiting the procedure.';
    END;

    -- 에러를 유발하는 예제
    INSERT INTO non_existing_table (id, name) VALUES (1, 'Test'); -- 테이블이 없어 에러 발생
    -- 이 부분은 실행되지 않음
    INSERT INTO log_table (log_message) VALUES ('This will NOT be executed.');
END$$

DELIMITER ;

- 핸들러 설명: SQLEXCEPTION은 모든 SQL 예외(에러)를 처리합니다.
- 핸들러 타입: EXIT을 사용하기 때문에 에러가 발생하면 현재 블록을 종료합니다.



예제 3: 경고 처리
에러 대신 경고를 처리하는 핸들러를 정의할 수도 있습니다.

DELIMITER $$

CREATE PROCEDURE handle_warning_example()
BEGIN
    DECLARE CONTINUE HANDLER FOR SQLWARNING
    BEGIN
        SET @warning_message = 'A warning occurred, but execution will continue.';
    END;

    -- 경고를 발생시키는 예제
    INSERT INTO my_table (id, name) VALUES (NULL, 'John'); -- NULL ID가 경고를 유발
    -- 핸들러 실행 후 계속 진행
    INSERT INTO log_table (log_message) VALUES ('Operation completed despite warnings.');
END$$

DELIMITER ;

- 핸들러 설명: SQLWARNING은 경고 이벤트를 처리합니다.
- 핸들러 타입: CONTINUE를 사용하므로 경고가 발생해도 실행을 멈추지 않습니다.



장단점 분석

장점
- 효율적인 에러 관리: 복잡한 트랜잭션이나 큰 프로시저 내에서 에러가 발생해도 이를 유연하게 처리.
- 실행 흐름 제어: EXIT, CONTINUE 옵션을 통해 에러 발생 이후 실행 흐름을 명확히 제어 가능.
- 다양한 사례 처리: 에러뿐만 아니라 경고, SQL 상태 코드 등 여러 조건에 대응 가능.

단점
- 초보자에게 복잡할 수 있음: SQLSTATE 코드나 에러 코드를 직접 지정해야 하므로 초보자에게는 직관적으로 느껴지지 않을 수 있음.
- 제어 흐름의 복잡성 증가: 지나치게 많은 핸들러를 설정하면 코드 흐름이 복잡해져 디버깅과 유지보수가 어려워질 수 있음.



결론

DECLARE ... HANDLER 문은 MySQL에서 특정 상황(에러, 경고 등)을 유연하게 처리할 수 있는 강력한 도구입니다. 올바르게 사용하면 실행 중단을 방지하고 데이터 무결성을 유지하면서도 에러와 문제를 명확히 식별할 수 있습니다. 특히 복잡한 로직의 저장 프로시저나 트랜잭션에서 필수적으로 활용될 수 있습니다. 

이제 핸들러를 통해 더 안전한 SQL 스크립트를 작성해 보세요!



참고 자료

- [MySQL 공식 문서: DECLARE ... HANDLER Syntax](https://dev.mysql.com/doc/refman/8.0/en/declare-handler.html)
- [MySQL Error Message Reference](https://dev.mysql.com/doc/refman/8.0/en/error-messages-server.html)