Supabase Verbinden

Deze handleiding neemt je mee door het volledige traject: een Supabase-account en -project voorbereiden, de juiste organisatie autoriseren, het project verbinden, controleren of de verbinding werkt en deze loskoppelen wanneer nodig.

Hoe de verbinding werkt

Elk Supabase-project behoort tot een organisatie, die bepaalt wie toegang heeft tot en beheer kan uitvoeren over de projecten daarin. Wanneer je Supabase met Atoms verbindt, autoriseer je eerst Atoms om toegang te krijgen tot de organisatie die je wilt gebruiken, en selecteer je daarna een project uit die organisatie om te verbinden.

Elk Atoms-project kan tegelijk met één Supabase-project verbonden zijn. Hetzelfde Supabase-project kan echter met meer dan één Atoms-project verbonden zijn.

Supabase en Atoms Cloud zijn alternatieve backendopties. Je kunt niet beide tegelijk met hetzelfde Atoms-project verbinden.

Voordat je begint

Voordat je Supabase verbindt, zorg ervoor dat:

• Je de eigenaar van de Atoms-werkruimte bent die het project bevat. Alleen de eigenaar van de werkruimte kan Supabase autoriseren, verbinden of loskoppelen.
• Je een Supabase-account hebt, of er klaar voor bent er tijdens de installatie een aan te maken.
• Je toestemming hebt om de Supabase-organisatie te autoriseren en toegang te krijgen tot het project waarmee je wilt verbinden.
• De Agent zijn huidige taak heeft voltooid en Race Modus is uitgeschakeld.
• Je browser pop-upvensters van Atoms toestaat.
• Je Atoms-project nog niet met Atoms Cloud is verbonden.

Als je deze verbinding voor het eerst probeert, overweeg dan om een testproject te gebruiken terwijl je het proces leert.

Plak nooit een Supabase-wachtwoord, API-sleutel, toegangstoken of andere inloggegevens in Chat.

Supabase Verbinden

Open de Supabase-connector

1. Open het project dat je wilt verbinden.
2. Klik op de projectnaam, rechtsboven in het chatpaneel.
3. Selecteer Connectors in het vervolgkeuzemenu dat verschijnt.
4. Zoek Supabase in de lijst met beschikbare connectors en klik op connect.

Je kunt ook Settings → Connectors → Supabase openen en Connect selecteren.

Open Settings → Connectors en selecteer Connect voor Supabase.

Autoriseer Atoms in Supabase

Als Organizations al de Supabase-organisatie toont die je wilt gebruiken, is deze al geautoriseerd. Je kunt doorgaan naar Kies het Supabase-project.

1. Atoms opent een Supabase-autorisatievenster. Meld je aan bij het Supabase-account waarmee je wilt verbinden, of maak indien nodig een nieuw account aan.
2. Controleer of je bent aangemeld bij het juiste Supabase-account en selecteer vervolgens de organisatie waartoe je Atoms toegang wilt geven.
3. Controleer de machtigingen die Atoms aanvraagt. Om elke machtiging te zien, selecteer Show detailed permissions. Als je akkoord gaat, selecteer Authorize Atoms.
4. Ga terug naar Atoms en wacht op het bericht Connect success.
5. Open in Atoms Connectors → Supabase en bevestig dat de organisatie onder Organizations verschijnt.

Atoms vraagt lees- en schrijftoegang tot Database, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST en Storage. Het vraagt ook leestoegang tot Organizations en Domains. Deze machtigingen stellen Atoms in staat om de ondersteunde Supabase-services die door je project worden gebruikt te verbinden en te beheren.

Deze autorisatie geldt voor de geselecteerde Supabase-organisatie en is niet beperkt tot het Supabase-project dat je later met het huidige Atoms-project verbindt. Atoms heeft geen toegang tot organisaties of projecten waartoe het verbonden Supabase-account zelf geen toegang heeft, en Supabase-machtigingen kunnen aanvullende beperkingen opleggen.

Controleer de organisatie en machtigingen voordat je Atoms autoriseert.

Kies het Supabase-project

1. Vouw onder Organizations de organisatie uit die je hebt geautoriseerd.
2. Zoek onder Projects het actieve Supabase-project dat je wilt verbinden.
3. Als de organisatie die je nodig hebt niet wordt vermeld, selecteer New Organization en autoriseer deze. Dit maakt geen nieuwe Supabase-organisatie aan; het stelt je in staat een andere organisatie te autoriseren die al bestaat in je Supabase-account.
4. Als je nog geen project hebt, selecteer Create Project en maak er een aan in Supabase. Wacht tot het project actief en klaar voor gebruik is, ga dan terug naar Atoms en selecteer Update om de projectlijst te vernieuwen.
5. Selecteer naast het project dat je wilt gebruiken Connect.

Kies een Supabase-project uit de geautoriseerde organisatie.

Bevestig het project

1. Controleer in het bevestigingsvenster de organisatie en het project die onder Supabase Project worden weergegeven.
2. Gebruik indien nodig Supabase Dashboard of View Tables om te bevestigen dat je het juiste project hebt geselecteerd.
3. Selecteer Connect.
4. Atoms voegt een Supabase-verbindingsitem toe aan de project-Chat. Houd de pagina open en wacht tot dit is voltooid voordat je de Agent vraagt een database-, authenticatie-, opslag- of backendfunctie te bouwen.

Bevestig het geselecteerde Supabase-project voordat je verbindt.

Controleer of de verbinding werkt

