T-SQL 오류 처리 구현

Completed

오류는 데이터베이스 작업 중에 발생하는 문제 또는 주목할 만한 문제를 나타냅니다. 오류는 시스템 수준의 이벤트 또는 오류에 대한 응답으로 SQL Server 데이터베이스 엔진에서 생성할 수 있습니다. 또는 Transact-SQL 코드에서 애플리케이션 오류를 생성할 수 있습니다.

데이터베이스 엔진 오류의 요소

원인이 무엇이든 모든 오류는 다음 요소로 구성됩니다.

  • 오류 번호 - 특정 오류를 식별하는 고유 번호입니다.
  • 오류 메시지 - 오류를 설명하는 텍스트입니다.
  • 심각도 - 1에서 25까지의 심각도의 숫자 표시입니다.
  • 상태 - 데이터베이스 엔진 조건에 대한 내부 상태 코드입니다.
  • 프로시저 - 오류가 발생한 저장 프로시저 또는 트리거의 이름입니다.
  • 줄 번호 - 일괄 처리 또는 프로시저에서 오류를 생성한 문입니다.

시스템 오류

시스템 오류는 미리 정의되어 있으며 sys.messages 시스템 보기에서 볼 수 있습니다. 시스템 오류가 발생하면 SQL Server는 오류의 심각도에 따라 자동 수정 작업을 수행할 수 있습니다. 예를 들어 심각도가 높은 오류가 발생하면 SQL Server는 데이터베이스를 오프라인으로 전환하거나 데이터베이스 엔진 서비스를 중지할 수도 있습니다.

사용자 지정 오류

Transact-SQL 코드에서 오류를 생성하여 애플리케이션별 조건에 응답하거나 시스템 오류에 대응하여 클라이언트 애플리케이션에 전송된 정보를 사용자 지정할 수 있습니다. 이러한 애플리케이션 오류는 생성되는 인라인으로 정의하거나 시스템 제공 오류와 함께 sys.messages 테이블에서 미리 정의할 수 있습니다. 사용자 지정 오류에 사용되는 오류 번호는 50001 이상이어야 합니다.

sys.messages에 사용자 지정 오류 메시지를 추가하려면 sp_addmessage 사용합니다. 메시지의 사용자는 sysadmin 또는 serveradmin 고정 서버 역할의 멤버여야 합니다.

sp_addmessage 구문입니다.

sp_addmessage [ @msgnum= ] msg_id , [ @severity= ] severity , [ @msgtext= ] 'msg' 
     [ , [ @lang= ] 'language' ] 
     [ , [ @with_log= ] { 'TRUE' | 'FALSE' } ] 
     [ , [ @replace= ] 'replace' ]

다음은 이 구문을 사용하는 사용자 지정 오류 메시지의 예입니다.

sp_addmessage 50001, 10, N’Unexpected value entered’;

비고

sp_addmessage은 SQL Server 경우에만 지원됩니다. Azure SQL Database 및 Azure SQL Managed Instance sp_addmessage 지원되지 않으므로 50000보다 큰 값을 참조 msg_id 할 수 없습니다. 이러한 플랫폼에서 메시지 문자열과 함께 인라인 RAISERROR 으로 사용하거나 THROW , 대신 메시지 문자열과 FORMATMESSAGE()결합합니다.

또한 사용자 지정 오류 메시지를 정의할 수 있습니다. sysadmin 서버 역할의 멤버는 추가 매개 변수 @with_log 사용할 수도 있습니다. TRUE로 설정하면 Windows 애플리케이션 로그에도 오류가 기록됩니다. Windows 애플리케이션 로그에 기록된 모든 메시지는 SQL Server 오류 로그에도 기록됩니다. 네트워크 및 시스템 관리자는 시스템 로그에서 "번잡한" 애플리케이션을 싫어하는 경향이 있으므로 이 옵션을 사용하는 @with_log 데 주의해야 합니다. 그러나 오류를 경고로 잡아야 하는 경우, 먼저 Windows 애플리케이션 로그에 오류를 기록해야 합니다.

