Supabase verbinden

Diese Anleitung führt dich durch den gesamten Ablauf: ein Supabase-Konto und -Projekt vorbereiten, die richtige Organisation autorisieren, das Projekt verbinden, prüfen, ob die Verbindung funktioniert hat, und sie bei Bedarf trennen.

So funktioniert die Verbindung

Jedes Supabase-Projekt gehört zu einer Organisation, die steuert, wer auf die darin enthaltenen Projekte zugreifen und sie verwalten kann. Wenn du Supabase mit Atoms verbindest, autorisierst du zuerst Atoms für den Zugriff auf die Organisation, die du verwenden möchtest, und wählst dann ein Projekt aus dieser Organisation zum Verbinden aus.

Jedes Atoms-Projekt kann jeweils nur mit einem Supabase-Projekt gleichzeitig verbunden sein. Dasselbe Supabase-Projekt kann jedoch mit mehr als einem Atoms-Projekt verbunden sein.

Supabase und Atoms Cloud sind alternative Backend-Optionen. Du kannst nicht beide gleichzeitig mit demselben Atoms-Projekt verbinden.

Bevor du beginnst

Bevor du Supabase verbindest, stelle sicher, dass:

• du der Inhaber des Atoms-Arbeitsbereichs bist, der das Projekt enthält. Nur der Inhaber des Arbeitsbereichs kann Supabase autorisieren, verbinden oder trennen.
• du ein Supabase-Konto hast oder bereit bist, während der Einrichtung eines zu erstellen.
• du berechtigt bist, die Supabase-Organisation zu autorisieren und auf das Projekt zuzugreifen, mit dem du dich verbinden möchtest.
• der Agent seine aktuelle Aufgabe abgeschlossen hat und Rennmodus ausgeschaltet ist.
• dein Browser Pop-up-Fenster von Atoms zulässt.
• dein Atoms-Projekt nicht bereits mit Atoms Cloud verbunden ist.

Wenn du diese Verbindung zum ersten Mal ausprobierst, solltest du während des Kennenlernens des Ablaufs ein Testprojekt verwenden.

Füge niemals ein Supabase-Passwort, einen API-Schlüssel, ein Zugriffstoken oder andere Zugangsdaten in den Chat ein.

Supabase verbinden

Den Supabase-Connector öffnen

1. Öffne das Projekt, das du verbinden möchtest.
2. Klicke oben rechts im Chat-Bereich auf den Projektnamen.
3. Wähle im angezeigten Dropdown-Menü Connectors aus.
4. Suche Supabase in der Liste der verfügbaren Connectors und klicke auf connect.

Du kannst auch Settings → Connectors → Supabase öffnen und Connect auswählen.

Öffne Settings → Connectors und wähle Connect für Supabase aus.

Atoms in Supabase autorisieren

Wenn unter Organizations bereits die Supabase-Organisation angezeigt wird, die du verwenden möchtest, wurde sie bereits autorisiert. Du kannst mit Das Supabase-Projekt auswählen fortfahren.

1. Atoms öffnet ein Supabase-Autorisierungsfenster. Melde dich bei dem Supabase-Konto an, mit dem du dich verbinden möchtest, oder erstelle bei Bedarf ein neues Konto.
2. Prüfe, dass du beim richtigen Supabase-Konto angemeldet bist, und wähle dann die Organisation aus, auf die Atoms zugreifen soll.
3. Prüfe die von Atoms angeforderten Berechtigungen. Um jede Berechtigung zu sehen, wähle Show detailed permissions aus. Wenn du zustimmst, wähle Authorize Atoms aus.
4. Kehre zu Atoms zurück und warte auf die Meldung Connect success.
5. Öffne in Atoms Connectors → Supabase und bestätige, dass die Organisation unter Organizations erscheint.

Atoms fordert Lese- und Schreibzugriff auf Datenbank, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST und Storage an. Außerdem fordert es Lesezugriff auf Organizations und Domains an. Diese Berechtigungen ermöglichen Atoms, die von deinem Projekt verwendeten unterstützten Supabase-Dienste zu verbinden und zu verwalten.

