Verbinden Sie ein Atoms-Projekt mit Supabase, wenn die App eine Supabase-Datenbank, Authentifizierung, Dateispeicher oder Backend-Funktionen verwenden soll.

Diese Anleitung führt Sie 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 Sie Supabase mit Atoms verbinden, autorisieren Sie zuerst Atoms für den Zugriff auf die Organisation, die Sie verwenden möchten, und wählen dann ein Projekt aus dieser Organisation aus, das verbunden werden soll.

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

Supabase und Atoms Cloud sind alternative Backend-Optionen. Sie können nicht beide gleichzeitig mit demselben Atoms-Projekt verbunden werden.

Bevor Sie beginnen

Bevor Sie Supabase verbinden, stellen Sie sicher, dass:

• Sie der Inhaber des Atoms-Arbeitsbereichs sind, der das Projekt enthält. Nur der Inhaber des Arbeitsbereichs kann Supabase autorisieren, verbinden oder trennen.
• Sie ein Supabase-Konto haben oder bereit sind, während der Einrichtung eines zu erstellen.
• Sie berechtigt sind, die Supabase-Organisation zu autorisieren und auf das Projekt zuzugreifen, mit dem Sie eine Verbindung herstellen möchten.
• der Agent seine aktuelle Aufgabe abgeschlossen hat und Rennmodus deaktiviert ist.
• Ihr Browser Pop-up-Fenster von Atoms zulässt.
• Ihr Atoms-Projekt nicht bereits mit Atoms Cloud verbunden ist.

Wenn Sie diese Verbindung zum ersten Mal ausprobieren, sollten Sie ein Testprojekt verwenden, während Sie den Ablauf kennenlernen.

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

Supabase verbinden

Den Supabase-Connector öffnen

1. Öffnen Sie das Projekt, das Sie verbinden möchten.
2. Klicken Sie oben rechts im Chat-Bereich auf den Projektnamen.
3. Wählen Sie im angezeigten Dropdown-Menü Connectors aus.
4. Suchen Sie in der Liste der verfügbaren Connectors nach Supabase und klicken Sie auf connect.

Sie können auch Settings → Connectors → Supabase öffnen und Connect auswählen.

Öffnen Sie Settings → Connectors und wählen Sie Connect für Supabase aus.

Atoms in Supabase autorisieren

Wenn unter Organizations bereits die Supabase-Organisation angezeigt wird, die Sie verwenden möchten, wurde sie bereits autorisiert. Sie können mit Das Supabase-Projekt auswählen fortfahren.

1. Atoms öffnet ein Supabase-Autorisierungsfenster. Melden Sie sich bei dem Supabase-Konto an, das Sie verbinden möchten, oder erstellen Sie bei Bedarf ein neues Konto.
2. Prüfen Sie, dass Sie beim richtigen Supabase-Konto angemeldet sind, und wählen Sie dann die Organisation aus, auf die Atoms zugreifen soll.
3. Prüfen Sie die von Atoms angeforderten Berechtigungen. Um jede Berechtigung zu sehen, wählen Sie Show detailed permissions. Wenn Sie zustimmen, wählen Sie Authorize Atoms.
4. Kehren Sie zu Atoms zurück und warten Sie auf die Meldung Connect success.
5. Öffnen Sie in Atoms Connectors → Supabase und bestätigen Sie, dass die Organisation unter Organizations angezeigt wird.

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

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

Prüfen Sie die Organisation und Berechtigungen, bevor Sie Atoms autorisieren.

Das Supabase-Projekt auswählen

1. Erweitern Sie unter Organizations die Organisation, die Sie autorisiert haben.
2. Suchen Sie unter Projects das aktive Supabase-Projekt, das Sie verbinden möchten.
3. Wenn die benötigte Organisation nicht aufgeführt ist, wählen Sie New Organization und autorisieren Sie sie. Dadurch wird keine neue Supabase-Organisation erstellt; Sie können damit eine weitere Organisation autorisieren, die bereits in Ihrem Supabase-Konto vorhanden ist.
4. Wenn Sie noch kein Projekt haben, wählen Sie Create Project und erstellen Sie eines in Supabase. Warten Sie, bis das Projekt aktiv und einsatzbereit ist, kehren Sie dann zu Atoms zurück und wählen Sie Update, um die Projektliste zu aktualisieren.
5. Wählen Sie neben dem Projekt, das Sie verwenden möchten, Connect aus.

Wählen Sie ein Supabase-Projekt aus der autorisierten Organisation aus.

Das Projekt bestätigen

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

Bestätigen Sie das ausgewählte Supabase-Projekt, bevor Sie die Verbindung herstellen.

Prüfen, ob die Verbindung funktioniert hat

1. Öffnen Sie Settings → Connectors → Supabase.
2. Bestätigen Sie, dass die richtige Organisation und das richtige Supabase-Projekt als verbunden angezeigt werden.
3. Wählen Sie Dashboard oder Tables und prüfen Sie, dass dadurch 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. Sie müssen nur die Bereiche verwenden, die für die Funktionen relevant sind, die Sie erstellen.

Prüfen Sie das verbundene Supabase-Projekt und seine Verwaltungslinks.