비고

시스템 오류 제기는 지원되지 않습니다.

= 'replace' 옵션을 사용하여 @replace 메시지를 먼저 삭제하지 않고 바꿀 수 있습니다.

메시지는 사용자 지정할 수 있으며 language_id 값에 따라 여러 언어에 대해 동일한 오류 번호에 대해 다른 메시지를 추가할 수 있습니다.

비고

영어 메시지는 language_id 1033입니다.

RAISERROR를 사용하여 오류 발생

비고

RAISERROR 는 새 개발에 사용되지 않습니다. 새 T-SQL 코드에 사용합니다 THROW . RAISERROR 는 레거시 코드, 심각도 수준을 16 이상으로 높이고( THROW 직접 수행할 수 없음), printf-style 동적 메시지 서식 지정(최신 대안이 FORMATMESSAGE()THROW결합됨)에 유용합니다.

둘 다 PRINT 애플리케이션 RAISERROR 에 정보 또는 경고 메시지를 반환하는 데 사용할 수 있습니다. RAISERROR 를 사용하면 애플리케이션이 호출 프로세스에 의해 catch될 수 있는 오류를 발생시킬 수 있습니다.

RAISERROR

T-SQL에서 오류를 발생시키는 기능을 사용하면 다른 시스템 오류처럼 전송되므로 애플리케이션에서 오류를 더 쉽게 처리할 수 있습니다. RAISERROR 는 다음을 위해 사용됩니다.

  • T-SQL 코드 문제를 해결하는 데 도움을 주세요.
  • 데이터의 값을 확인합니다.
  • 변수 텍스트가 포함된 메시지를 반환합니다.

비고

PRINT 문을 사용하는 것은 심각도 10 오류를 발생시키는 것과 유사합니다.

다음은 .를 사용하는 RAISERROR사용자 지정 오류 메시지의 예입니다.

RAISERROR (N'%s %d', -- Message text,
    10, -- Severity,
    1, -- State,
    N'Custom error message number',
    2)

트리거되면 다음을 반환합니다.

Custom error message number 2

이전 예제에서 %d 숫자의 자리 표시자이며 %s 문자열의 자리 표시자입니다. 또한 메시지 번호는 언급되지 않았습니다. 이 구문을 사용하여 메시지 문자열 오류가 발생하는 경우 오류 번호는 항상 50000입니다.

THROW를 사용하여 오류 발생

이 문은 THROW 코드에서 오류를 발생시키는 간단한 방법을 제공하며 새로운 T-SQL 개발에 권장되는 방법입니다. 오류의 오류 수는 50000 이상이어야 합니다.

THROW

THROW 는 RAISERROR 다음과 같은 여러 가지 방법으로 다릅니다.

  • THROW 새 예외가 발생하면 심각도는 항상 16입니다. 기존 예외(블록 내 CATCH 의 매개 변수 없음THROW)를 다시 throw하는 데 사용되는 경우 THROW 원래 예외의 심각도가 유지되므로 블록에서 CATCH 시스템 오류를 다시 발생시키는 데 매개 변수가 없는 THROW 것이 좋습니다.
  • 반환된 THROW 메시지는 .의 항목과 sys.messages관련이 없습니다.
  • THROW명예 .SET XACT_ABORT 활성 상태이면 SET XACT_ABORT ON 현재 트랜잭션을 자동으로 롤백하여 THROW 발생하는 예외가 발생합니다. RAISERROR 는 새 SET XACT_ABORT개발에 선호되는 주된 이유 THROW 중 하나입니다.

Important

바로 앞에 THROW 있는 문은 세미콜론(;)으로 끝나야 합니다. 그렇지 않으면 구문 오류가 발생합니다. 이는 세미콜론을 생략하는 THROW 기존 코드에서 채택할 때 일반적인 걸림돌입니다.

; THROW 50001, 'An error occurred', 1;

@@Error 사용하여 오류 코드 캡처

