Atoms Cloud Datenbank speichert und verwaltet die strukturierten Daten, auf die sich Ihre App stützt, einschließlich Produkte, Buchungen, Bestellungen, Formulareinsendungen und nutzergenerierte Inhalte. Im Modul Datenbank können Sie Umgebungen und Tabellen anzeigen, Datensätze suchen und bearbeiten, Tabellenstrukturen prüfen sowie Daten mithilfe von CSV-Dateien importieren oder exportieren.

Dieser Leitfaden behandelt die in Atoms Cloud integrierte Datenbank. Wenn Ihr Projekt Supabase verwendet, lesen Sie stattdessen Supabase verbinden.

Eine Datenbank öffnen

Bevor Sie eine Datenbank öffnen, verbinden Sie Ihr Projekt mit Atoms Cloud. Wenn es noch nicht verbunden ist, folgen Sie den Verbindungsschritten in Atoms Cloud.

1. Öffnen Sie Ihr Projekt auf einem Desktop-Gerät.
2. Wählen Sie in derselben Symbolleiste des Arbeitsbereichs, in der sich der App-Viewer befindet, Atoms Cloud aus.
3. Wählen Sie in der Atoms Cloud-Seitenleiste Datenbank aus.
4. Wählen Sie unter Datenbanken aus, welche Datenbank Sie prüfen möchten. Die Datenbankkarten Development und Production werden angezeigt, wenn sie für das Projekt verfügbar sind.

Jede Datenbankkarte zeigt an, wie viel Speicher verwendet wird und wie viel insgesamt verfügbar ist. Verwenden Sie Development, während Sie Ihre App erstellen und testen. Änderungen in Production können sich auf die Daten der Live-App auswirken. Prüfen Sie daher immer, in welcher Umgebung Sie sich befinden, bevor Sie Änderungen vornehmen.

Wählen Sie die Datenbank Development oder Production aus.

Tabellendaten durchsuchen und filtern

1. Wählen Sie je nach der Umgebung, in der Sie arbeiten möchten, die Datenbankkarte Development oder Production aus.
2. Verwenden Sie Search tables, um eine Tabelle zu finden, oder wählen Sie eine direkt aus der Liste aus. Jede Tabellenkarte zeigt ihre Zeilenanzahl und an, ob sie schreibgeschützt ist.
3. Verwenden Sie Search rows, um innerhalb der aktuellen Tabelle zu suchen, oder wählen Sie Filter, um die Ergebnisse mithilfe eines oder mehrerer Felder einzugrenzen.
4. Verwenden Sie die Pfeilsteuerung für Seiten unterhalb der Tabelle, um weitere Zeilen anzuzeigen.
5. Um die Struktur der Tabelle zu prüfen, öffnen Sie das Menü ••• und wählen Sie Schema aus.

Die Ansicht Schema zeigt den Namen, den Datentyp, den Schlüsselstatus, Anforderungen, Einschränkungen und den Standardwert jedes Felds an. Wählen Sie Copy, um das angezeigte Schema zu kopieren.

Zeilen hinzufügen, bearbeiten oder löschen

Wenn Sie die Datenbank gefunden haben, an der Sie Änderungen vornehmen möchten, können Sie dazu diese Aktionen verwenden:

Vorgang	So geht's
Eine Zeile hinzufügen	Öffnen Sie ... und wählen Sie Add Row aus. Geben Sie Werte ein, die zu den verfügbaren Feldern passen, und senden Sie dann die Zeile ab.
Eine Zeile bearbeiten	Doppelklicken Sie auf eine Zelle und geben Sie den neuen Wert ein. Wählen Sie Commit Changes, um alle ausstehenden Bearbeitungen zu speichern, oder Discard, um sie zu verwerfen.
Zeilen löschen	Wählen Sie eine oder mehrere Zeilen aus, wählen Sie Delete und bestätigen Sie dann. Das Löschen von Zeilen kann nicht rückgängig gemacht werden.

Das Hinzufügen einer Zeile oder das Bestätigen einer Löschung wendet die Änderung sofort auf die ausgewählte Datenbank an. Nur bei Inline-Bearbeitungen von Zellen müssen Sie Commit Changes oder Discard auswählen. Wenn Sie ausstehende Bearbeitungen haben, übernehmen oder verwerfen Sie diese, bevor Sie eine Zeile hinzufügen, eine CSV-Datei importieren oder exportieren, die Suche oder Filter ändern oder zu einer anderen Seite navigieren.

