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 Database 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’éditeur de projet.
La façon la plus rapide de commencer est de demander à Agent d’ajouter une base de données à votre application. Agent configurera l’intégration, créera le schéma de la 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 Replit Database fournit les fonctionnalités suivantes :
  • Outils de base de données : Exécutez des requêtes, gérez le schéma de la 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 grâce à la fonctionnalité de rollback
  • Stockage gratuit : Inclut 20 Go de stockage gratuit pour chaque application Replit
  • Variables d’environnement : Utilisez des variables d’environnement dans votre application Replit pour accéder de façon sécurisée à la base de données
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 importantes. Consultez la section Base de données de développement Neon legacy pour plus de détails.

​
Utilisation

Vous pouvez accéder à l’outil Replit Database directement dans l’éditeur de projet. 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 All tools pour voir la liste des outils de l’éditeur de projet.
  2. Sélectionnez Icône base de données PostgreSQL Database.
Depuis la barre de recherche :
  1. Sélectionnez la icône loupe loupe en haut pour ouvrir l’outil de recherche
  2. Tapez « Replit Database » 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 base de données PostgreSQL Database dans l’éditeur de projet. 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 précisant les données que votre application Replit doit stocker. Agent créera le schéma de la 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 grâce à la fonctionnalité de rollback. Cette fonctionnalité vous permet de restaurer votre base de données à n’importe quel point de contrôle créé par Agent.
Interface de rollback de point de contrôle affichant les options de rollback
Assurez-vous de sélectionner « Database » sous « Additional rollback options » 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 SQL runner est un outil de l’éditeur de projet qui vous permet d’exécuter des commandes SQL sur votre base de données et d’afficher les résultats.
Depuis l’outil Replit Database :
  1. Sélectionnez l’onglet My Data
  2. Sélectionnez Icône SQL runner SQL runner
Pour exécuter une requête, entrez l’instruction SQL dans la zone de texte et sélectionnez le bouton adjacent icône d'exécution sql comme indiqué ci-dessous :
capture d'écran du SQL runner et du bouton d'exécution

​
Parcourir et modifier les données visuellement

L’outil Replit Database 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 énumérations
Vous pouvez accéder à ces outils dans l’onglet My Data de l’outil Replit Database. L’image suivante montre une vue de l’interface du générateur Drizzle Studio :
image de l'éditeur de structure de table
Vous pouvez vous connecter à votre base de données à l’aide de n’importe quel client SQL compatible PostgreSQL en utilisant la chaîne de connexion trouvée dans vos variables d’environnement.

​
Afficher les identifiants de connexion et l’utilisation

Les identifiants de connexion à votre base de données sont stockés en tant que variables d’environnement dans votre application Replit. Ces identifiants sont utilisés par votre application pour se connecter de façon sécurisée à la base de données et exécuter des commandes.
  1. Accédez à l’outil Icône base de données PostgreSQL Replit Database dans l’éditeur de projet
  2. Sélectionnez la base de données Development ou Production
  3. Sélectionnez l’onglet icône engrenage Settings (l’icône en forme d’engrenage). Cet onglet affiche les identifiants de connexion et l’utilisation du stockage pour votre base de données.

​
Variables d’environnement

La variable d’environnement suivante est disponible pour se connecter à votre base de données de développement :
  • DATABASE_URL : comment se connecter et s’authentifier à la base de données
Ce DATABASE_URL ne peut être utilisé que par votre application et même s’il est divulgué, personne d’autre ne peut l’utiliser pour accéder à et modifier votre base de données.
Si votre base de données de développement est encore sur l’infrastructure Neon legacy, les variables d’environnement supplémentaires suivantes sont également disponibles : PGHOST, PGUSER, PGPASSWORD, PGDATABASE et PGPORT. Ces variables de connexion individuelles ne sont pas fournies pour les bases de données hébergées sur l’infrastructure actuelle de Replit — utilisez DATABASE_URL à la place.
Pour apprendre à utiliser ces identifiants dans votre code, consultez Connecter votre application à une base de données SQL.
Parce que ce DATABASE_URL est limité à 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 outils 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 même base de données, vous pouvez l’exposer en tant qu’API REST. Consultez le tutoriel sur le partage d’une base de données entre plusieurs applications pour apprendre comment configurer un service d’API de base de données sécurisé.
Si vous utilisez encore la base de données de développement Neon legacy, ne partagez pas votre DATABASE_URL. Il 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 le collez jamais dans des endroits publics ou dans des tickets de support.

​
Fonctionnalités de sécurité

Lorsque vous ajoutez une intégration de base de données avec Agent, il ajoute un Object-Relational Mapper (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 à l’implémentation des meilleures pratiques de sécurité par 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 créateurs pour prévenir les attaques par injection SQL

​
Base de données de développement legacy

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 dépréciée et toutes les nouvelles bases de données de développement sont hébergées sur l’infrastructure de base de données propre de 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.
Si DATABASE_URL contient neon.tech/neondb, alors votre base de données de développement est encore hébergée sur Neon. Sinon, si elle contient helium/heliumdb, alors votre base de données de développement est maintenant hébergée sur Replit.
Voici les différences clés entre la base de données de développement Neon legacy et la nouvelle base de données de développement Replit :
FonctionnalitéReplit (actuel)Neon (legacy)
HébergementHébergé sur l’infrastructure propre de ReplitHébergé sur Neon (fournisseur tiers)
FacturationInclus gratuitement avec chaque application ReplitFacturation basée sur l’utilisation. Voir Facturation des publications et des bases de données pour plus de détails.
Capacité de restaurationRestaurez votre base de données à n’importe quel point de contrôle grâce à la fonctionnalité de rollbackRestauration à un point dans le temps (PITR) — récupérez à n’importe quel point dans la fenêtre de rétention des sauvegardes.
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 pourrait 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 modifications dans les remixes pouvaient affecter l’application d’origine.
Création de la base de donnéesCréée automatiquement pour chaque application Replit.Nécessitait une configuration explicite.
Flux 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 des modifications de développement non intentionnelles pouvaient affecter les applications en production.
Si votre application a été forkée ou remixée lors de l’utilisation de la base de données Neon legacy, votre application publiée peut encore référencer l’URL de la 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.