Atoms Cloud Database slaat de gestructureerde gegevens op en beheert deze waar je app op vertrouwt, waaronder producten, boekingen, bestellingen, formulierinzendingen en door gebruikers gegenereerde inhoud. In de module Database kun je omgevingen en tabellen bekijken, records zoeken en bewerken, tabelstructuren inspecteren en gegevens importeren of exporteren met CSV-bestanden.

Deze handleiding behandelt de database die is ingebouwd in Atoms Cloud. Als je project Supabase gebruikt, bekijk dan in plaats daarvan Supabase Verbinden.

Een database openen

Voordat je een database opent, verbind je je project met Atoms Cloud. Als het nog niet is verbonden, volg dan de verbindingsstappen in Atoms Cloud.

1. Open je project op een desktopapparaat.
2. Selecteer in dezelfde toolbar van de werkruimte waar de App Viewer staat, Atoms Cloud.
3. Selecteer Database in de zijbalk van Atoms Cloud.
4. Selecteer onder Databases welke database je wilt inspecteren. De databasekaarten Development en Production verschijnen wanneer ze beschikbaar zijn voor het project.

Elke databasekaart toont hoeveel opslag wordt gebruikt en de totale beschikbare hoeveelheid. Gebruik Development terwijl je je app bouwt en test. Wijzigingen die in Production worden aangebracht, kunnen invloed hebben op de gegevens van de live app, dus controleer altijd in welke omgeving je je bevindt voordat je wijzigingen aanbrengt.

Kies de database Development of Production.

Tabelgegevens bekijken en filteren

1. Selecteer de databasekaart Development of Production, afhankelijk van de omgeving waarin je wilt werken.
2. Gebruik Search tables om een tabel te vinden, of selecteer er direct een uit de lijst. Elke tabelkaart toont het aantal rijen en of deze alleen-lezen is.
3. Gebruik Search rows om binnen de huidige tabel te zoeken, of selecteer Filter om de resultaten te verfijnen met een of meer velden.
4. Gebruik de paginapijlbediening onder de tabel om extra rijen te bekijken.
5. Om de structuur van de tabel te inspecteren, open je het menu ••• en selecteer je Schema.

De weergave Schema toont de naam, het gegevenstype, de sleutelstatus, vereisten, beperkingen en standaardwaarde van elk veld. Selecteer Copy om het weergegeven schema te kopiëren.

Rijen toevoegen, bewerken of verwijderen

Wanneer je de database hebt gevonden waarin je wijzigingen wilt aanbrengen, kun je daarvoor deze acties gebruiken:

Bewerking	Hoe je dit doet
Een rij toevoegen	Open ... en selecteer Add Row. Voer waarden in die overeenkomen met de beschikbare velden en dien daarna de rij in.
Een rij bewerken	Dubbelklik op een cel en voer de nieuwe waarde in. Selecteer Commit Changes om alle openstaande bewerkingen op te slaan, of Discard om ze te verwijderen.
Rijen verwijderen	Selecteer een of meer rijen, selecteer Delete en bevestig daarna. Het verwijderen van rijen kan niet ongedaan worden gemaakt.

Het toevoegen van een rij of het bevestigen van een verwijdering past de wijziging onmiddellijk toe op de geselecteerde database. Alleen inline celbewerkingen vereisen dat je Commit Changes of Discard selecteert. Als je openstaande bewerkingen hebt, commit of verwerp deze dan voordat je een rij toevoegt, een CSV-bestand importeert of exporteert, de zoekopdracht of filters wijzigt, of naar een andere pagina navigeert.

Als het project zich in een werkruimte bevindt, kunnen alleen Editors en de workspace owner rijen bewerken in beschrijfbare tabellen. Als Atoms geen primaire sleutel voor een tabel kan detecteren, kun je de rijen ervan niet bewerken of verwijderen omdat Atoms individuele records dan niet betrouwbaar kan identificeren.

Controleer een openstaande rijbewerking en commit of verwerp daarna de wijziging.

Tabellen maken of het schema wijzigen

Open de databaseomgeving die je wilt bijwerken en volg daarna de instructies voor de wijziging die je wilt aanbrengen:

Bewerking	Hoe je dit doet
Een tabel maken	Klik in de tabellijst op ... en selecteer Create table. Voer een geldige tabelnaam en de beginvelden in en dien daarna het verzoek in. Wacht tot de Agent klaar is, open Database opnieuw en controleer de tabel.
Het schema wijzigen	Klik op de tabel waarin je wijzigingen wilt aanbrengen, klik daarna op ... en selecteer Schema. Gebruik Add Field om een veld te maken, of selecteer een geschikt veld om het te bewerken. Je kunt de naam, het type, de standaardwaarde, de verplichte status of de uniekheid wijzigen. Je kunt ook niet-sleutelvelden markeren voor verwijdering. Selecteer Submit Changes om het verzoek naar de Agent te sturen, of Discard om je openstaande wijzigingen te wissen.

Alleen de workspace owner kan tabellen maken of het schema van een tabel wijzigen.

Het indienen van een schemaverzoek betekent niet dat de migratie voltooid is. Wacht tot de Agent klaar is, controleer het resultaat in Database en test daarna je app. Primaire-sleutelvelden en alleen-lezen tabellen kunnen op deze manier niet worden gewijzigd.

Voer de details van het nieuwe veld in bij Add Field.

Controleer openstaande schemawijzigingen voordat je Submit Changes selecteert.

CSV-gegevens importeren of exporteren

