Koneksi Supabase

Panduan ini memandu Anda melalui seluruh proses: menyiapkan akun dan project Supabase, mengotorisasi organization yang benar, menghubungkan project, memeriksa bahwa koneksi berhasil, dan memutuskannya saat diperlukan.

Cara kerja koneksi

Setiap project Supabase dimiliki oleh sebuah organization, yang mengontrol siapa yang dapat mengakses dan mengelola project di dalamnya. Saat Anda menghubungkan Supabase ke Atoms, Anda terlebih dahulu mengotorisasi Atoms untuk mengakses organization yang ingin Anda gunakan, lalu memilih project dari organization tersebut untuk dihubungkan.

Setiap project Atoms dapat dihubungkan ke satu project Supabase pada satu waktu. Namun, project Supabase yang sama dapat dihubungkan ke lebih dari satu project Atoms.

Supabase dan Atoms Cloud adalah opsi backend alternatif. Anda tidak dapat menghubungkan keduanya ke project Atoms yang sama pada saat yang bersamaan.

Sebelum memulai

Sebelum menghubungkan Supabase, pastikan bahwa:

• Anda adalah pemilik Ruang Kerja Atoms yang berisi project tersebut. Hanya pemilik ruang kerja yang dapat mengotorisasi, menghubungkan, atau memutuskan Supabase.
• Anda memiliki akun Supabase, atau siap membuatnya selama penyiapan.
• Anda memiliki izin untuk mengotorisasi organization Supabase dan mengakses project yang ingin Anda hubungkan.
• Agen telah menyelesaikan tugasnya saat ini dan Mode Balap dimatikan.
• Browser Anda mengizinkan jendela pop-up dari Atoms.
• Project Atoms Anda belum terhubung ke Atoms Cloud.

Jika Anda mencoba koneksi ini untuk pertama kalinya, pertimbangkan untuk menggunakan project uji saat Anda mempelajari prosesnya.

Jangan pernah menempelkan kata sandi Supabase, API key, access token, atau kredensial lainnya ke Chat.

Koneksi Supabase

Buka konektor Supabase

1. Buka project yang ingin Anda hubungkan.
2. Klik nama project, di kanan atas panel chat.
3. Pilih Connectors di menu drop-down yang muncul.
4. Temukan Supabase dalam daftar konektor yang tersedia, lalu klik connect.

Anda juga dapat membuka Settings → Connectors → Supabase dan memilih Connect.

Buka Settings → Connectors dan pilih Connect untuk Supabase.

Otorisasi Atoms di Supabase

Jika Organizations sudah menampilkan organization Supabase yang ingin Anda gunakan, berarti organization tersebut sudah diotorisasi. Anda dapat melanjutkan ke Pilih project Supabase.

1. Atoms membuka jendela otorisasi Supabase. Masuk ke akun Supabase yang ingin Anda hubungkan, atau buat akun baru jika diperlukan.
2. Periksa bahwa Anda masuk ke akun Supabase yang benar, lalu pilih organization yang ingin Atoms akses.
3. Tinjau izin yang diminta oleh Atoms. Untuk melihat setiap izin, pilih Show detailed permissions. Jika Anda setuju, pilih Authorize Atoms.
4. Kembali ke Atoms dan tunggu pesan Connect success.
5. Di Atoms, buka Connectors → Supabase dan konfirmasikan bahwa organization muncul di bawah Organizations.

Atoms meminta akses baca dan tulis ke Basis Data, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST, dan Storage. Atoms juga meminta akses baca ke Organizations dan Domains. Izin ini memungkinkan Atoms untuk menghubungkan dan mengelola layanan Supabase yang didukung dan digunakan oleh project Anda.

Otorisasi ini berlaku untuk organization Supabase yang dipilih dan tidak terbatas pada project Supabase yang nantinya Anda hubungkan ke project Atoms saat ini. Atoms tidak dapat mengakses organization atau project yang tidak dapat diakses oleh akun Supabase yang terhubung itu sendiri, dan izin Supabase mungkin memberlakukan pembatasan tambahan.

Tinjau organization dan izin sebelum mengotorisasi Atoms.

Pilih project Supabase

1. Di bawah Organizations, perluas organization yang Anda otorisasi.
2. Di bawah Projects, temukan project Supabase aktif yang ingin Anda hubungkan.
3. Jika organization yang Anda perlukan tidak tercantum, pilih New Organization dan otorisasi organization tersebut. Ini tidak membuat organization Supabase baru; ini memungkinkan Anda mengotorisasi organization lain yang sudah ada di akun Supabase Anda.
4. Jika Anda belum memiliki project, pilih Create Project dan buat satu di Supabase. Tunggu hingga project aktif dan siap digunakan, lalu kembali ke Atoms dan pilih Update untuk menyegarkan daftar project.
5. Di samping project yang ingin Anda gunakan, pilih Connect.

Pilih project Supabase dari organization yang telah diotorisasi.

Konfirmasikan project

1. Di jendela konfirmasi, periksa organization dan project yang ditampilkan di bawah Supabase Project.
2. Jika diperlukan, gunakan Supabase Dashboard atau View Tables untuk memastikan bahwa Anda telah memilih project yang benar.
3. Pilih Connect.
4. Atoms menambahkan item koneksi Supabase ke Chat project. Biarkan halaman tetap terbuka dan tunggu hingga selesai sebelum meminta Agen membangun basis data, autentikasi, penyimpanan, atau fitur backend.

Konfirmasikan project Supabase yang dipilih sebelum menghubungkan.

