Accueil › Node.js › Les transactions depuis le code
Les transactions depuis le code
Parler à une base de donnéesintermediaire
Une transaction est une propriété de la connexion. BEGIN l'ouvre sur la
connexion qui l'exécute, et seules les requêtes envoyées sur cette même
connexion en font partie.
export async function transferer(deId, versId, montant) {
const client = await pool.connect();
try {
await client.query("BEGIN");
await client.query(
"UPDATE comptes SET solde = solde - $1 WHERE id = $2",
[montant, deId],
);
await client.query(
"UPDATE comptes SET solde = solde + $1 WHERE id = $2",
[montant, versId],
);
await client.query("COMMIT");
} catch (err) {
await client.query("ROLLBACK");
throw err; // on annule, puis on laisse remonter
} finally {
client.release();
}
}
Quatre éléments, et aucun n'est facultatif : le client emprunté, le BEGIN,
le ROLLBACK dans le catch, le release() dans le finally.
Le bogue numéro un
await client.query("BEGIN");
await pool.query("UPDATE comptes SET solde = solde - 100 WHERE id = 1"); // ⛔
await client.query("COMMIT");
pool.query emprunte une autre connexion. Cet UPDATE n'est pas dans la
transaction : il est validé immédiatement, tout seul. Rien ne lève d'erreur, et
tout paraît fonctionner — jusqu'au premier échec partiel, où le ROLLBACK
n'annule rien parce qu'il n'avait rien à annuler.
Jamais d'appel réseau lent dedans
Entre BEGIN et COMMIT, vous tenez une connexion de la réserve et des
verrous sur les lignes modifiées. Un appel à un service de paiement de deux
secondes, c'est deux secondes de verrous. Avec dix connexions et dix appels
simultanés, l'API entière est bloquée.
Les termes à connaître
- Transaction
Un groupe de requêtes qui réussit ou échoue en bloc. Encadrée par
BEGINetCOMMIT, annulée parROLLBACK. C'est une propriété de la connexion, pas de la base.- `BEGIN`
Ouvre une transaction sur la connexion qui l'exécute. Toutes les requêtes suivantes sur cette connexion en font partie. Sur une autre connexion, non.
- `COMMIT`
Rend les modifications définitives et visibles des autres connexions. Jusque-là, personne d'autre ne voit rien.
- `ROLLBACK`
Annule tout ce qu'a fait la transaction. À exécuter dans le
catch, avant de relancer l'erreur.- Transaction orpheline
Une transaction ouverte et jamais refermée. Elle garde sa connexion et ses verrous, et empêche le nettoyage automatique de la base. Symptôme :
idle in transaction.- Verrou de ligne
Une ligne modifiée dans une transaction est verrouillée jusqu'au
COMMIT. Toute autre transaction qui veut la modifier attend pendant toute la durée de la transaction.- Interblocage
Deux transactions attendent chacune un verrou tenu par l'autre. PostgreSQL en tue une et renvoie
40P01. Verrouiller dans un ordre constant l'évite.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.