Passer au contenu principal
Lorsque vous publiez une application qui utilise une base de données gérée par Replit, Replit met automatiquement votre base de données de production à jour par rapport à votre base de données de développement. Vous n’écrivez ni n’exécutez vous-même de migrations. Pendant la publication, Replit :
  1. Compare le schéma de vos bases de données de développement et de production.
  2. Génère le SQL nécessaire pour que la production corresponde au développement.
  3. Vous demande de résoudre tout ce qui est ambigu, comme une colonne renommée.
  4. Valide le SQL sur une copie de votre base de données de production.
  5. Applique le SQL à la production une fois votre application construite et avant la mise en ligne de la nouvelle version.
Cela ne s’applique qu’aux bases de données que Replit gère pour votre application. Si votre application publiée se connecte à une base de données externe comme Supabase, un projet Neon que vous avez créé vous-même ou Amazon RDS, Publish ne modifie pas cette base de données. Utilisez plutôt le flux de migration de ce fournisseur.

​
Étape 1 : Replit détecte les changements

La publication commence par une étape Provision. Si votre schéma de développement diffère de celui de la production, le volet Publish affiche Development database changes detected et commence à générer les migrations.
Volet Publish affichant Development database changes detected
La publication migre les tables, colonnes, index, contraintes, vues, enums, séquences et politiques de sécurité au niveau des lignes. Certains objets ne sont pas repris ; consultez Objets de base de données non pris en charge.

​
Étape 2 : Répondre aux questions sur les changements ambigus

Certains changements de schéma peuvent avoir deux significations. Lorsque Replit ne peut pas déterminer votre intention, il s’interrompt avec Detected potential conflicts, please review et vous demande de choisir. Choisissez une option et sélectionnez Submit.

​
Renommage ou nouveauté ?

Si une colonne a été supprimée et une autre ajoutée sur la même table, Replit demande si l’ancienne colonne a été renommée.
  • Yes, rename column conserve les données existantes sous le nouveau nom.
  • No, create new column ajoute une colonne vide et supprime l’ancienne avec ses données.
Invite demandant si une colonne supprimée doit être renommée en une colonne nouvellement ajoutée
La même question apparaît pour les tables, enums, séquences, vues et schémas.
Invite demandant si une table supprimée doit être renommée en une table nouvellement ajoutée
Choisir create new pour ce qui était en réalité un renommage est la façon la plus courante de perdre des données de production lors d’une publication. Si vous avez un doute, annulez la publication et demandez à Agent ce qui a changé.

​
Contrainte d’unicité sur une table contenant des données

Si vous ajoutez une contrainte d’unicité à une table qui contient déjà des lignes en production, Replit vous indique combien de lignes la contrainte va vérifier.
  • Add the constraint as-is fait échouer la migration si des lignes existantes la violent. Vous pouvez alors corriger les données et publier à nouveau.
  • Remove all rows, then add the constraint vide d’abord la table. Cette option n’est pas proposée lorsque d’autres tables référencent celle-ci via une clé étrangère.
Invite demandant comment ajouter une contrainte d'unicité à une table qui contient déjà des lignes

​
Étape 3 : Examiner le SQL généré

Une fois les questions résolues, le volet affiche Generated migrations to apply to production database avec le SQL exact que Replit va exécuter. Lisez-le avant de continuer.
SQL de migration généré affiché dans le volet Publish
Deux signaux indiquent qu’une migration demande une attention particulière :
  • Avertissement de perte de données. Lorsqu’un changement pourrait supprimer des données d’une table contenant des lignes en production, le volet devient orange et liste chaque table concernée avec son nombre de lignes. Les changements qui déclenchent cet avertissement incluent :
    • Supprimer ou recréer une colonne ou une table
    • Changer le type d’une colonne ou son caractère obligatoire
    • Ajouter une colonne obligatoire
    • Ajouter ou recréer des index et des contraintes
  • Avis d’interruption. Lorsqu’un changement n’est pas compatible avec la version de votre application en cours d’exécution, Replit arrête l’application avant d’appliquer la migration afin que les utilisateurs ne puissent pas écrire dans la base de données en plein changement. Développez What’s happening? pour plus de détails.