1. Open Settings → Connectors → Supabase.
2. Bevestig dat de juiste organisatie en het juiste Supabase-project als verbonden worden weergegeven.
3. Selecteer Dashboard of Tables en controleer of hetzelfde project in Supabase wordt geopend.

Het paneel van het verbonden project kan ook links bevatten naar Manage Users, SQL Editor, Edge Functions en Manage Secrets. Je hoeft alleen de onderdelen te gebruiken die relevant zijn voor de functies die je bouwt.

Controleer het verbonden Supabase-project en de beheerkoppelingen ervan.

Test of je app gegevens kan opslaan

Het verbinden van Supabase voegt niet automatisch een databasefunctie toe aan je app. Vraag in Chat de Agent om de functie te bouwen die je wilt en het verbonden Supabase-project te gebruiken om de gegevens ervan op te slaan. Nadat de Agent klaar is, test je het volledige traject.

1. Beschrijf in Chat de functie die je wilt, welke informatie deze moet opslaan en waar gebruikers die informatie opnieuw moeten zien. Vertel de Agent om het verbonden Supabase-project te gebruiken.
2. Wacht tot de Agent klaar is met het bouwen van de functie.
3. Gebruik in de App Viewer de functie zoals een gebruiker dat zou doen en voer onschadelijke testgegevens in. Gebruik geen persoonlijke, vertrouwelijke of gevoelige informatie.
4. Vernieuw de App Viewer of open de functie opnieuw. Bevestig dat de opgeslagen informatie behouden blijft en op de juiste plaats verschijnt.
5. Open Settings → Connectors → Supabase, selecteer Tables en bevestig dat de overeenkomende record in de juiste tabel verschijnt.

Als de functie gebruikers toestaat opgeslagen informatie te bewerken of te verwijderen, test die acties dan ook en bevestig dat de resultaten correct zijn in zowel de app als Supabase. Of wijzigingen die rechtstreeks in Supabase worden aangebracht onmiddellijk in de app verschijnen, hangt af van hoe de app is gebouwd.

Supabase loskoppelen

Koppel Supabase los wanneer je niet langer wilt dat het huidige Atoms-project het verbonden Supabase-project gebruikt.

1. Open Settings → Connectors → Supabase.
2. Bevestig dat je de verbinding voor het juiste Atoms-project bekijkt.
3. Selecteer Disconnect Project.
4. Wacht tot het Supabase-ontkoppelingsitem in Chat is voltooid.
5. Open Connectors → Supabase opnieuw en bevestig dat het project niet langer als verbonden wordt weergegeven.

Door los te koppelen wordt de verbinding verwijderd uit het huidige Atoms-project. Het verwijdert het Supabase-project of de gegevens ervan niet, en het verwijdert ook de autorisatie voor de Supabase-organisatie niet.

Functies in je Atoms-project die afhankelijk zijn van Supabase werken mogelijk niet meer nadat je het hebt losgekoppeld. Als je app al is gepubliceerd, moet je mogelijk de gepubliceerde versie bijwerken voordat de wijziging van kracht wordt. Test zowel je project als de live app na het loskoppelen.

Het loskoppelen van Supabase van één Atoms-project heeft geen invloed op andere Atoms-projecten die met hetzelfde Supabase-project zijn verbonden.

FAQ

Waarom werkt mijn Supabase-verbinding niet meer?

1. Open het Supabase Dashboard en controleer de status van het betreffende project. Een project met weinig activiteit in het Gratis Plan kan na een periode van zeven dagen worden gepauzeerd.
2. Als het is gepauzeerd, selecteer Resume project en wacht tot Supabase meldt dat het actief is.
3. Ga terug naar Atoms, open het Connectors-paneel van het project en controleer de Supabase-verbinding. Probeer de mislukte actie één keer opnieuw.
4. Als Supabase al actief is, leg dan de exacte Atoms- of Supabase-fout vast en controleer of de verbinding als losgekoppeld of verlopen wordt weergegeven. Verbind alleen opnieuw wanneer de status aangeeft dat dit nodig is.

Roteer geen sleutels en maak geen vervangend project aan totdat je de oorzaak kent en bestaande gegevens hebt beschermd. Als de storing aanhoudt, neem dan contact op met Support met de Chat Link, tijd en tijdzone, verbindingsstatus en een opgeschoonde foutscreenshot.

Externe referentie: Supabase — Project Pausing

Hoe verbind ik opnieuw een Supabase-project dat was gepauzeerd?

1. Meld je aan bij de juiste Supabase-organisatie en open het gepauzeerde project.
2. Selecteer Resume project en wacht tot de status actief is. Volgens de huidige richtlijnen van Supabase kunnen projecten met weinig activiteit in het Gratis Plan na een periode van zeven dagen met weinig activiteit worden gepauzeerd.
3. Ga terug naar Atoms en open het Connectors-paneel van het project. Bevestig dat Supabase is verbonden en probeer daarna de betreffende bewerking opnieuw.
4. Als Atoms de connector nog steeds als losgekoppeld of verlopen weergeeft, verbind deze dan opnieuw en voltooi de gevraagde autorisatie.

Maak geen nieuw Supabase-project aan en roteer geen inloggegevens totdat bestaande gegevens zijn beschermd. Als opnieuw verbinden mislukt, geef Support dan de Chat Link, de status van het Supabase-project, tijd en tijdzone en een opgeschoonde foutscreenshot.

Externe referentie: Supabase — Project Pausing