Wenn sich das Projekt in einem Arbeitsbereich befindet, können nur Editors und der workspace owner Zeilen in beschreibbaren Tabellen bearbeiten. Wenn Atoms keinen Primärschlüssel für eine Tabelle erkennen kann, können Sie deren Zeilen nicht bearbeiten oder löschen, da Atoms einzelne Datensätze nicht zuverlässig identifizieren kann.

Prüfen Sie eine ausstehende Zeilenbearbeitung und übernehmen oder verwerfen Sie dann die Änderung.

Tabellen erstellen oder das Schema ändern

Öffnen Sie die Datenbankumgebung, die Sie aktualisieren möchten, und folgen Sie dann den Anweisungen für die Änderung, die Sie vornehmen möchten:

Vorgang	So geht's
Eine Tabelle erstellen	Klicken Sie in der Tabellenliste auf ... und wählen Sie Create table aus. Geben Sie einen gültigen Tabellennamen und die anfänglichen Felder ein und senden Sie dann die Anfrage ab. Warten Sie, bis der Agent fertig ist, öffnen Sie Datenbank erneut und überprüfen Sie die Tabelle.
Das Schema ändern	Klicken Sie auf die Tabelle, an der Sie Änderungen vornehmen möchten, klicken Sie dann auf ... und wählen Sie Schema. Verwenden Sie Add Field, um ein Feld zu erstellen, oder wählen Sie ein geeignetes Feld aus, um es zu bearbeiten. Sie können seinen Namen, Typ, Standardwert, Pflichtstatus oder seine Eindeutigkeit ändern. Sie können auch Nicht-Schlüsselfelder zum Löschen markieren. Wählen Sie Submit Changes, um die Anfrage an den Agent zu senden, oder Discard, um Ihre ausstehenden Änderungen zu verwerfen.

Nur der workspace owner kann Tabellen erstellen oder das Schema einer Tabelle ändern.

Das Absenden einer Schemaanfrage bedeutet nicht, dass die Migration abgeschlossen ist. Warten Sie, bis der Agent fertig ist, überprüfen Sie das Ergebnis in Datenbank und testen Sie anschließend Ihre App. Primärschlüsselfelder und schreibgeschützte Tabellen können auf diese Weise nicht geändert werden.

Geben Sie die Details des neuen Felds in Add Field ein.

Prüfen Sie ausstehende Schemaänderungen, bevor Sie Submit Changes auswählen.

CSV-Daten importieren oder exportieren

Wählen Sie die Tabelle aus, mit der Sie arbeiten möchten, und folgen Sie dann den Anweisungen für den entsprechenden Vorgang:

Vorgang	So geht's
CSV importieren	Klicken Sie auf ... und wählen Sie Import CSV aus. Wählen Sie eine .csv-Datei mit einer Größe von höchstens 10 MB aus und prüfen Sie dann Dateiname, geschätzte Zeilenanzahl, ausgewählte Tabelle und Umgebung, bevor Sie bestätigen. Die CSV-Spalten müssen mit dem Tabellenschema übereinstimmen. Importierte Zeilen werden sofort hinzugefügt und können nicht automatisch rückgängig gemacht werden. Erwägen Sie daher, zuerst die vorhandenen Daten zu exportieren.
CSV exportieren	Klicken Sie auf ... und wählen Sie Export CSV aus. Wenn eine Suche oder ein Filter aktiv ist, werden nur die übereinstimmenden Zeilen exportiert. Andernfalls werden alle Daten aus der aktuellen Tabelle exportiert.

Nur der workspace owner kann CSV-Dateien importieren oder exportieren. Bei schreibgeschützten Tabellen ist Export CSV die einzige verfügbare Option.

Berechtigungen und geschützte Tabellen

Aktion	Wer kann sie ausführen	Zusätzliche Anforderungen
Zeilen hinzufügen, bearbeiten oder löschen	Editor oder workspace owner	Die Tabelle muss beschreibbar sein. Das Bearbeiten und Löschen von Zeilen erfordert außerdem Primärschlüsselinformationen.
Tabellen erstellen oder Schemas ändern	Workspace owner	Primärschlüsselfelder und schreibgeschützte Tabellen können nicht geändert werden.
CSV-Dateien importieren oder exportieren	Workspace owner	CSV-Dateien können nicht in schreibgeschützte Tabellen importiert werden.

