Database

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 werkruimtewerkbalk waar de App Viewer staat, Atoms Cloud.
3. Selecteer Database in de Atoms Cloud-zijbalk.
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 opslagruimte 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 vervolgens 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 vervolgens. 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 bewerkingen van cellen 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.

Bekijk 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 initiële velden in en dien vervolgens 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 vervolgens 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 uniciteit 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 is voltooid. 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.

Bekijk 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
Import CSV	Klik op ... en selecteer Import CSV. Kies een .csv-bestand dat niet groter is dan 10 MB en controleer vervolgens de bestandsnaam, het geschatte aantal rijen, de geselecteerde tabel en de omgeving voordat je bevestigt. De CSV-kolommen moeten overeenkomen met het tabelschema. Geïmporteerde rijen worden onmiddellijk toegevoegd en kunnen niet automatisch ongedaan worden gemaakt, dus overweeg eerst de bestaande gegevens te exporteren.
Export CSV	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 tonen. 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 met het project is verbonden. Als het al is verbonden, controleer dan of je app een functie bevat die persistente gegevens opslaat. Vraag de Agent indien nodig om de functie toe te voegen die door de database wordt ondersteund. 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 mijn 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 deze 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 de gegevensverwerking is bevestigd. Geef de Development-/Production-URL's en voorbeeldrecord-ID's of aantallen die het verschil laten zien.