// SQL Server-Fehlerreferenz

SQL Server-Fehler 266: Transaktionsanzahl stimmt nach EXECUTE nicht überein

Eine gespeicherte Prozedur oder ein Batch endete mit einer anderen Anzahl offener Transaktionen als zu Beginn: ein BEGIN TRANSACTION ohne COMMIT oder ein ROLLBACK zu viel.

Fehlernummer
266
Schweregrad
16
Kategorie
Transaktionen und Sperren
Fehlermeldung
Transaction count after EXECUTE indicates a mismatching number of BEGIN and COMMIT statements. Previous count = %ld, current count = %ld.

Was es bedeutet

SQL Server zählt offene Transaktionen in @@TRANCOUNT. Wenn eine gespeicherte Prozedur, ein Trigger oder ein RPC-Aufruf (wie sp_executesql) zurückkehrt, vergleicht SQL Server die Anzahl mit dem Wert beim Eintritt. Weichen sie ab, kommt Fehler 266, der dir sagt, dass das Modul den Transaktionszustand unausgeglichen verlassen hat.

Der Fehler ist eine Warnung zur Form deines Transaktionscodes. Die Arbeit in der Prozedur ist bereits gelaufen; was danach passiert, hängt davon ab, ob der Aufrufer die noch offene Transaktion committet oder zurückrollt, oder nie eine geöffnet hat, die zurückgerollt wurde.

Häufige Ursachen

  • Eine Prozedur wird BEGIN TRANSACTION und kehrt frühzeitig zurück (ein IF ... RETURN, oder ein Fehlerpfad) ohne COMMIT oder ROLLBACK.
  • Eine Prozedur wird ROLLBACK TRANSACTION innerhalb einer Transaktion, die sein Aufrufer geöffnet hat. ROLLBACK rollt immer zur äußersten Transaktion zurück und setzt @@TRANCOUNT auf 0, sodass die Zählung des Aufrufers nicht mehr übereinstimmt.
  • Eine Client-Bibliothek oder ein Tool sendet einen BEGIN TRANSACTION durch sp_executesql (einen RPC-Aufruf) und erwartet, dass er für spätere Anweisungen offen bleibt.
  • SET XACT_ABORT ON hat die gesamte Transaktion nach einem Laufzeitfehler innerhalb einer verschachtelten Prozedur zurückgerollt.

Wie du es behebst

  1. Prüfen @@TRANCOUNT am Anfang der Prozedur und öffne (und später committe) eine Transaktion nur, wenn nicht schon eine läuft. Verwende einen Savepoint für verschachtelte Arbeiten, damit ein Fehler nur die Änderungen der Prozedur selbst zurückrollt.

    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. Sorg dafür, dass jeder Ausgangspfad die Transaktion ausgleicht. Ersetze das nackte RETURN Anweisungen innerhalb einer Transaktion durch einen Sprung zu einem einzigen Ausgang, der entweder bestätigt oder zurückgesetzt wird.

  3. Wenn ein Tool oder Treiber eine Transaktion über mehrere Anweisungen hinweg braucht, öffne sie über die Transaktions-API des Treibers oder sende BEGIN TRANSACTION als einfache Batch und nicht als parameterisierten sp_executesql Aufruf.

  4. Wenn du 266 zusammen mit einem anderen Fehler siehst, behebe zuerst diesen Fehler. 266 ist oft die zweite Meldung, nachdem ein Fehler (zum Beispiel 1205 oder 547) die Prozedur zurückrollen ließ.

Sicher reproduzieren

-- 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;

Fragen

Rollt Fehler 266 meine Änderungen zurück?

Nein. 266 selbst macht nichts rückgängig. Die Änderungen innerhalb der Prozedur sind weiterhin Teil der jeweils offenen Transaktion; sie bleiben erhalten, wenn der Aufrufer committet, und werden rückgängig gemacht, wenn er zurückrollt. Prüfe @@TRANCOUNT direkt nach dem Aufruf.

Warum erhalte ich 266 von meiner Anwendung, aber nicht in SSMS?

Viele Treiber senden parametrisierte Anweisungen über sp_executesql, was ein RPC-Aufruf ist, bei dem SQL Server auf eine ausgeglichene Transaktionsanzahl prüft. SSMS sendet deinen Text als einfaches Batch, sodass ein BEGIN TRANSACTION dort einfach offen bleibt.

Zugehörige Fehler

Weitere Transaktions- und Sperrfehler

Der Code und der Meldungstext stammen aus der Microsoft Database Engine-Ereignisse und Fehlernachschlagewerk. Durchstöbere die vollständige SQL Server-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit SQL Server in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für SQL Server und die anderen Datenbanken, mit denen du arbeitest.