Bonjour,
Cette librairie a été conçue pour être utilisée avec SQL Server.
Elle utilise les interfaces IDbConnection et IDbCommand afin d'être compatible aussi avec OleDbConnection et OdbcConnection, mais aussi pour vous premettre de la rendre compatible avec le SGBD de votre choix s'il supporte les transactions imbriquées ou les points de sauvegarde de transaction.
L'objet SqlTransaction ne supporte pas d'ouvrir deux transactions imbriquées.
Idem avec OleDbTransaction.
Pourtant, lorsqu'on a un long traitement, pouvoir imbriquer des transactions, c'est bien plus pratique que de gérer manuellement des Save() et ne plus trop savoir à quel savepoint on doit remonter lorsqu'on souhaite annuler une opération.
Limitation connues :
- SQL Server ne supporte pas les transactions imbriquées. A la place, il supporte les "savepoints". Il s'agit de commit intermédiaires au sein d'une unique transaction, qui permettent, lors d'un rollback, de choisir si on annule toute la transaction, ou seulement ce qui a été modifié depuis un savepoint donné. Donc une fois "à l'intérieur" d'une transaction imbriquées, vous devez la valider ou l'annuler avant de pouvoir modifier la transaction parente. Pour information, Oracle, qui est un des rares SGBD à supporter les transactions imbriquées ne recommande de toute façon pas de modifier une transaction parente lorsqu'une transaction imbriquée est active : en effet, on peut très aisément se retrouver avec un deadlock si la transaction mère tente de modifier des données modifiées par la transaction imbriquée. Pour que la notion d'imbrication soit lisible, utilisez des using() pour chaque objet MyTransaction.
- Le niveau de transaction en cours est stocké au niveau d'objet IDbConnexion. Donc si vous croyez faire une requête en dehors de la transaction en utilisant directement un cnx.CreateCommand, votre requête sera malgré tout exécutée au sein de la transaction en cours.
- MyTransaction.CreateNestedTransaction() retourne une nouvelle transaction [g]à la suite de la transaction en cours[/g], et n'a absolument rien à voir avec l'instance de MyTransaction qui a créé la nouvelle transaction. Il n'y a aucun moyen de faire autrement, ou alors demandez à Microsoft de supporter les transactions imbriquées
- MyTransaction.CreateCommand() retourne un nouvel objet IDbCommand qui utilise [g]la transaction en cours[/g], et n'a absolument rien à voir avec l'instance de MyTransaction qui a créé la nouvelle transaction. Il n'y a aucun moyen de faire autrement, ou alors demandez de nouveau à Microsoft de supporter les transactions imbriquées
- Le code devrait être threadsafe. Il n'a cependant pas été testé dans un tel contexte.
- Il faut impérativement faire un Begin() et Commit()/Rollback() pour chaque transaction crée.
Code qui ne marche pas : a la sortie du using(cnx), la transaction A n'est pas commitée. Un rollback se produit alors sur l'ensemble de la transaction ! A droite, le code SQL exécuté :
Code qui marche :
Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
6
7
8
9
10
11 using (SqlConnexion cnx = new SqlConnexion(cnx_string)) { MyTransaction tranA = new MyTransaction(cnx); tranA.Begin(); BEGIN TRANSACTION [...] MyTransaction tranB = tranA.CreateNestedTransaction(); tranB.Begin(); SAVE TRANSACTION nested [...] tranA.Commit(); }
Voici le code, que j'ai essayé de documenter au maximum :
Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
6
7
8
9
10
11
12 using (SqlConnexion cnx = new SqlConnexion(cnx_string)) { MyTransaction tranA = new MyTransaction(cnx); tranA.Begin(); BEGIN TRANSACTION [...] MyTransaction tranB = tranA.CreateNestedTransaction(); tranB.Begin(); SAVE TRANSACTION nested [...] tranB.Commit(); tranA.Commit(); COMMIT TRANSACTION }
Code c# : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199 using System; using System.Data; namespace CustomTransaction { /// <summary> /// Objet qui permet d'effectuer des transactions imbriquées. /// On ne catch absolument aucune erreur volontairement. /// Cette librairie a été écrite pour SQL Server, même si elle utilise l'interface IDbConnexion. /// Pour créer une transaction imbriquée, on peut uiliser au choix l'un ou l'autre constructeur de MyTransaction, ou la méthode CreateNestedTransaction. /// </summary> public class MyTransaction : IDisposable { // Private attributes IDbConnection Cnx; bool IsActive = false; string Name = string.Empty; const int NAME_LENGTH = 4; /// <summary> /// Créée une transaction liée à la connexion. /// </summary> /// <param name="cnx">Connexion ouverte à la base de données.</param> public MyTransaction(IDbConnection cnx) { // On stocke la connexion. Cnx = cnx; // On crée un nom aléatoire pour la transaction. if (MyTransactionContext.Level > 0) { string lettres = "abcdefghijklmnopqrstuvwxyz"; char[] name = new char[NAME_LENGTH + 2]; name[0] = '['; name[NAME_LENGTH + 1] = ']'; for (int i = 1; i <= NAME_LENGTH; i++) { name[i] = lettres[MyRandom.Next(0, 26)]; } Name = string.Concat(name); } } /// <summary> /// Créée une transaction imbriquée. /// </summary> /// <param name="parent">Transaction mère.</param> public MyTransaction(MyTransaction parent) : this(parent.Cnx) { } /// <summary> /// Débute une transaction /// </summary> public void Begin() { // Si un jour on souhaite que la classe soit threadsafe, c'est mieux de poser un lock lock (this) { using (IDbCommand cmd = Cnx.CreateCommand()) { if (MyTransactionContext.Level == 0) { // On est au premier niveau, on commence donc une transaction réelle cmd.CommandText = "BEGIN TRANSACTION"; } else { // On est dans une transaction imbriquée : en réalité, il s'agit d'un savepoint cmd.CommandText = string.Format("SAVE TRANSACTION {0}", Name); } cmd.ExecuteNonQuery(); } // La transaction est démarrée IsActive = true; MyTransactionContext.Level++; } } /// <summary> /// Valide la transaction /// </summary> public void Commit() { // Si un jour on souhaite que la classe soit threadsafe, c'est mieux de poser un lock lock (this) { if (IsActive) { using (IDbCommand cmd = Cnx.CreateCommand()) { if (--MyTransactionContext.Level == 0) { // On est au premier niveau, on commit donc la transaction cmd.CommandText = "COMMIT"; cmd.ExecuteNonQuery(); } // Si on n'est pas au niveau 0, on ne fait rien de plus, puisque nous sommes dans un savepoint } // La transaction est terminée IsActive = false; } } } /// <summary> /// Annule la transaction /// </summary> public void Rollback() { // Si un jour on souhaite que la classe soit threadsafe, c'est mieux de poser un lock lock (this) { if (IsActive) { using (IDbCommand cmd = Cnx.CreateCommand()) { if (--MyTransactionContext.Level == 0) { // On est au premier niveau, on annule dont toute la transaction cmd.CommandText = "ROLLBACK"; } else { // On est dans une transaction imbriquée, on annule jusqu'au savepoint qui a débuté la transaction cmd.CommandText = string.Format("ROLLBACK TRANSACTION {0}", Name); } cmd.ExecuteNonQuery(); } // La transaction est terminée IsActive = false; } } } /// <summary> /// Crée un IDbCommand à partir de la connexion. Cet objet Command sera utilisé dans la transaction. /// </summary> /// <returns>Nouvel objet Command</returns> public IDbCommand CreateCommand() { return Cnx.CreateCommand(); } /// <summary> /// Crée une transaction imbriquée. /// </summary> /// <returns>Nouvelle transaction imbriquée.</returns> public MyTransaction CreateNestedTransaction() { return new MyTransaction(this); } /// <summary> /// Rollback implicite de la transaction si elle est encore active. /// </summary> public void Dispose() { // Le test pour savoir si la transaction est active est déjà pris en compte dans la méthode Rollback() Rollback(); } /// <summary> /// Classe statique qui permet d'avoir un Random unique pour toutes les classes /// et éviter ainsi de générer systématiquement les mêmes séries /// </summary> private static class MyRandom { private static Random rnd; static MyRandom() { rnd = new Random(); } public static int Next(int min, int max) { return rnd.Next(min, max); } } /// <summary> /// Niveau actuel d'imbrication de transaction /// Attention, si vous avec des connexions dans des threads séparés, vous allez avoir des problèmes ! /// </summary> private static class MyTransactionContext { [ThreadStatic] public static int Level; static MyTransactionContext() { Level = 0; } } } }
Comment l'utiliser :
Création d'une transaction à partir d'une connexion (qui doit impérativement être ouverte) :
Création d'une transaction imbriquée :
Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2 MyTransaction tranA = new MyTransaction(maSqlConnexion);
Ces trois syntaxes sont absolument équivalentes.
Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
6 MyTransaction tranB = new MyTransaction(maSqlConnexion); // ou MyTransaction tranB = new MyTransaction(tranA); // ou MyTransaction tranB = tranA.CreateNestedTransaction();
La transaction tranB n'est pas dépendante de la transaction tranA. Elle est juste ajoutée à la suite des transactions en cours dans l'objet maSqlConnexion.
Création d'un object IDbCommand utilisant la transaction en cours :
Les deux syntaxes sont absolument équivalentes, l'objet IDbCommand créé n'étant absolument pas lié à l'objet MyTransaction qui l'a créé.
Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4 maSqlConnexion.CreateCommand(); // ou tranA.CreateCommand();
Début de la transaction :
Validation de la transaction :
Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2 tranA.Begin();
Annullation de la transaction :
Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2 tranA.Begin();
Et un exemple complet d'utilisation :
Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2 tranA.Rollback();
Ce qui donne :
Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158 using System; using System.Data; using System.Data.Sql; using System.Data.SqlClient; using CustomTransaction; namespace TestNestedTransaction { class Program { static void Main(string[] args) { Console.WriteLine("Utilisation de transactions imbriquée (B imbriquée dans A)"); Console.WriteLine("On utilise une librairie custom qui simule une transaction."); using (SqlConnection cnx = new SqlConnection("Server=localhost\\SQLEXPRESS;Database=testlock;Trusted_Connection=True;")) { cnx.Open(); using (SqlCommand cmd = cnx.CreateCommand()) { cmd.CommandText = "insert into test (name) values (@name);"; SqlParameter pName = cmd.Parameters.Add("name", SqlDbType.VarChar, 50); Console.WriteLine(); Console.WriteLine("Cas 1 :"); Console.WriteLine("- Une simple transaction committée"); Console.WriteLine("On s'attend à ce que la ligne reste dans la base"); using (MyTransaction tranA = new MyTransaction(cnx)) { tranA.Begin(); pName.Value = "Cas 1, transaction seule"; cmd.ExecuteNonQuery(); tranA.Commit(); } Console.WriteLine(); Console.WriteLine("Cas 2 :"); Console.WriteLine("- Une simple transaction rollbackée"); Console.WriteLine("On s'attend à ce qu'aucune ligne ne reste dans la base"); using (MyTransaction tranA = new MyTransaction(cnx)) { tranA.Begin(); pName.Value = "Cas 2, transaction seule"; cmd.ExecuteNonQuery(); tranA.Rollback(); } Console.WriteLine(); Console.WriteLine("Cas 3 :"); Console.WriteLine("- La transaction parente est rollbackée"); Console.WriteLine("- La transaction fille est committée"); Console.WriteLine("On s'attend à ce qu'aucune ligne ne reste dans la base"); using (MyTransaction tranA = new MyTransaction(cnx)) { tranA.Begin(); pName.Value = "Cas 3, transaction parente"; cmd.ExecuteNonQuery(); using (MyTransaction tranB = new MyTransaction(cnx)) { tranB.Begin(); pName.Value = "Cas 3, transaction fille"; cmd.ExecuteNonQuery(); tranB.Commit(); } tranA.Rollback(); } Console.WriteLine(); Console.WriteLine("Cas 4 :"); Console.WriteLine("- La transaction parente est committée"); Console.WriteLine("- La transaction fille est rollbackée"); Console.WriteLine("On s'attend à ce que seule la ligne de la transaction parente soit dans la base"); using (MyTransaction tranA = new MyTransaction(cnx)) { tranA.Begin(); pName.Value = "Cas 4, transaction parente"; cmd.ExecuteNonQuery(); using (MyTransaction tranB = new MyTransaction(cnx)) { tranB.Begin(); pName.Value = "Cas 4, transaction fille"; cmd.ExecuteNonQuery(); tranB.Rollback(); } tranA.Commit(); } Console.WriteLine(); Console.WriteLine("Cas 5 :"); Console.WriteLine("- La transaction parente est committée"); Console.WriteLine("- La transaction fille est committée"); Console.WriteLine("On s'attend à ce que les deux lignes soient dans la base"); using (MyTransaction tranA = new MyTransaction(cnx)) { tranA.Begin(); pName.Value = "Cas 5, transaction parente"; cmd.ExecuteNonQuery(); using (MyTransaction tranB = new MyTransaction(cnx)) { tranB.Begin(); pName.Value = "Cas 5, transaction fille"; cmd.ExecuteNonQuery(); tranB.Commit(); } tranA.Commit(); } Console.WriteLine(); Console.WriteLine("Cas 6 :"); Console.WriteLine("- La transaction parente est rollbackée"); Console.WriteLine("- La transaction fille est rollbackée"); Console.WriteLine("On s'attend à ce qu'aucune ligne ne soit dans la base"); using (MyTransaction tranA = new MyTransaction(cnx)) { tranA.Begin(); pName.Value = "Cas 6, transaction parente"; cmd.ExecuteNonQuery(); using (MyTransaction tranB = new MyTransaction(cnx)) { tranB.Begin(); pName.Value = "Cas 6, transaction fille"; cmd.ExecuteNonQuery(); tranB.Rollback(); } tranA.Rollback(); } Console.WriteLine(); Console.WriteLine("Résultat :"); cmd.CommandText = "select id, name from test order by id;"; cmd.Parameters.Clear(); Console.WriteLine("ID\tNAME"); Console.WriteLine("------- --------------------------------------------------"); SqlDataReader da = cmd.ExecuteReader(); while (da.Read()) { Console.WriteLine("{0}\t{1}", da.GetInt32(0), da.GetString(1)); } } cnx.Close(); } Console.WriteLine(); Console.WriteLine("Fin"); Console.ReadKey(true); } } }
Code : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41 Utilisation de transactions imbriquée (B imbriquée dans A) On utilise une librairie custom qui simule une transaction imbriquée. Cas 1 : - Une simple transaction committée On s'attend à ce que la ligne reste dans la base Cas 2 : - Une simple transaction rollbackée On s'attend à ce qu'aucune ligne ne reste dans la base Cas 3 : - La transaction parente est rollbackée - La transaction fille est committée On s'attend à ce qu'aucune ligne ne reste dans la base Cas 4 : - La transaction parente est committée - La transaction fille est rollbackée On s'attend à ce que seule la ligne de la transaction parente soit dans la base Cas 5 : - La transaction parente est committée - La transaction fille est committée On s'attend à ce que les deux lignes soient dans la base Cas 6 : - La transaction parente est rollbackée - La transaction fille est rollbackée On s'attend à ce qu'aucune ligne ne soit dans la base Résultat : ID NAME ------- -------------------------------------------------- 56 Cas 1, transaction seule 60 Cas 4, transaction parente 62 Cas 5, transaction parente 63 Cas 5, transaction fille Fin
Partager