Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Replit met à niveau les bases de données de développement de Neon (un fournisseur PostgreSQL serverless tiers) vers Helium, l’infrastructure PostgreSQL gérée par Replit. Cette mise à niveau est automatique, s’exécute une seule fois par application et préserve toutes vos données.
Cette mise à niveau s’applique uniquement aux bases de données de développement. Les bases de données de production utilisées par vos applications déployées ne sont pas affectées dans la plupart des cas. Cependant, si votre application déployée partage une base de données de développement avec une autre application (courant dans les anciennes applications dupliquées ou remixées), consultez Corriger une application publiée utilisant une base de données partagée pour les étapes importantes.

​
Ce qui change

La mise à niveau déplace votre base de données de développement de l’infrastructure de Neon vers Helium, qui s’exécute directement sur la plateforme de Replit. Voici ce que cela signifie pour vous :
  • Latence réduite : votre base de données s’exécute sur l’infrastructure Replit aux côtés de votre application, réduisant les temps de connexion
  • Plus de stockage : votre limite de stockage passe de 10 Go à 20 Go
  • Même moteur de base de données : Helium utilise PostgreSQL 16, la même version que Neon — vos requêtes, schémas et données fonctionnent de la même manière
  • Connexion transparente : votre variable d’environnement DATABASE_URL est automatiquement mise à jour pour pointer vers Helium
  • Connexion Neon sauvegardée : votre ancienne chaîne de connexion Neon est enregistrée sous le nom NEON_DATABASE_URL dans vos secrets pour référence. L’ancienne base de données Neon n’est plus utilisée par votre application après la mise à niveau et est planifiée pour suppression après une période de grâce temporaire.
Pour une comparaison complète entre la base de données Neon héritée et la nouvelle base de données Replit — y compris les différences en matière de facturation, de capacités de restauration, de sécurité des connexions et de comportement lors du remixage — consultez Base de données de développement héritée.

​
Ce à quoi s’attendre pendant la mise à niveau

La mise à niveau s’exécute automatiquement lorsque vous ouvrez votre application Replit dans l’éditeur de projet.
  1. Un écran de progression s’affiche avec le message “Upgrading your database”
  2. Vos données sont copiées de manière sécurisée de Neon vers Helium. Aucune donnée n’est modifiée ou perdue lors du transfert.
  3. La durée dépend de la taille de votre base de données — elle peut prendre de quelques minutes à quelques heures pour les grandes bases de données
  4. Vous pouvez laisser l’onglet ouvert ou le fermer et revenir plus tard
  5. Lorsque la mise à niveau est terminée, une boîte de dialogue de confirmation s’affiche : “We’ve upgraded your database!”
Si la mise à niveau rencontre un problème, elle est automatiquement ignorée afin que vous puissiez continuer à travailler. La mise à niveau sera relancée la prochaine fois que vous ouvrirez votre application.

​
Que faire après la mise à niveau

Pour la plupart des développeurs, aucune action n’est requise. Votre application continue de fonctionner comme auparavant.
Si votre code se connecte à la base de données en utilisant la variable d’environnement DATABASE_URL, aucune modification n’est nécessaire. La variable est automatiquement mise à jour pour pointer vers votre nouvelle base de données Helium.
Vérifiez les points suivants s’ils s’appliquent à votre application :
  • Chaînes de connexion Neon codées en dur : si votre code référence directement une chaîne de connexion neon.tech, mettez-la à jour pour utiliser la variable d’environnement DATABASE_URL à la place — process.env.DATABASE_URL en JavaScript ou os.environ['DATABASE_URL'] en Python. Consultez Connecter votre application à une base de données SQL pour des exemples.
  • Rôles PostgreSQL personnalisés : si vous avez créé des rôles de base de données personnalisés sur Neon, ces rôles et leurs autorisations sont migrés automatiquement. Cependant, les mots de passe des rôles ne peuvent pas être copiés — vous devrez réinitialiser les mots de passe de tous les rôles personnalisés sur la nouvelle base de données Helium.
  • Variables d’environnement PG individuelles : les variables d’environnement PGHOST, PGPORT, PGUSER et PGPASSWORD sont supprimées après la mise à niveau. Utilisez plutôt la chaîne de connexion DATABASE_URL, qui contient toutes les informations nécessaires pour se connecter.

​
Dépannage

​
Erreurs de connexion SSL après la mise à niveau

Après la mise à niveau, vous pouvez rencontrer des erreurs de connexion telles que The server does not support SSL connections ou une déconnexion inattendue du socket. Cela se produit lorsque votre code de connexion à la base de données force une négociation SSL. Neon exigeait SSL pour toutes les connexions, mais Helium s’exécute localement aux côtés de votre application et n’utilise pas SSL. Pour résoudre ce problème, rendez le paramètre SSL de votre connexion à la base de données conditionnel à l’environnement. Cela garantit que votre application se connecte sans SSL en développement (Helium) et avec SSL en production (où votre base de données de production peut encore l’exiger). 
// Avant (cesse de fonctionner après la mise à niveau)
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl: { rejectUnauthorized: false },
});

