Go Academy · Leçon

Transactions et migrations

Modèles BEGIN/COMMIT et migrations de schéma

Leçon 4 sur 413 étapes

Transactions et migrations est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.

Transactions dans database/sql

Regroupez les opérations dans une transaction avec db.BeginTx. Validez-la ou annulez-la à la fin ; reportez toujours une annulation pour gérer les paniques.

tx, err := db.BeginTx(ctx, nil)
if err != nil { return err }
defer tx.Rollback() // no-op after Commit

_, err = tx.ExecContext(ctx, "UPDATE accounts SET balance=balance-100 WHERE id=$1", from)
if err != nil { return err }
_, err = tx.ExecContext(ctx, "UPDATE accounts SET balance=balance+100 WHERE id=$1", to)
if err != nil { return err }
return tx.Commit()

Niveaux d’isolation des transactions

Transmettez sql.TxOptions pour contrôler le niveau d’isolation :

tx, err := db.BeginTx(ctx, &sql.TxOptions{
    Isolation: sql.LevelSerializable,
    ReadOnly:  false,
})

Utiliser le même Tx entre plusieurs fonctions

Transmettez le *sql.Tx aux fonctions d’assistance afin qu’elles participent toutes à la même transaction. N’appelez pas db.ExecContext dans une transaction : utilisez tx.ExecContext.

Modèle avec Rollback différé

Différez Rollback immédiatement après BeginTx. Si Commit réussit, l’annulation qui suit est sans effet. Si Commit échoue, l’annulation rétablit les modifications.

tx, _ := db.BeginTx(ctx, nil)
defer tx.Rollback() // safe no-op after successful Commit

Points de sauvegarde

Utilisez des points de sauvegarde au sein d’une transaction pour effectuer des annulations partielles (spécifiques à PostgreSQL via du SQL brut) :

tx.ExecContext(ctx, "SAVEPOINT sp1")
// ... work ...
tx.ExecContext(ctx, "ROLLBACK TO SAVEPOINT sp1") // partial rollback

Présentation des migrations de base de données

Les migrations sont des scripts SQL versionnés qui font évoluer le schéma progressivement. Chaque migration possède un sens d’application et un sens d’annulation.

golang-migrate

github.com/golang-migrate/migrate/v4 exécute les fichiers de migration SQL versionnés dans l’ordre et suit la version appliquée dans une table schema_migrations.

m, _ := migrate.New("file://migrations", dsn)
m.Up() // apply all pending migrations

goose

github.com/pressly/goose/v3 est une autre bibliothèque de migration populaire qui prend en charge les migrations SQL et celles basées sur des fonctions Go, avec des commandes d’application et d’annulation.

goose.Up(db, "migrations")

Atlas pour la gestion du schéma

Atlas fournit une gestion déclarative du schéma : vous définissez l’état souhaité du schéma, puis Atlas calcule les différences et génère automatiquement les scripts de migration.

Exécuter les migrations au démarrage

Exécutez les migrations par programmation dans main avant de démarrer le serveur afin de garantir que le schéma est à jour lors du déploiement.

if err := runMigrations(db); err != nil { log.Fatal(err) }

Bonnes pratiques pour les migrations

Chaque migration doit porter sur une seule préoccupation et être compatible avec les versions futures (additive). Ne supprimez jamais les colonnes immédiatement : marquez-les comme obsolètes, puis supprimez-les lors d’une migration ultérieure, une fois que le code ne les référence plus.

Vérification rapide

Pourquoi devez-vous toujours différer tx.Rollback() immédiatement après BeginTx ?

Récapitulatif : transactions et migrations

Points clés :

  • BeginTx → différer Rollback → travail → Commit
  • Transmettez *sql.Tx aux fonctions auxiliaires ; utilisez tx.ExecContext plutôt que db.ExecContext
  • Utilisez golang-migrate ou goose pour les migrations SQL versionnées
  • Exécutez les migrations au démarrage ; veillez à ce que chaque migration soit additive
Gratuit pour commencer

Apprends Go avec un tuteur IA — gratuit

Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.

Cours
51
Leçons
203

Questions Fréquemment Posées

La leçon « Transactions et migrations » est-elle gratuite ?

Oui — le texte complet de « Transactions et migrations » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Transactions et migrations » ?

Modèles BEGIN/COMMIT et migrations de schéma Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Go Academy ?

Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.

Combien de temps prend la leçon « Transactions et migrations » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?

Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. database/sql et pilotes
  2. sqlx : analyse des structs et requêtes nommées
  3. pgx : pilote PostgreSQL hautes performances
  4. Transactions et migrations
← Retour à Go Academy