Ошибка SQL Server 266: несоответствие числа транзакций после EXECUTE
Хранимая процедура или пакет завершились с количеством открытых транзакций, отличным от начального: BEGIN TRANSACTION без COMMIT или лишний ROLLBACK.
- Номер ошибки
266- Уровень серьёзности
- 16
- Категория
- Транзакции и блокировки
Что это значит
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откатывал всю транзакцию при ошибке времени выполнения внутри вложенной процедуры.
Как исправить
-
Проверить
@@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; -
Сделайте так, чтобы каждый путь выхода уравновешивал транзакцию. Замените голые
RETURNоператоры внутри транзакции с переходом к единственной точке выхода, которая выполняет фиксацию или откат. -
Когда инструмент или драйвер требует транзакцию через несколько операторов, откройте её с помощью API транзакций драйвера или отправьте
BEGIN TRANSACTIONкак обычный пакет, а не как параметризованныйsp_executesqlвызов. -
Если вы видите 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 там он просто остается открытым.
Связанные ошибки
3902COMMIT не имеет соответствующего BEGIN3903Для ROLLBACK нет соответствующего BEGIN3930Транзакция не может быть зафиксирована1205Взаимоблокировка: транзакция выбрана жертвой3609Транзакция завершилась в триггере
Больше ошибок транзакций и блокировок
1222Превышен период ожидания запроса блокировки3960Конфликт обновления в режиме изоляции снимка3616Ошибка, возникшая во время выполнения триггера6401Транзакция или точка сохранения не найдены3998Транзакция, которую невозможно зафиксировать, откачена3621Выполнение инструкции прервано
Код и текст сообщения взяты из Справочник по событиям и ошибкам Microsoft Database Engine. Смотрите весь Список ошибок SQL Server или поиск по всем ошибкам баз данных.
Работа с SQL Server в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для SQL Server и других баз данных, которые вы используете.