// Après (fonctionne en développement et en production)
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  ssl:
    process.env.NODE_ENV === "production"
      ? { rejectUnauthorized: false }
      : false,
});
Si vous utilisez un ORM comme Drizzle, Prisma ou Sequelize, consultez sa documentation pour savoir comment configurer les paramètres SSL de manière conditionnelle. Le même principe s’applique — désactivez SSL pour la base de données de développement et activez-le pour la production.

​
Application déployée utilisant une base de données partagée

Les anciennes applications dupliquées ou remixées sur Replit peuvent partager une base de données de développement avec l’application d’origine. Avec l’ancien système Neon, dupliquer une application copiait le DATABASE_URL de l’application d’origine, ce qui signifiait que les deux applications et leurs versions publiées se connectaient à la même base de données. Après la mise à niveau de la base de données, la base de données Neon de l’application d’origine est désactivée. Si votre application publiée utilise encore cette URL de base de données partagée, elle peut cesser de fonctionner ou perdre l’accès à ses données.
La base de données partagée sera arrêtée le 1er juin 2026. Mettez à jour votre application publiée avant cette date pour éviter toute perte de données permanente.

​
Que faire ensuite

Si votre application publiée est concernée, suivez le guide étape par étape dédié : Ce guide couvre :
  • Comment confirmer si votre application publiée utilise encore l’ancienne connexion Neon
  • Quand utiliser Publish ou Republish avec Create production database
  • Comment exporter et importer manuellement des données si votre application publiée dépend encore de l’ancienne base de données partagée
  • Mises en garde importantes concernant les temps d’arrêt, les écritures actives et les rôles PostgreSQL personnalisés

​
Foire aux questions

Oui. Vos données sont copiées de Neon vers Helium — elles ne sont pas déplacées ni supprimées pendant le transfert. La base de données Neon d’origine est préservée jusqu’à ce que la mise à niveau se termine avec succès. Aucune donnée n’est modifiée ou perdue.
La mise à niveau s’exécute automatiquement lorsque vous ouvrez votre application Replit. Si elle rencontre un problème, elle est automatiquement ignorée et vous pouvez continuer à travailler normalement. La mise à niveau sera relancée la prochaine fois que vous ouvrirez l’application.
Si la mise à niveau échoue, elle est automatiquement ignorée afin que vous puissiez continuer à utiliser votre application avec la base de données Neon existante. Le système relancera la mise à niveau la prochaine fois que vous ouvrirez votre application. Si le problème persiste après plusieurs tentatives, contactez le support pour obtenir de l’aide.
Après la mise à niveau, DATABASE_URL pointe vers votre nouvelle base de données Helium au lieu de Neon. Votre ancienne chaîne de connexion Neon est enregistrée sous le nom NEON_DATABASE_URL dans les secrets de votre application. Si votre code utilise DATABASE_URL pour se connecter, aucune modification n’est nécessaire — la variable est mise à jour automatiquement.
Ces variables d’environnement individuelles sont supprimées après la mise à niveau. Helium fournit les détails de connexion via la variable d’environnement DATABASE_URL, qui contient toutes les informations dont votre application a besoin pour se connecter. Mettez à jour tout code qui référence ces variables individuelles pour utiliser DATABASE_URL à la place.
Votre ancienne chaîne de connexion Neon est enregistrée sous le nom NEON_DATABASE_URL dans les secrets de votre application pour référence. Dans la plupart des cas, l’ancienne base de données Neon n’est plus utilisée après la mise à niveau et est planifiée pour suppression le 1er juin 2026.Si votre application déployée utilisait une ancienne base de données Neon partagée provenant d’une application dupliquée ou remixée, cette base de données Neon peut encore être temporairement disponible pour vous permettre d’exporter des données et de passer à votre propre base de données de production. Cet accès est temporaire, et la base de données partagée sera quand même supprimée le 1er juin 2026, mettez donc à jour votre application publiée dès que possible.Si NEON_DATABASE_URL n’est pas disponible dans vos secrets et que vous avez besoin d’aide pour récupérer l’ancienne chaîne de connexion, contactez le support.
Dans la plupart des cas, non — les bases de données de production sont gérées séparément et ne font pas partie de cette mise à niveau. Cependant, si votre application publiée utilise directement l’URL de la base de données de développement (au lieu d’une base de données de production distincte), la mise à niveau peut affecter votre application publiée. C’est plus courant dans les anciennes applications dupliquées ou remixées, où la copie partageait la base de données de l’application d’origine. Consultez Corriger une application publiée utilisant une base de données partagée pour savoir comment résoudre ce problème.

​
Prochaines étapes