Geschützte System- oder Benutzertabellen können ein Read-only-Badge anzeigen. Sie können deren Daten anzeigen und ihr Schema prüfen, sofern verfügbar, aber Sie können ihre Zeilen oder Struktur nicht von dieser Seite aus ändern.

Häufige Datenbankprobleme beheben

„Keine Datenbanken gefunden“ oder „Keine Tabellen gefunden“

Stellen Sie sicher, dass Atoms Cloud mit dem Projekt verbunden ist. Wenn es bereits verbunden ist, vergewissern Sie sich, dass Ihre App eine Funktion enthält, die persistente Daten speichert. Falls nötig, bitten Sie den Agent, die datenbankgestützte Funktion hinzuzufügen. Sobald der Agent fertig ist, öffnen Sie Datenbank erneut oder wählen Sie Refresh.

Eine Datenbankaktion fehlt oder ist nicht verfügbar

Prüfen Sie, ob die Tabelle ein Read-only-Badge hat, und sehen Sie sich dann die obigen Berechtigungen an, um zu bestätigen, dass Ihre Rolle im Arbeitsbereich die Aktion erlaubt. Das Bearbeiten und Löschen von Zeilen erfordert außerdem Primärschlüsselinformationen.

Ausstehende Zeilenbearbeitungen können andere Aktionen verhindern. Wählen Sie Commit Changes oder Discard, bevor Sie eine Zeile hinzufügen, eine CSV-Datei importieren oder exportieren, die Suche oder Filter ändern oder zu einer anderen Seite wechseln.

Wenn die Aktion nach diesen Prüfungen weiterhin nicht verfügbar ist, wenden Sie sich an den Support und geben Sie den Projekt- oder Chat-Link, die Umgebung, die Tabelle, die Rolle im Arbeitsbereich, die versuchte Aktion und den genauen Fehlertext an.

Eine CSV-Datei kann nicht importiert werden

Nur der workspace owner kann Daten importieren, und die Zieltabelle muss beschreibbar sein. Stellen Sie sicher, dass:

• die Datei das Format .csv verwendet.
• die Datei nicht größer als 10 MB ist.
• ihre Spalten und Daten mit dem Schema der Zieltabelle kompatibel sind.
• Sie alle ausstehenden Zeilenbearbeitungen übernommen oder verworfen haben.

Wenn der Import weiterhin fehlschlägt, wenden Sie sich an den Support und geben Sie den Projekt- oder Chat-Link, die Umgebung, die Zieltabelle, die Rolle im Arbeitsbereich, den Dateinamen und die Dateigröße, die versuchte Aktion und den genauen Fehlertext an.

FAQ

Meine Produktionsdatenbank synchronisiert sich nicht. Was soll ich tun?

Wenn Development normal funktioniert, aber auf der Live-Website (Production) Tabellen, Spalten oder Migrationsfehler fehlen:

Wichtig: Erstellen Sie die Produktionsdatenbank nicht selbst neu und überschreiben Sie sie nicht eigenständig.

Benötigte Informationen:

• Chat-Link und Live-URL
• Vollständige SQL-Fehlermeldung
• Namen fehlender Tabellen/Spalten
• Letzte Änderung des Datenbankschemas
• Letzte funktionierende Live-Version
• Ob Produktionsdaten erhalten bleiben müssen
• Ob Sie die Development-Daten vollständig synchronisieren oder nur fehlende Strukturen ergänzen möchten

Kontaktieren Sie den Support mit diesen Angaben, damit wir vor Änderungen die Versionen von Development/Production, den Migrationsstatus und Schemaunterschiede vergleichen können.

Warum unterscheiden sich meine Entwicklungsdaten von den Produktionsdaten?

Wenn Sie mehrfach veröffentlicht haben, aber Production weiterhin alte Daten anzeigt, während Code-Updates einwandfrei funktionieren:

Bestätigen Sie vor der Kontaktaufnahme mit dem Support Folgendes:

1. Müssen die aktuellen Produktionsdaten erhalten bleiben?

2. Möchten Sie sie vollständig mit den aktuellen Development-Daten überschreiben oder nur fehlende Datensätze ergänzen?

3. Haben Sie bereits ein Backup?

4. Welches Wartungsfenster ist für Sie akzeptabel?

Wir werden Produktionsdaten nicht überschreiben oder neu erstellen, bis das Ziel für den Umgang mit den Daten bestätigt ist. Geben Sie die Development/Production-URLs und Beispiel-Datensatz-IDs oder -Anzahlen an, die den Unterschied zeigen.