Testen, ob Ihre App Daten speichern kann

Das Verbinden von Supabase fügt Ihrer App nicht automatisch eine Datenbankfunktion hinzu. Bitten Sie den Agent im Chat, die gewünschte Funktion zu erstellen und das verbundene Supabase-Projekt zum Speichern der Daten zu verwenden. Testen Sie nach Abschluss durch den Agent den gesamten Ablauf.

1. Beschreiben Sie im Chat die gewünschte Funktion, welche Informationen sie speichern soll und wo Benutzer diese Informationen wieder sehen sollen. Sagen Sie dem Agent, dass das verbundene Supabase-Projekt verwendet werden soll.
2. Warten Sie, bis der Agent die Funktion fertig erstellt hat.
3. Verwenden Sie die Funktion im App-Viewer so, wie es ein Benutzer tun würde, und geben Sie unbedenkliche Testdaten ein. Verwenden Sie keine persönlichen, vertraulichen oder sensiblen Informationen.
4. Aktualisieren Sie den App-Viewer oder öffnen Sie die Funktion erneut. Bestätigen Sie, dass die gespeicherten Informationen erhalten bleiben und an der richtigen Stelle angezeigt werden.
5. Öffnen Sie Settings → Connectors → Supabase, wählen Sie Tables und bestätigen Sie, dass der entsprechende Datensatz in der richtigen Tabelle erscheint.

Wenn die Funktion es Benutzern erlaubt, gespeicherte Informationen zu bearbeiten oder zu löschen, testen Sie auch diese Aktionen und bestätigen Sie, 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

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

1. Öffnen Sie Settings → Connectors → Supabase.
2. Bestätigen Sie, dass Sie die Verbindung für das richtige Atoms-Projekt anzeigen.
3. Wählen Sie Disconnect Project aus.
4. Warten Sie, bis das Supabase-Trennungselement im Chat abgeschlossen ist.
5. Öffnen Sie Connectors → Supabase erneut und bestätigen Sie, dass das Projekt nicht mehr als verbunden angezeigt wird.

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

Funktionen in Ihrem Atoms-Projekt, die von Supabase abhängen, funktionieren nach dem Trennen möglicherweise nicht mehr. Wenn Ihre App bereits veröffentlicht ist, müssen Sie möglicherweise die veröffentlichte Version aktualisieren, bevor die Änderung wirksam wird. Testen Sie nach dem Trennen sowohl Ihr Projekt als auch die Live-App.

Das Trennen von Supabase von einem Atoms-Projekt wirkt sich nicht auf andere Atoms-Projekte aus, die mit demselben Supabase-Projekt verbunden sind.

FAQ

Warum funktioniert meine Supabase-Verbindung nicht mehr?

1. Öffnen Sie das Supabase Dashboard und prüfen Sie 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ählen Sie Resume project und warten Sie, bis Supabase meldet, dass es aktiv ist.
3. Kehren Sie zu Atoms zurück, öffnen Sie das Connectors-Panel des Projekts und überprüfen Sie die Supabase-Verbindung. Wiederholen Sie die fehlgeschlagene Aktion einmal.
4. Wenn Supabase bereits aktiv ist, erfassen Sie den genauen Atoms- oder Supabase-Fehler und prüfen Sie, ob die Verbindung als getrennt oder abgelaufen angezeigt wird. Stellen Sie die Verbindung nur dann erneut her, wenn der Status anzeigt, dass dies erforderlich ist.

Tauschen Sie keine Schlüssel aus und erstellen Sie kein Ersatzprojekt, bevor Sie die Ursache kennen und bestehende Daten geschützt haben. Wenn der Fehler weiterhin auftritt, kontaktieren Sie den Support mit dem Chat Link, Uhrzeit und Zeitzone, Verbindungsstatus und einem bereinigten Screenshot des Fehlers.

Externe Referenz: Supabase — Project Pausing

Wie verbinde ich ein pausiertes Supabase-Projekt erneut?

1. Melden Sie sich bei der richtigen Supabase-Organisation an und öffnen Sie das pausierte Projekt.
2. Wählen Sie Resume project und warten Sie, bis sein Status aktiv ist. Laut aktueller Supabase-Richtlinie können Projekte im Kostenloser Plan mit geringer Aktivität nach einem Zeitraum von sieben Tagen mit geringer Aktivität pausiert werden.
3. Kehren Sie zu Atoms zurück und öffnen Sie das Connectors-Panel des Projekts. Bestätigen Sie, dass Supabase verbunden ist, und wiederholen Sie dann den betroffenen Vorgang.
4. Wenn Atoms den Connector weiterhin als getrennt oder abgelaufen anzeigt, verbinden Sie ihn erneut und schließen Sie die angeforderte Autorisierung ab.

Erstellen Sie kein neues Supabase-Projekt und tauschen Sie keine Zugangsdaten aus, bis bestehende Daten geschützt sind. Wenn die erneute Verbindung fehlschlägt, geben Sie dem Support den Chat Link, den Status des Supabase-Projekts, Uhrzeit und Zeitzone sowie einen bereinigten Screenshot des Fehlers an.

Externe Referenz: Supabase — Project Pausing