Cloud Atoms Base de données stocke et gère les données structurées dont votre app dépend, notamment les produits, réservations, commandes, soumissions de formulaires et contenus générés par les utilisateurs. Dans le module Base de données, vous pouvez afficher les environnements et les tables, rechercher et modifier des enregistrements, inspecter les structures des tables, et importer ou exporter des données à l’aide de fichiers CSV.

Ce guide couvre la base de données intégrée à Cloud Atoms. Si votre projet utilise Supabase, consultez plutôt Connexion Supabase.

Ouvrir une base de données

Avant d’ouvrir une base de données, connectez votre projet à Cloud Atoms. S’il n’est pas encore connecté, suivez les étapes de connexion dans Cloud Atoms.

1. Ouvrez votre projet sur un appareil de bureau.
2. Dans la même barre d’outils de l’espace de travail où se trouve la Visionneuse d'App , sélectionnez Cloud Atoms.
3. Sélectionnez Base de données dans la barre latérale de Cloud Atoms.
4. Sous Databases, sélectionnez la base de données que vous souhaitez inspecter. Les cartes de base de données Development et Production apparaissent lorsqu’elles sont disponibles pour le projet.

Chaque carte de base de données indique la quantité de stockage utilisée et la quantité totale disponible. Utilisez Development pendant la création et les tests de votre app. Les modifications effectuées dans Production peuvent affecter les données de l’app en ligne, alors vérifiez toujours dans quel environnement vous vous trouvez avant d’apporter des modifications.

Choisissez la base de données Development ou Production.

Parcourir et filtrer les données des tables

1. Sélectionnez la carte de base de données Development ou Production, selon l’environnement dans lequel vous souhaitez travailler.
2. Utilisez Search tables pour trouver une table, ou sélectionnez-en une directement dans la liste. Chaque carte de table affiche son nombre de lignes et si elle est en lecture seule.
3. Utilisez Search rows pour rechercher dans la table actuelle, ou sélectionnez Filter pour affiner les résultats à l’aide d’un ou plusieurs champs.
4. Utilisez les flèches de pagination sous la table pour afficher des lignes supplémentaires.
5. Pour inspecter la structure de la table, ouvrez le menu ••• et sélectionnez Schema.

La vue Schema affiche le nom de chaque champ, son type de données, son statut de clé, ses exigences, ses contraintes et sa valeur par défaut. Sélectionnez Copy pour copier le schéma affiché.

Ajouter, modifier ou supprimer des lignes

Lorsque vous avez trouvé la base de données que vous souhaitez modifier, vous pouvez utiliser ces actions pour le faire :

Opération	Comment faire
Ajouter une ligne	Ouvrez ... et sélectionnez Add Row. Saisissez des valeurs correspondant aux champs disponibles, puis soumettez la ligne.
Modifier une ligne	Double-cliquez sur une cellule et saisissez la nouvelle valeur. Sélectionnez Commit Changes pour enregistrer toutes les modifications en attente, ou Discard pour les supprimer.
Supprimer des lignes	Sélectionnez une ou plusieurs lignes, sélectionnez Delete, puis confirmez. La suppression de lignes ne peut pas être annulée.

L’ajout d’une ligne ou la confirmation d’une suppression applique immédiatement la modification à la base de données sélectionnée. Seules les modifications de cellules en ligne nécessitent de sélectionner Commit Changes ou Discard. Si vous avez des modifications en attente, validez-les ou abandonnez-les avant d’ajouter une ligne, d’importer ou d’exporter un fichier CSV, de modifier la recherche ou les filtres, ou de naviguer vers une autre page.

Si le projet se trouve dans un espace de travail, seuls les Editors et le workspace owner peuvent modifier les lignes dans les tables modifiables. Si Atoms ne peut pas détecter une clé primaire pour une table, vous ne pouvez pas modifier ni supprimer ses lignes, car Atoms ne peut pas identifier de manière fiable les enregistrements individuels.

Vérifiez une modification de ligne en attente, puis validez ou abandonnez la modification.

Créer des tables ou modifier le schéma

Ouvrez l’environnement de base de données que vous souhaitez mettre à jour, puis suivez les instructions correspondant à la modification que vous souhaitez effectuer :

Opération	Comment faire
Créer une table	Dans la liste des tables, cliquez sur ..., puis sélectionnez Create table. Saisissez un nom de table valide et les champs initiaux, puis soumettez la demande. Attendez que l’Agent ait terminé, rouvrez Base de données, puis vérifiez la table.
Modifier le schéma	Cliquez sur la table que vous souhaitez modifier, puis cliquez sur ..., et sélectionnez Schema. Utilisez Add Field pour créer un champ, ou sélectionnez un champ éligible pour le modifier. Vous pouvez changer son nom, son type, sa valeur par défaut, son statut requis ou son unicité. Vous pouvez également marquer les champs non clés pour suppression. Sélectionnez Submit Changes pour envoyer la demande à l’Agent, ou Discard pour effacer vos modifications en attente.

Seul le workspace owner peut créer des tables ou modifier le schéma d’une table.

Soumettre une demande de schéma ne signifie pas que la migration est terminée. Attendez que l’Agent ait terminé, vérifiez le résultat dans Base de données, puis testez votre app ensuite. Les champs de clé primaire et les tables en lecture seule ne peuvent pas être modifiés de cette manière.