Diese Autorisierung gilt für die ausgewählte Supabase-Organisation und ist nicht auf das Supabase-Projekt beschränkt, das du später mit dem aktuellen Atoms-Projekt verbindest. Atoms kann nicht auf Organisationen oder Projekte zugreifen, auf die das verbundene Supabase-Konto selbst nicht zugreifen kann, und Supabase-Berechtigungen können zusätzliche Einschränkungen auferlegen.

Prüfe die Organisation und die Berechtigungen, bevor du Atoms autorisierst.

Das Supabase-Projekt auswählen

1. Erweitere unter Organizations die Organisation, die du autorisiert hast.
2. Suche unter Projects das aktive Supabase-Projekt, das du verbinden möchtest.
3. Wenn die benötigte Organisation nicht aufgeführt ist, wähle New Organization und autorisiere sie. Dadurch wird keine neue Supabase-Organisation erstellt; du kannst damit eine andere Organisation autorisieren, die bereits in deinem Supabase-Konto existiert.
4. Wenn du noch kein Projekt hast, wähle Create Project und erstelle eines in Supabase. Warte, bis das Projekt aktiv und einsatzbereit ist, kehre dann zu Atoms zurück und wähle Update, um die Projektliste zu aktualisieren.
5. Wähle neben dem Projekt, das du verwenden möchtest, Connect aus.

Wähle ein Supabase-Projekt aus der autorisierten Organisation aus.

Das Projekt bestätigen

1. Prüfe im Bestätigungsfenster die unter Supabase Project angezeigte Organisation und das Projekt.
2. Verwende bei Bedarf Supabase Dashboard oder View Tables, um zu bestätigen, dass du das richtige Projekt ausgewählt hast.
3. Wähle Connect aus.
4. Atoms fügt dem Projekt-Chat ein Supabase-Verbindungselement hinzu. Lass die Seite geöffnet und warte, bis der Vorgang abgeschlossen ist, bevor du den Agent bittest, eine Datenbank-, Authentifizierungs-, Speicher- oder Backend-Funktion zu erstellen.

Bestätige das ausgewählte Supabase-Projekt, bevor du die Verbindung herstellst.

Prüfen, ob die Verbindung funktioniert hat

1. Öffne Settings → Connectors → Supabase.
2. Bestätige, dass die richtige Organisation und das richtige Supabase-Projekt als verbunden angezeigt werden.
3. Wähle Dashboard oder Tables und prüfe, dass dasselbe Projekt in Supabase geöffnet wird.

Das Panel des verbundenen Projekts kann auch Links zu Manage Users, SQL Editor, Edge Functions und Manage Secrets enthalten. Du musst nur die Bereiche verwenden, die für die Funktionen relevant sind, die du erstellst.

Prüfe das verbundene Supabase-Projekt und seine Verwaltungslinks.

Testen, ob deine App Daten speichern kann

Das Verbinden von Supabase fügt deiner App nicht automatisch eine Datenbankfunktion hinzu. Bitte im Chat den Agent, die gewünschte Funktion zu erstellen und das verbundene Supabase-Projekt zum Speichern der Daten zu verwenden. Nachdem der Agent fertig ist, teste den gesamten Ablauf.

1. Beschreibe im Chat die gewünschte Funktion, welche Informationen sie speichern soll und wo Benutzer diese Informationen wieder sehen sollen. Weise den Agent an, das verbundene Supabase-Projekt zu verwenden.
2. Warte, bis der Agent die Funktion fertig erstellt hat.
3. Verwende die Funktion im App-Viewer so, wie es ein Benutzer tun würde, und gib harmlose Testdaten ein. Verwende keine persönlichen, vertraulichen oder sensiblen Informationen.
4. Aktualisiere den App-Viewer oder öffne die Funktion erneut. Bestätige, dass die gespeicherten Informationen erhalten bleiben und an der richtigen Stelle erscheinen.
5. Öffne Settings → Connectors → Supabase, wähle Tables aus und bestätige, dass der entsprechende Datensatz in der richtigen Tabelle erscheint.

