Passer au contenu principal
La base de données Replit utilise une base de données SQL entièrement gérée qui vous permet d’ajouter un stockage de données persistant à votre application Replit depuis l’espace de travail.
La façon la plus rapide de démarrer est de demander à Agent d’ajouter une base de données à votre application. Agent configurera l’intégration, créera le schéma de base de données et mettra à jour votre application pour stocker et récupérer des données.
capture d'écran de l'éditeur de base de données

Fonctionnalités

L’outil de base de données Replit fournit les fonctionnalités suivantes :
  • Outils de base de données : Exécutez des requêtes, gérez le schéma de base de données et visualisez les données avec les outils SQL intégrés
  • Voyage dans le temps : Restaurez votre base de données à n’importe quel point de contrôle Agent en utilisant la fonctionnalité de retour en arrière
  • Stockage gratuit : Inclut 10 Go de stockage gratuit pour chaque application Replit.
  • Variables d’environnement : Utilisez des variables d’environnement dans votre application Replit pour accéder à la base de données en toute sécurité
Avant le 4 décembre 2025, la base de données de développement était hébergée sur Neon et présente quelques différences cruciales. Consultez la section Base de données de développement Neon héritée pour plus de détails.

Utilisation

Vous pouvez accéder à l’outil de base de données Replit directement dans l’espace de travail de votre application Replit. Les sections suivantes vous guident dans la configuration et la gestion de votre base de données.
Depuis le dock d’outils à gauche :
  1. Sélectionnez icône Tous les outils Tous les outils pour voir une liste des outils de l’espace de travail.
  2. Sélectionnez icône de base de données PostgresSQL Base de données.
Depuis la barre de recherche :
  1. Sélectionnez la loupe icône loupe en haut pour ouvrir l’outil de recherche
  2. Tapez « Base de données Replit » pour localiser l’outil et sélectionnez-le dans les résultats.

Ajouter une base de données

Toutes les applications Replit sont livrées avec une base de données par défaut. Vous pouvez y accéder en sélectionnant l’outil icône de base de données PostgresSQL Base de données dans votre espace de travail. Vous pouvez intégrer la base de données à votre application Replit en demandant à Agent d’ajouter une base de données PostgreSQL à votre application Replit, en incluant des détails sur les données que votre application Replit doit stocker. Agent créera le schéma de base de données et mettra à jour votre application pour communiquer avec la base de données.

Restaurer votre base de données à un état précédent

Vous pouvez revenir à un état précédent de votre application et de votre base de données en utilisant la fonctionnalité de retour en arrière. Cette fonctionnalité vous permet de restaurer votre base de données à n’importe quel point de contrôle créé par Agent.
Interface de retour en arrière de point de contrôle montrant les options de retour en arrière
Assurez-vous de sélectionner « Base de données » sous « Options de retour en arrière supplémentaires » lors de la restauration à l’état d’un point de contrôle. Cela restaurera votre base de données à l’état qu’elle avait au moment du point de contrôle.

Exécuter des commandes de base de données

Le runner SQL est un outil de l’espace de travail qui vous permet d’exécuter des commandes SQL sur votre base de données et de visualiser les résultats.
Depuis l’outil Base de données Replit :
  1. Sélectionnez l’onglet Mes données
  2. Sélectionnez icône runner SQL Runner SQL
Pour exécuter une requête, entrez l’instruction SQL dans la zone de texte et sélectionnez le bouton icône d'exécution SQL d’exécution adjacent comme indiqué ci-dessous :
capture d'écran du runner SQL et du bouton d'exécution

Parcourir et modifier les données visuellement

L’outil de base de données Replit inclut Drizzle Studio, un outil qui vous permet de parcourir et de modifier les données visuellement. Ces outils visuels vous aident à éviter les erreurs de syntaxe et offrent les fonctionnalités suivantes :
  • Filtrer et trier les données pour se concentrer sur des informations spécifiques
  • Exporter les données vers un fichier pour une utilisation externe
  • Insérer ou modifier des données de lignes
  • Créer et gérer le schéma, les tables, les vues et les enums
Vous pouvez accéder à ces outils dans l’onglet Mes données dans l’outil Base de données Replit. L’image suivante montre une vue de l’interface du constructeur Drizzle Studio :
image de l'éditeur de structure de table
Vous pouvez vous connecter à votre base de données en utilisant n’importe quel client SQL compatible PostgresSQL via la chaîne de connexion trouvée dans vos variables d’environnement.

Voir les identifiants de connexion et l’utilisation

Les identifiants de connexion à votre base de données sont stockés comme variables d’environnement dans votre application Replit. Ces identifiants sont utilisés par votre application pour se connecter en toute sécurité à la base de données et exécuter des commandes.
  1. Naviguez vers l’outil icône de base de données PostgresSQL Base de données Replit dans votre espace de travail
  2. Sélectionnez la base de données de développement ou de production
  3. Sélectionnez l’onglet icône d'engrenage Paramètres (l’icône d’engrenage). Cet onglet affiche les identifiants de connexion et l’utilisation du stockage pour votre base de données.