Saisissez les détails du nouveau champ dans Add Field.

Vérifiez les modifications de schéma en attente avant de sélectionner Submit Changes.

Importer ou exporter des données CSV

Sélectionnez la table avec laquelle vous souhaitez travailler, puis suivez les instructions correspondant à l’opération concernée :

Opération	Comment faire
Import CSV	Cliquez sur ... et sélectionnez Import CSV. Choisissez un fichier .csv ne dépassant pas 10 MB, puis vérifiez le nom du fichier, le nombre estimé de lignes, la table sélectionnée et l’environnement avant de confirmer. Les colonnes du CSV doivent correspondre au schéma de la table. Les lignes importées sont ajoutées immédiatement et ne peuvent pas être annulées automatiquement, alors envisagez d’exporter d’abord les données existantes.
Export CSV	Cliquez sur ... et sélectionnez Export CSV. Si une recherche ou un filtre est actif, seules les lignes correspondantes sont exportées. Sinon, toutes les données de la table actuelle sont exportées.

Seul le workspace owner peut importer ou exporter des fichiers CSV. Pour les tables en lecture seule, Export CSV est la seule option disponible.

Autorisations et tables protégées

Action	Qui peut l’effectuer	Exigences supplémentaires
Ajouter, modifier ou supprimer des lignes	Editor ou workspace owner	La table doit être modifiable. La modification et la suppression de lignes nécessitent également des informations de clé primaire.
Créer des tables ou modifier des schémas	Espace de travail owner	Les champs de clé primaire et les tables en lecture seule ne peuvent pas être modifiés.
Importer ou exporter des fichiers CSV	Espace de travail owner	Les fichiers CSV ne peuvent pas être importés dans des tables en lecture seule.

Les tables système ou utilisateur protégées peuvent afficher un badge Read-only. Vous pouvez afficher leurs données et inspecter leur schéma lorsqu’il est disponible, mais vous ne pouvez pas modifier leurs lignes ni leur structure depuis cette page.

Résoudre les problèmes courants de base de données

« No databases found » ou « No tables found »

Assurez-vous que Cloud Atoms est connecté au projet. S’il est déjà connecté, confirmez que votre app inclut une fonctionnalité qui stocke des données persistantes. Si nécessaire, demandez à l’Agent d’ajouter la fonctionnalité reposant sur la base de données. Une fois que l’Agent a terminé, rouvrez Base de données ou sélectionnez Refresh.

Une action de base de données est manquante ou indisponible

Vérifiez si la table affiche un badge Read-only, puis consultez les autorisations ci-dessus pour confirmer que votre rôle dans l’espace de travail autorise l’action. La modification et la suppression de lignes nécessitent également des informations de clé primaire.

Les modifications de lignes en attente peuvent empêcher d’autres actions. Sélectionnez Commit Changes ou Discard avant d’ajouter une ligne, d’importer ou d’exporter un fichier CSV, de modifier la recherche ou les filtres, ou de passer à une autre page.

Si l’action reste indisponible après ces vérifications, contactez le Support et incluez le lien du projet ou du Chat, l’environnement, la table, le rôle dans l’espace de travail, l’action tentée et le texte exact de l’erreur.

Un fichier CSV ne peut pas être importé

Seul le workspace owner peut importer des données, et la table de destination doit être modifiable. Assurez-vous que :

• Le fichier utilise le format .csv.
• Le fichier ne dépasse pas 10 MB.
• Ses colonnes et ses données sont compatibles avec le schéma de la table de destination.
• Vous avez validé ou abandonné toutes les modifications de lignes en attente.

Si l’importation échoue toujours, contactez le Support et incluez le lien du projet ou du Chat, l’environnement, la table de destination, le rôle dans l’espace de travail, le nom et la taille du fichier, l’action tentée et le texte exact de l’erreur.

FAQ

Ma base de données de production ne se synchronise pas. Que dois-je faire ?

Si Development fonctionne normalement mais que le site en ligne (Production) affiche des tables, colonnes ou erreurs de migration manquantes :

Important : ne reconstruisez pas et n’écrasez pas la base de données de production par vous-même.

Informations nécessaires :

• Lien du Chat et URL en ligne
• Message d’erreur SQL complet
• Noms des tables/colonnes manquantes
• Dernière modification du schéma de base de données
• Dernière version en ligne fonctionnelle
• Si les données de production doivent être conservées
• Si vous souhaitez synchroniser entièrement les données de Development ou seulement compléter les structures manquantes

Contactez le support avec ces détails afin que nous puissions comparer les versions Development/Production, le statut de migration et les différences de schéma avant d’apporter des modifications.

Pourquoi mes données de développement sont-elles différentes des données de production ?

Si vous avez publié plusieurs fois mais que Production affiche encore d’anciennes données alors que les mises à jour du code fonctionnent correctement :

Avant de contacter le support, confirmez :

1. Les données actuelles de production doivent-elles être conservées ?

2. Souhaitez-vous les écraser complètement avec les données actuelles de Development, ou seulement compléter les enregistrements manquants ?

3. Avez-vous déjà une sauvegarde ?

4. Quelle est votre fenêtre de maintenance acceptable ?

Nous n’écraserons ni ne reconstruirons les données de production tant que l’objectif de traitement des données n’aura pas été confirmé. Fournissez les URL Development/Production et des exemples d’ID d’enregistrements ou de nombres montrant la différence.