// SQL Server 오류 참조

SQL Server 오류 266: EXECUTE 이후 트랜잭션 수 불일치

저장 프로시저나 배치가 시작했을 때와 개수가 다른 열린 트랜잭션을 남긴 채 끝났습니다: COMMIT 없이 BEGIN TRANSACTION을 했거나, ROLLBACK을 한 번 많이 한 경우입니다.

오류 번호
266
심각도
16
카테고리
트랜잭션과 잠금
오류 메시지
Transaction count after EXECUTE indicates a mismatching number of BEGIN and COMMIT statements. Previous count = %ld, current count = %ld.

의미

SQL Server가 열려 있는 트랜잭션을 세는 곳은 @@TRANCOUNT. 저장 프로시저, 트리거 또는 RPC 호출(예를 들어 sp_executesql) 실행이 끝나면 SQL Server는 진입 때 저장해 둔 개수와 반환 시의 개수를 비교합니다. 서로 다르면 오류 266을 내는데, 해당 모듈이 트랜잭션 상태를 원래대로 맞추지 않고 나왔음을 알려 주는 것입니다.

이 오류는 트랜잭션 코드 구조에 대한 경고입니다. 프로시저 안의 작업은 이미 실행되었으며, 이후 일은 호출자가 아직 열려 있는 트랜잭션을 커밋하는지, 롤백하는지, 아니면 열었던 트랜잭션이 이미 롤백되어 없는 상태인지에 달려 있습니다.

일반적인 원인

  • 프로시저가 BEGIN TRANSACTION 조기에 반환합니다( IF ... RETURN, 또는 오류 경로)에서 COMMIT 또는 ROLLBACK.
  • 프로시저가 ROLLBACK TRANSACTION 호출자가 연 트랜잭션 안에서 실행됩니다. ROLLBACK 항상 가장 바깥쪽 트랜잭션으로 롤백하고 @@TRANCOUNT 를 0으로 설정하므로 호출자의 카운트가 더 이상 일치하지 않습니다.
  • 클라이언트 라이브러리나 도구가 BEGIN TRANSACTION 을 통해 sp_executesql (RPC 호출) 하나를 보내고 이후 문들을 위해 그 연결이 열려 있을 것으로 기대합니다.
  • SET XACT_ABORT ON 중첩된 프로시저 내 런타임 오류 후 전체 트랜잭션을 롤백했습니다.

해결 방법

  1. 확인 @@TRANCOUNT 프로시저 시작 시 확인하고 트랜잭션이 아직 없을 때만 열어 (나중에 커밋하고) 쓰세요. 중첩된 작업에는 세이브포인트를 써서 오류가 프로시저 자신의 변경만 롤백하도록 하세요.

    CREATE OR ALTER PROCEDURE dbo.TransferFunds @From int, @To int, @Amount money
    AS
    BEGIN
        SET NOCOUNT ON;
        DECLARE @OwnTran bit = CASE WHEN @@TRANCOUNT = 0 THEN 1 ELSE 0 END;
        IF @OwnTran = 1 BEGIN TRANSACTION;
        ELSE SAVE TRANSACTION TransferFunds;
        BEGIN TRY
            UPDATE dbo.Accounts SET Balance -= @Amount WHERE AccountId = @From;
            UPDATE dbo.Accounts SET Balance += @Amount WHERE AccountId = @To;
            IF @OwnTran = 1 COMMIT TRANSACTION;
        END TRY
        BEGIN CATCH
            IF @OwnTran = 1 AND @@TRANCOUNT > 0 ROLLBACK TRANSACTION;
            ELSE IF XACT_STATE() = 1 ROLLBACK TRANSACTION TransferFunds;
            THROW;
        END CATCH
    END;
  2. 모든 종료 경로가 트랜잭션의 균형을 맞추도록 하세요. 단독으로 쓴 RETURN 하나의 종료 지점으로 점프하여 커밋하거나 롤백하는 트랜잭션 내의 명령문.

  3. 도구나 드라이버가 여러 문장에 걸치는 트랜잭션이 필요하면 드라이버의 트랜잭션 API로 열거나 다음을 전송하세요 BEGIN TRANSACTION 매개변수가 아니라 일반 배치로 sp_executesql 호출.

  4. 266과 다른 오류가 함께 나타난다면, 먼저 그 오류를 수정하세요. 266은 종종 실패(예: 1205 또는 547)로 프로시저가 롤백된 뒤 나타나는 두 번째 메시지입니다.

안전하게 재현하세요

-- Run on a scratch database.
CREATE OR ALTER PROCEDURE dbo.LeavesTranOpen AS BEGIN TRANSACTION;
GO
EXEC dbo.LeavesTranOpen;   -- Msg 266: Previous count = 0, current count = 1
SELECT @@TRANCOUNT;        -- 1: the transaction is still open
ROLLBACK;
DROP PROCEDURE dbo.LeavesTranOpen;

질문

266 오류가 내 변경 사항을 롤백하나요?

아니요. 오류 266 자체는 아무것도 롤백하지 않습니다. 프로시저 안에서 이뤄진 변경은 여전히 열려 있는 트랜잭션의 일부이며, 호출자가 커밋하면 유지되고 롤백하면 취소됩니다. 이어서 확인할 것은 @@TRANCOUNT 호출 직후에.

왜 제 애플리케이션에서는 266이 나오는데 SSMS에서는 나오지 않나요?

많은 드라이버가 매개변수화된 문을 다음을 통해 전송합니다: sp_executesql, SQL Server가 트랜잭션 수의 균형을 확인하는 RPC 호출입니다. SSMS는 입력을 그냥 일반 배치로 보내기 때문에 BEGIN TRANSACTION 그냥 열려 있다.

관련 오류

그 밖의 트랜잭션 및 잠금 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 Microsoft 데이터베이스 엔진 이벤트 및 오류 참조. 전체 목록은 SQL Server 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 SQL Server 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. SQL Server는 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.