Selecteer de tabel waarmee je wilt werken en volg daarna de instructies voor de relevante bewerking:

Bewerking	Hoe je dit doet
CSV importeren	Klik op ... en selecteer Import CSV. Kies een .csv-bestand dat niet groter is dan 10 MB en controleer daarna de bestandsnaam, het geschatte aantal rijen, de geselecteerde tabel en de omgeving voordat je bevestigt. De CSV-kolommen moeten overeenkomen met het schema van de tabel. Geïmporteerde rijen worden onmiddellijk toegevoegd en kunnen niet automatisch ongedaan worden gemaakt, dus overweeg eerst de bestaande gegevens te exporteren.
CSV exporteren	Klik op ... en selecteer Export CSV. Als een zoekopdracht of filter actief is, worden alleen de overeenkomende rijen geëxporteerd. Anders worden alle gegevens uit de huidige tabel geëxporteerd.

Alleen de workspace owner kan CSV-bestanden importeren of exporteren. Voor alleen-lezen tabellen is Export CSV de enige beschikbare optie.

Machtigingen en beschermde tabellen

Actie	Wie kan dit uitvoeren	Aanvullende vereisten
Rijen toevoegen, bewerken of verwijderen	Editor of workspace owner	De tabel moet beschrijfbaar zijn. Voor het bewerken en verwijderen van rijen is ook primaire-sleutelinformatie vereist.
Tabellen maken of schema's wijzigen	Werkruimte owner	Primaire-sleutelvelden en alleen-lezen tabellen kunnen niet worden gewijzigd.
CSV-bestanden importeren of exporteren	Werkruimte owner	CSV-bestanden kunnen niet worden geïmporteerd in alleen-lezen tabellen.

Beschermde systeem- of gebruikerstabellen kunnen een badge Read-only weergeven. Je kunt hun gegevens bekijken en hun schema inspecteren wanneer beschikbaar, maar je kunt hun rijen of structuur niet vanaf deze pagina wijzigen.

Veelvoorkomende databaseproblemen oplossen

“No databases found” of “No tables found”

Zorg ervoor dat Atoms Cloud is verbonden met het project. Als het al verbonden is, controleer dan of je app een functie bevat die persistente gegevens opslaat. Vraag indien nodig de Agent om de functie met databaseondersteuning toe te voegen. Zodra de Agent klaar is, open je Database opnieuw of selecteer je Refresh.

Een databaseactie ontbreekt of is niet beschikbaar

Controleer of de tabel een badge Read-only heeft en bekijk daarna de bovenstaande machtigingen om te bevestigen dat je werkruimterol de actie toestaat. Voor het bewerken en verwijderen van rijen is ook primaire-sleutelinformatie vereist.

Openstaande rijbewerkingen kunnen andere acties blokkeren. Selecteer Commit Changes of Discard voordat je een rij toevoegt, een CSV-bestand importeert of exporteert, de zoekopdracht of filters wijzigt, of naar een andere pagina gaat.

Als de actie na deze controles nog steeds niet beschikbaar is, neem dan contact op met Support en voeg de project- of Chat-link, omgeving, tabel, werkruimterol, uitgevoerde actie en exacte fouttekst toe.

Een CSV-bestand kan niet worden geïmporteerd

Alleen de workspace owner kan gegevens importeren, en de doeltabel moet beschrijfbaar zijn. Zorg ervoor dat:

• Het bestand de indeling .csv gebruikt.
• Het bestand niet groter is dan 10 MB.
• De kolommen en gegevens compatibel zijn met het schema van de doeltabel.
• Je eventuele openstaande rijbewerkingen hebt gecommit of verworpen.

Als het importeren nog steeds mislukt, neem dan contact op met Support en voeg de project- of Chat-link, omgeving, doeltabel, werkruimterol, bestandsnaam en -grootte, uitgevoerde actie en exacte fouttekst toe.

FAQ

Mijn productiedatabase synchroniseert niet. Wat moet ik doen?

Als Development normaal werkt maar de live site (Production) ontbrekende tabellen, kolommen of migratiefouten toont:

Belangrijk: Bouw de productiedatabase niet zelf opnieuw op en overschrijf deze niet.

Benodigde informatie:

• Chat-link en live-URL
• Volledige SQL-foutmelding
• Namen van ontbrekende tabellen/kolommen
• Laatste wijziging van het databaseschema
• Laatste werkende live versie
• Of productiegegevens behouden moeten blijven
• Of je Development-gegevens volledig wilt synchroniseren of alleen ontbrekende structuren wilt aanvullen

Neem met deze gegevens contact op met support, zodat we Development-/Production-versies, migratiestatus en schemaverschillen kunnen vergelijken voordat we wijzigingen aanbrengen.

Waarom verschillen mijn ontwikkelingsgegevens van productiegegevens?

Als je meerdere keren hebt gepubliceerd maar Production nog steeds oude gegevens toont terwijl code-updates prima werken:

Bevestig voordat je contact opneemt met support het volgende:

1. Moeten de huidige productiegegevens behouden blijven?

2. Wil je volledig overschrijven met de huidige Development-gegevens, of alleen ontbrekende records aanvullen?

3. Heb je al een back-up?

4. Wat is je acceptabele onderhoudsvenster?

We zullen productiegegevens niet overschrijven of opnieuw opbouwen totdat het doel voor gegevensverwerking is bevestigd. Geef de Development-/Production-URL's en voorbeeldrecord-ID's of aantallen op die het verschil laten zien.