Periksa bahwa koneksi berhasil

1. Buka Settings → Connectors → Supabase.
2. Konfirmasikan bahwa organization dan project Supabase yang benar ditampilkan sebagai terhubung.
3. Pilih Dashboard atau Tables dan periksa bahwa itu membuka project yang sama di Supabase.

Panel project yang terhubung juga dapat menyertakan tautan ke Manage Users, SQL Editor, Edge Functions, dan Manage Secrets. Anda hanya perlu menggunakan area yang relevan dengan fitur yang sedang Anda bangun.

Tinjau project Supabase yang terhubung dan tautan pengelolaannya.

Uji bahwa app Anda dapat menyimpan data

Menghubungkan Supabase tidak dengan sendirinya menambahkan fitur basis data ke app Anda. Di Chat, minta Agen untuk membangun fitur yang Anda inginkan dan menggunakan project Supabase yang terhubung untuk menyimpan datanya. Setelah Agen selesai, uji seluruh alurnya.

1. Di Chat, jelaskan fitur yang Anda inginkan, informasi apa yang harus disimpan, dan di mana pengguna harus melihat informasi tersebut lagi. Beri tahu Agen untuk menggunakan project Supabase yang terhubung.
2. Tunggu hingga Agen selesai membangun fitur tersebut.
3. Di Penampil App, gunakan fitur tersebut seperti pengguna biasa dan masukkan data uji yang tidak berbahaya. Jangan gunakan informasi pribadi, rahasia, atau sensitif.
4. Muat ulang Penampil App atau buka kembali fitur tersebut. Konfirmasikan bahwa informasi yang disimpan tetap ada dan muncul di tempat yang benar.
5. Buka Settings → Connectors → Supabase, pilih Tables, dan konfirmasikan bahwa record yang sesuai muncul di tabel yang benar.

Jika fitur tersebut memungkinkan pengguna mengedit atau menghapus informasi yang disimpan, uji juga tindakan tersebut dan konfirmasikan bahwa hasilnya benar baik di app maupun di Supabase. Apakah perubahan yang dibuat langsung di Supabase langsung muncul di app bergantung pada bagaimana app tersebut dibangun.

Putuskan Supabase

Putuskan Supabase saat Anda tidak lagi ingin project Atoms saat ini menggunakan project Supabase yang terhubung.

1. Buka Settings → Connectors → Supabase.
2. Konfirmasikan bahwa Anda sedang melihat koneksi untuk project Atoms yang benar.
3. Pilih Disconnect Project.
4. Tunggu hingga item pemutusan Supabase di Chat selesai.
5. Buka kembali Connectors → Supabase dan konfirmasikan bahwa project tidak lagi ditampilkan sebagai terhubung.

Memutuskan koneksi menghapus koneksi dari project Atoms saat ini. Ini tidak menghapus project Supabase atau datanya, dan juga tidak menghapus otorisasi untuk organization Supabase.

Fitur apa pun di project Atoms Anda yang bergantung pada Supabase mungkin berhenti berfungsi setelah Anda memutuskannya. Jika app Anda sudah dipublikasikan, Anda mungkin perlu memperbarui versi yang dipublikasikan sebelum perubahan berlaku. Uji project Anda dan app live setelah pemutusan.

Memutuskan Supabase dari satu project Atoms tidak memengaruhi project Atoms lain yang terhubung ke project Supabase yang sama.

FAQ

Mengapa koneksi Supabase saya berhenti berfungsi?

1. Buka Supabase Dashboard dan periksa status project yang terdampak. Project Paket Gratis dengan aktivitas rendah dapat dijeda setelah periode tujuh hari.
2. Jika dijeda, pilih Resume project dan tunggu hingga Supabase melaporkan bahwa project tersebut aktif.
3. Kembali ke Atoms, buka panel Connectors project, dan verifikasi koneksi Supabase. Coba ulangi tindakan yang gagal sekali.
4. Jika Supabase sudah aktif, catat error Atoms atau Supabase yang tepat dan periksa apakah koneksi ditampilkan sebagai terputus atau kedaluwarsa. Hubungkan kembali hanya jika status menunjukkan bahwa itu diperlukan.

Jangan rotasi key atau membuat project pengganti sampai Anda mengetahui penyebabnya dan telah melindungi data yang ada. Jika kegagalan berlanjut, hubungi Support dengan Chat Link, waktu dan zona waktu, status koneksi, dan tangkapan layar error yang telah disanitasi.

Referensi eksternal: Supabase — Project Pausing

Bagaimana cara menghubungkan kembali project Supabase yang dijeda?

1. Masuk ke organization Supabase yang benar dan buka project yang dijeda.
2. Pilih Resume project dan tunggu hingga statusnya aktif. Panduan Supabase saat ini menyatakan bahwa project Paket Gratis dengan aktivitas rendah dapat dijeda setelah periode tujuh hari aktivitas rendah.
3. Kembali ke Atoms dan buka panel Connectors project. Konfirmasikan bahwa Supabase terhubung, lalu coba lagi operasi yang terdampak.
4. Jika Atoms masih menampilkan konektor sebagai terputus atau kedaluwarsa, hubungkan kembali dan selesaikan otorisasi yang diminta.

Jangan membuat project Supabase baru atau merotasi kredensial sampai data yang ada terlindungi. Jika penghubungan ulang gagal, berikan kepada Support Chat Link, status project Supabase, waktu dan zona waktu, serta tangkapan layar error yang telah disanitasi.

Referensi eksternal: Supabase — Project Pausing