Hubungkan proyek Atoms ke Supabase saat Anda ingin app menggunakan basis data Supabase, autentikasi, penyimpanan file, atau fungsi backend.

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

Cara kerja koneksi

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

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

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

Sebelum memulai

Sebelum menghubungkan Supabase, pastikan bahwa:

• Anda adalah pemilik Ruang Kerja Atoms yang berisi proyek 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 organisasi Supabase dan mengakses proyek yang ingin Anda hubungkan.
• Agen telah menyelesaikan tugasnya saat ini dan Mode Balap dinonaktifkan.
• Browser Anda mengizinkan jendela pop-up dari Atoms.
• Proyek Atoms Anda belum terhubung ke Atoms Cloud.

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

Jangan pernah menempelkan kata sandi Supabase, kunci API, token akses, atau kredensial lainnya ke Chat.

Koneksi Supabase

Buka konektor Supabase

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

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 organisasi Supabase yang ingin Anda gunakan, berarti organisasi tersebut sudah diotorisasi. Anda dapat melanjutkan ke Pilih proyek 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 organisasi yang ingin Anda beri akses kepada Atoms.
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 organisasi tersebut 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 yang digunakan oleh proyek Anda.

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

Tinjau organisasi dan izin sebelum mengotorisasi Atoms.

Pilih proyek Supabase

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

Pilih proyek Supabase dari organisasi yang telah diotorisasi.

Konfirmasi proyek

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

Konfirmasikan proyek Supabase yang dipilih sebelum menghubungkan.

Periksa bahwa koneksi berhasil

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

Panel proyek 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 proyek 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 proyek 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 itu lagi. Beri tahu Agen untuk menggunakan proyek 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. Segarkan 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 segera muncul di app bergantung pada bagaimana app dibangun.

Putuskan Supabase

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

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

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

Fitur apa pun di proyek 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 proyek Anda dan app live setelah pemutusan.

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

FAQ

Mengapa koneksi Supabase saya berhenti berfungsi?

1. Buka Supabase Dashboard dan periksa status proyek yang terdampak. Proyek Paket Gratis dengan aktivitas rendah mungkin dijeda setelah periode tujuh hari.
2. Jika dijeda, pilih Resume project dan tunggu hingga Supabase melaporkan bahwa proyek tersebut aktif.
3. Kembali ke Atoms, buka panel Connectors proyek, 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 kunci atau membuat proyek 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, serta tangkapan layar error yang telah disanitasi.

Referensi eksternal: Supabase — Project Pausing

Bagaimana cara menghubungkan kembali proyek Supabase yang dijeda?

1. Masuk ke organisasi Supabase yang benar dan buka proyek yang dijeda.
2. Pilih Resume project dan tunggu hingga statusnya aktif. Panduan Supabase saat ini menyatakan bahwa proyek Paket Gratis dengan aktivitas rendah dapat dijeda setelah periode aktivitas rendah selama tujuh hari.
3. Kembali ke Atoms dan buka panel Connectors proyek. 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 proyek Supabase baru atau merotasi kredensial sampai data yang ada terlindungi. Jika penyambungan ulang gagal, berikan kepada Support Chat Link, status proyek Supabase, waktu dan zona waktu, serta tangkapan layar error yang telah disanitasi.

Referensi eksternal: Supabase — Project Pausing