SQL Server 애플리케이션에서 가장 일반적인 오류 처리 코드는 .를 사용하여 @@ERROR만들어졌습니다. 구조적 예외 처리는 사용에 @@ERROR 대한 보다 강력한 대안을 제공하며 새 T-SQL 코드에 권장되는 방법입니다. 다음 단원에서 설명합니다. 많은 양의 기존 SQL Server 오류 처리 코드가 기반으로 @@ERROR하므로 이를 사용하는 방법을 이해하는 것이 중요합니다.

오류 발생

@@ERROR 는 발생한 마지막 오류의 오류 번호를 보유하는 시스템 변수입니다. 한 가지 중요한 과제 @@ERROR 는 각 추가 문이 실행될 때 보유하는 값이 빠르게 다시 설정된다는 것입니다.

예를 들어 다음 코드를 고려합니다.

RAISERROR(N'Message', 16, 1);
IF @@ERROR <> 0
PRINT 'Error=' + CAST(@@ERROR AS VARCHAR(8));
GO

코드가 실행되면 인쇄된 문자열에 오류 번호가 반환될 것으로 예상할 수 있습니다. 그러나 코드가 실행되면 다음을 반환합니다.

Msg 50000, Level 16, State 1, Line 1
Message
Error=0

오류가 발생했지만 인쇄된 메시지는 "Error=0"입니다. 출력의 첫 번째 줄에서 예상대로 오류가 실제로 50000이었으며 메시지가 전달된 것을 RAISERROR볼 수 있습니다. 문 IF 다음에 RAISERROR 오는 문이 성공적으로 실행되어 값이 @@ERROR 다시 설정되었기 때문입니다. 이러한 이유로 작업 @@ERROR할 때 오류 번호가 발생하는 즉시 변수로 캡처한 다음 변수로 처리를 계속하는 것이 중요합니다.

이를 보여 주는 다음 코드를 살펴봅니다.

DECLARE @ErrorValue int;
RAISERROR(N'Message', 16, 1);
SET @ErrorValue = @@ERROR;
IF @ErrorValue <> 0
PRINT 'Error=' + CAST(@ErrorValue AS VARCHAR(8));

이 코드가 실행되면 다음 출력이 반환됩니다.

Msg 50000, Level 16, State 1, Line 2
Message
Error=50000

오류 번호가 지금 올바르게 보고됩니다.

오류 처리 중앙 집중화

오류 처리에 사용할 @@ERROR 때 발생하는 다른 중요한 문제 중 하나는 T-SQL 코드 내에서 중앙 집중화하기 어렵다는 점입니다. 오류 처리는 코드 전체에 분산되는 경향이 있습니다. 레이블 및 GOTO 문을 사용하여 @@ERROR 오류 처리를 어느 정도 중앙 집중화할 수 있습니다. 그러나, 이것은 가난한 코딩 관행으로 오늘날 대부분의 개발자에 의해 눈살을 찌푸리게 될 것입니다.

오류 경고 만들기

특정 오류 범주의 경우 관리자가 SQL Server 경고를 만들 수 있습니다. 이러한 경고가 발생하는 즉시 알림을 받을 수 있기 때문입니다. 사용자 정의 오류 메시지에도 적용할 수 있습니다. 예를 들어 트랜잭션 로그가 채워질 때마다 경고를 발생시키고 싶을 수 있습니다. 경고는 일반적으로 관리자의 주의에 높은 심각도 오류(예: 심각도 19 이상)를 가져오는 데 사용됩니다.

경고 발생

특정 오류 메시지에 대한 경고를 만들 수 있습니다. 경고 서비스는 자신을 이벤트 로깅 서비스에 콜백 서비스로 등록하여 작동합니다. 즉, 경고는 기록된 오류에서만 작동합니다.

오류를 발생시키는 방법에는 두 가지가 있습니다. 오류를 발생시킬 때 WITH LOG 옵션을 사용하거나 메시지를 변경하여 sp_altermessage 실행하여 기록할 수 있습니다. WITH LOG 옵션은 현재 문에만 영향을 줍니다. sp_altermessage 사용하면 향후 모든 사용에 대한 오류 동작이 변경됩니다.