Migration avec un avertissement orange de perte de données listant les tables concernées et un avis d'interruption
La liste d’avertissement n’inclut que les tables qui contiennent des lignes en production. Un DROP TABLE sur une table vide n’affiche aucun avertissement ; lisez donc le SQL même lorsque le volet n’est pas orange.

​
Étape 4 : Replit valide la migration

Replit crée une copie temporaire de votre base de données de production et exécute le SQL dessus. Le volet affiche Validating database migrations… puis Database migrations validated successfully.
Volet Publish affichant que les migrations de base de données ont été validées avec succès
Si le SQL échoue sur la copie, le volet affiche Migrations failed validation, please review avec l’erreur de la base de données et trois façons de continuer :
Volet Publish affichant l'échec de validation des migrations avec trois options de résolution
Les applications utilisant une base de données Databricks Lakebase ignorent cette étape de validation. Le volet vous demande d’examiner vous-même le SQL généré avant d’approuver.
Volet Publish indiquant que la validation par aperçu n'est pas disponible pour Lakebase

​
Étape 5 (facultatif) Prévisualisez votre application sur la copie migrée

Une fois la validation réussie, vous pouvez sélectionner Create preview deploy pour construire votre application sur la copie migrée de la production. Lorsque la construction est terminée, sélectionnez View preview pour l’ouvrir.
Volet Publish pendant la construction d'un déploiement d'aperçu
Volet Publish avec les boutons View preview et Approve and publish
Utilisez l’aperçu pour parcourir les parties de votre application concernées par le changement de schéma. L’aperçu utilise les données copiées ; ce que vous y faites n’affecte donc pas la production. Les aperçus expirent 2 heures après leur création ; créez-en un nouveau si vous avez besoin de plus de temps.

​
Étape 6 : Approuver et publier

Sélectionnez Approve and publish pour continuer. Replit envoie le SQL exact que vous avez examiné avec la demande de publication : ce que vous avez vu est ce qui est exécuté. La publication se poursuit ensuite par les étapes restantes. La migration s’exécute après la fin de la construction de votre application et avant la promotion de la nouvelle version :
  1. Vérifications de sécurité
  2. Construction
  3. Migration de base de données appliquée à la production
  4. Regroupement et promotion de la nouvelle version
Comme Replit applique la migration à ce moment-là, la commande de build de votre application et son code de démarrage ne doivent jamais modifier le schéma de la base de données. N’ajoutez pas d’instructions drizzle-kit push, db:push ou CREATE TABLE IF NOT EXISTS à la commande de build du déploiement ni au point d’entrée de votre serveur. Elles s’exécuteraient à chaque publication, en dehors de l’examen et de la validation décrits ci-dessus.
Une fois que vous avez approuvé, la migration ne peut plus être rappelée depuis le volet Publish. Si vous devez annuler un changement de schéma après la publication, effectuez le changement inverse en développement et publiez à nouveau, ou utilisez la récupération de données.
Si vous demandez à Agent de republier au lieu d’utiliser le volet Publish et que vos schémas de développement et de production diffèrent, la republication est bloquée et vous êtes redirigé vers le volet Publish pour examiner la migration.

​
Modifier la production manuellement

Pour des corrections ponctuelles, vous pouvez exécuter du SQL directement sur la production depuis le volet Database : sélectionnez Production dans le sélecteur de base de données, puis utilisez la console SQL. Consultez Travailler avec vos données. Replit compare toujours les bases de données réelles, pas votre fichier de schéma ; toute modification manuelle fait donc partie de la comparaison de la prochaine publication. Si vous ajoutez à la main en production une colonne qui n’existe pas en développement, la prochaine publication proposera de la supprimer.

​
Prochaines étapes