Formations — 1 037 leçons en français

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 BEGIN et COMMIT, annulée par ROLLBACK. 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.

Lire l'explication détaillée et faire le quiz →

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.