// 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)によってプロシージャがロールバックされた後に出る、2 番目のメッセージであることがよくあります。

安全に再現する

-- 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 呼び出しの直後です。

SSMS では出ないのに、アプリケーションからだとエラー 266 が出るのはなぜですか?

多くのドライバーがパラメーター化ステートメントを送る経路は sp_executesql、これは SQL Server がトランザクション数のバランスを確認する RPC 呼び出しです。SSMS はテキストをプレーンなバッチとして送信するため、 BEGIN TRANSACTION その場で開いたままになります。

関連エラー

その他のトランザクションとロックのエラー

コードとメッセージのテキストは、 Microsoft Database Engine のイベントとエラーのリファレンス。全容は次で参照 SQL Server エラー一覧 または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で SQL Server を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、SQL Server をはじめ、お使いの他のデータベースにも対応します。