// Référence des erreurs SQL Server

Erreur SQL Server 266 : Incohérence du nombre de transactions après EXECUTE

Une procédure stockée ou un lot s'est terminé avec un nombre de transactions ouvertes différent de celui avec lequel il avait commencé : un BEGIN TRANSACTION sans COMMIT, ou un ROLLBACK de trop.

Numéro d'erreur
266
Sévérité
16
Catégorie
Transactions et verrouillage
Message d'erreur
Transaction count after EXECUTE indicates a mismatching number of BEGIN and COMMIT statements. Previous count = %ld, current count = %ld.

Ce que cela signifie

SQL Server compte les transactions ouvertes dans @@TRANCOUNT. Lorsqu'une procédure stockée, un trigger ou un appel RPC (tel que sp_executesql) retourne, SQL Server compare ce nombre à celui qu'il avait en entrée. S'ils diffèrent, il lève l'erreur 266 pour vous signaler que le module a laissé l'état de la transaction déséquilibré.

L'erreur est un avertissement concernant la structure de votre code de transaction. Le travail à l'intérieur de la procédure a déjà été exécuté ; ce qui se passe ensuite dépend de si l'appelant valide ou annule la transaction encore ouverte, ou s'il n'en a jamais ouvert une qui a été annulée.

Causes courantes

  • Une procédure s'exécute BEGIN TRANSACTION et retourne prématurément (un IF ... RETURN, ou un chemin d'erreur) sans COMMIT ou ROLLBACK.
  • Une procédure s'exécute ROLLBACK TRANSACTION à l'intérieur d'une transaction que son appelant a ouverte. ROLLBACK annule toujours jusqu'à la transaction la plus externe et met @@TRANCOUNT à 0, donc le compte de l'appelant ne correspond plus.
  • Une bibliothèque cliente ou un outil envoie un BEGIN TRANSACTION à travers sp_executesql (un appel RPC) et s'attend à ce qu'il reste ouvert pour des instructions ultérieures.
  • SET XACT_ABORT ON a annulé toute la transaction après une erreur d'exécution à l'intérieur d'une procédure imbriquée.

Comment le corriger

  1. Vérifier @@TRANCOUNT au début de la procédure et n'ouvrir (et ensuite valider) une transaction que lorsqu'il n'y en a pas déjà une. Utilisez un point de sauvegarde pour le travail imbriqué, afin qu'une erreur n'annule que les modifications propres à la procédure.

    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. Remplacez les RETURN instructions à l'intérieur d'une transaction avec un saut vers une seule sortie qui valide ou annule.

  3. Lorsqu'un outil ou un pilote a besoin d'une transaction sur plusieurs instructions, ouvrez-la avec l'API de transaction du pilote ou envoyez BEGIN TRANSACTION en tant que lot simple, et non en tant que paramétré sp_executesql appel.

  4. Si vous voyez 266 avec une autre erreur, corrigez d'abord cette erreur. 266 est souvent le deuxième message consécutif à un échec (par exemple 1205 ou 547) qui a fait annuler la procédure.

Reproduisez-le en toute sécurité

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

Questions

L'erreur 266 annule-t-elle mes modifications ?

Non. 266 lui-même n'annule rien. Les modifications effectuées à l'intérieur de la procédure font toujours partie de la transaction ouverte ; elles sont conservées si l'appelant valide (commit) et annulées s'il annule (rollback). Vérifiez @@TRANCOUNT juste après l'appel.

Pourquoi est-ce que je reçois l'erreur 266 depuis mon application mais pas dans SSMS ?

De nombreux pilotes envoient les instructions paramétrées via sp_executesql, ce qui est un appel RPC que SQL Server vérifie pour un nombre de transactions équilibré. SSMS envoie votre texte comme un lot simple, donc un BEGIN TRANSACTION là-bas reste simplement ouverte.

Erreurs liées

Plus d'erreurs de transactions et de verrouillage

Le code et le texte du message sont issus de Référence des événements et erreurs du moteur de base de données Microsoft. Parcourir la liste complète Liste des erreurs de SQL Server ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur SQL Server dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d’erreur clairs, pour SQL Server et les autres bases de données que vous utilisez.