// справочник ошибок SQL Server

Ошибка SQL Server 266: несоответствие числа транзакций после EXECUTE

Хранимая процедура или пакет завершились с количеством открытых транзакций, отличным от начального: BEGIN TRANSACTION без COMMIT или лишний 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, что является RPC-вызовом, который SQL Server проверяет на сбалансированное количество транзакций. SSMS отправляет ваш текст как обычный пакет, поэтому BEGIN TRANSACTION там он просто остается открытым.

Связанные ошибки

Больше ошибок транзакций и блокировок

Код и текст сообщения взяты из Справочник по событиям и ошибкам Microsoft Database Engine. Смотрите весь Список ошибок SQL Server или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с SQL Server в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для SQL Server и других баз данных, которые вы используете.