Wenn die Funktion es Benutzern erlaubt, gespeicherte Informationen zu bearbeiten oder zu löschen, teste auch diese Aktionen und bestätige, dass die Ergebnisse sowohl in der App als auch in Supabase korrekt sind. Ob direkt in Supabase vorgenommene Änderungen sofort in der App erscheinen, hängt davon ab, wie die App erstellt wurde.

Supabase trennen

Trenne Supabase, wenn das aktuelle Atoms-Projekt das verbundene Supabase-Projekt nicht mehr verwenden soll.

1. Öffne Settings → Connectors → Supabase.
2. Bestätige, dass du die Verbindung für das richtige Atoms-Projekt ansiehst.
3. Wähle Disconnect Project aus.
4. Warte, bis das Supabase-Trennungselement im Chat abgeschlossen ist.
5. Öffne Connectors → Supabase erneut und bestätige, dass das Projekt nicht mehr als verbunden angezeigt wird.

Durch das Trennen wird die Verbindung aus dem aktuellen Atoms-Projekt entfernt. Dadurch werden weder das Supabase-Projekt noch seine Daten gelöscht, und die Autorisierung für die Supabase-Organisation wird ebenfalls nicht entfernt.

Alle Funktionen in deinem Atoms-Projekt, die von Supabase abhängen, funktionieren nach dem Trennen möglicherweise nicht mehr. Wenn deine App bereits veröffentlicht ist, musst du möglicherweise die veröffentlichte Version aktualisieren, bevor die Änderung wirksam wird. Teste nach dem Trennen sowohl dein Projekt als auch die Live-App.

Das Trennen von Supabase von einem Atoms-Projekt hat keine Auswirkungen auf andere Atoms-Projekte, die mit demselben Supabase-Projekt verbunden sind.

FAQ

Warum funktioniert meine Supabase-Verbindung nicht mehr?

1. Öffne das Supabase Dashboard und prüfe den Status des betroffenen Projekts. Ein Projekt im Kostenloser Plan mit geringer Aktivität kann nach einem Zeitraum von sieben Tagen pausiert werden.
2. Wenn es pausiert ist, wähle Resume project und warte, bis Supabase meldet, dass es aktiv ist.
3. Kehre zu Atoms zurück, öffne das Connectors-Panel des Projekts und überprüfe die Supabase-Verbindung. Wiederhole die fehlgeschlagene Aktion einmal.
4. Wenn Supabase bereits aktiv ist, erfasse den genauen Atoms- oder Supabase-Fehler und prüfe, ob die Verbindung als getrennt oder abgelaufen angezeigt wird. Verbinde sie nur erneut, wenn der Status anzeigt, dass dies erforderlich ist.

Rotiere keine Schlüssel und erstelle kein Ersatzprojekt, bevor du die Ursache kennst und bestehende Daten geschützt hast. Wenn der Fehler weiterhin auftritt, kontaktiere den Support mit dem Chat Link, Uhrzeit und Zeitzone, Verbindungsstatus und einem bereinigten Screenshot des Fehlers.

External reference: Supabase — Project Pausing

Wie verbinde ich ein pausiertes Supabase-Projekt erneut?

1. Melde dich bei der richtigen Supabase-Organisation an und öffne das pausierte Projekt.
2. Wähle Resume project und warte, bis sein Status aktiv ist. Laut aktueller Supabase-Hinweise können Projekte im Kostenloser Plan mit geringer Aktivität nach einem Zeitraum von sieben Tagen mit geringer Aktivität pausiert werden.
3. Kehre zu Atoms zurück und öffne das Connectors-Panel des Projekts. Bestätige, dass Supabase verbunden ist, und wiederhole dann den betroffenen Vorgang.
4. Wenn Atoms den Connector weiterhin als getrennt oder abgelaufen anzeigt, verbinde ihn erneut und schließe die angeforderte Autorisierung ab.

Erstelle kein neues Supabase-Projekt und rotiere keine Zugangsdaten, bis bestehende Daten geschützt sind. Wenn die erneute Verbindung fehlschlägt, stelle dem Support den Chat Link, den Status des Supabase-Projekts, Uhrzeit und Zeitzone sowie einen bereinigten Screenshot des Fehlers zur Verfügung.

External reference: Supabase — Project Pausing