Variables d’environnement

Les variables d’environnement suivantes sont disponibles :
  • DATABASE_URL : comment se connecter et s’authentifier à la base de données
  • PGHOST : nom d’hôte de la base de données
  • PGUSER : nom d’utilisateur de la base de données
  • PGPASSWORD : mot de passe de la base de données
  • PGDATABASE : nom de la base de données
  • PGPORT : port de la base de données
Cette DATABASE_URL ne peut être utilisée que par votre application et même si elle est divulguée, elle ne peut pas être utilisée par quelqu’un d’autre pour accéder et modifier votre base de données. Pour apprendre à utiliser ces identifiants dans votre code, consultez Connecter votre application à une base de données SQL.
Parce que cette DATABASE_URL est limitée à votre application, votre base de données de développement ne peut pas être accédée par d’autres applications, même celles que vous possédez ou des viewers de base de données externes. Cette séparation suit les meilleures pratiques de sécurité et empêche l’accès non autorisé à votre base de données.Si vous avez besoin que plusieurs applications Replit partagent une seule base de données, vous pouvez l’exposer comme une API REST. Consultez le tutoriel sur le partage d’une base de données entre plusieurs applications pour apprendre à configurer un service API de base de données sécurisé.
Si vous utilisez encore la base de données de développement Neon héritée, ne partagez pas votre DATABASE_URL. Elle contient vos identifiants de base de données qui pourraient être utilisés par n’importe qui pour accéder et modifier votre base de données. Ne la collez jamais dans des endroits publics ou des tickets de support.

Fonctionnalités de sécurité

Lorsque vous ajoutez une intégration de base de données en utilisant Agent, il ajoute un Mappeur Objet-Relationnel (ORM) qui gère toutes les communications avec la base de données avec une sécurité intégrée. Cette couche ORM, combinée avec l’implémentation des meilleures pratiques de sécurité d’Agent, protège votre application contre les exploits grâce aux fonctionnalités suivantes :
  • Validation du schéma : Vérifie que les données sont conformes aux formats attendus
  • Assainissement des données : Nettoie automatiquement les entrées des constructeurs pour prévenir les attaques par injection SQL

Base de données de développement héritée

Avant le 4 décembre 2025, la base de données de développement était hébergée sur Neon. Cette base de données est maintenant obsolète et toutes les nouvelles bases de données de développement sont hébergées sur l’infrastructure de base de données propre à Replit. Vous pouvez voir si votre base de données de développement est hébergée sur Neon en vérifiant la variable d’environnement DATABASE_URL variable d’environnement.
Si DATABASE_URL contient neon.tech/neondb, alors votre base de données de développement est toujours hébergée sur Neon. Sinon, si elle contient helium/heliumdb, votre base de données de développement est maintenant hébergée sur Replit.
Les différences clés suivantes existent entre la base de données de développement Neon héritée et la nouvelle base de données de développement Replit :
FonctionnalitéReplit (actuel)Neon (hérité)
HébergementHébergé sur l’infrastructure propre à ReplitHébergé sur Neon (fournisseur tiers)
FacturationInclus gratuitement avec chaque application ReplitFacturation basée sur l’utilisation. Consultez Facturation de publication et de base de données pour plus de détails.
Capacité de restaurationRestaurez votre base de données à n’importe quel point de contrôle en utilisant la fonctionnalité de retour en arrièreRestauration à un point dans le temps (PITR) — récupérez à n’importe quel point dans la fenêtre de rétention de sauvegarde.
Sécurité de connexionAccessible uniquement depuis votre application ; jamais exposé publiquement.Utilisait une chaîne de connexion complète — si divulguée, n’importe qui pouvait accéder et modifier votre base de données.
Comportement de remixLe remix crée une nouvelle base de données de développement avec des données copiées pour l’isolation et la sécurité.Le remix réutilisait la même base de données pour toutes les copies, donc les changements dans les remixes pouvaient affecter l’application originale.
Création de base de donnéesCréée automatiquement pour chaque application Replit.Nécessitait une configuration explicite.
Workflow de publicationLe déploiement ou la publication nécessite la création d’une base de données de production pour l’isolation entre les environnements.Le développement et la production partageaient la même base de données, donc les changements de développement non intentionnels pouvaient affecter les applications de production.
Si votre application a été forkée ou remixée lors de l’utilisation de la base de données Neon héritée, votre application publiée peut toujours référencer l’URL de base de données de l’application d’origine. Après la mise à niveau de la base de données, cette connexion partagée cessera de fonctionner. Consultez Corriger une application publiée utilisant une base de données partagée pour savoir comment mettre à jour votre application publiée.