Backend dan data
Database aplikasimu
Cara aplikasimu menyimpan data, cara melihat dan mengubahnya di Kelola → Database, membiarkan AI memeriksa dan memperbaikinya dengan aman, menjalankan SQL, dan membatalkan kesalahan.
Saat aplikasimu perlu mengingat sesuatu, misalnya pemesanan, pesanan, pesan, atau barang yang disimpan tiap orang, semuanya disimpan di database. Setiap aplikasi di hosting Buildliy punya database pribadi sendiri, dan sudah disiapkan untukmu. Kamu tidak perlu memasang apa pun dan tidak ada pengaturan yang harus dipilih.
Halaman ini menjelaskan bagaimana data masuk, cara melihat dan mengubahnya, bagaimana AI bisa membantu dengan datamu, dan cara membatalkan kesalahan.
Bagaimana data masuk ke databasemu
Biasanya kamu cukup menjelaskan apa yang perlu disimpan aplikasimu, lalu AI mengerjakan sisanya. AI membuat satu tabel untuk tiap jenis hal (misalnya pemesanan, produk, atau anggota) dan membuat layar untuk menampilkan serta menyimpannya.
Tambahkan halaman pemesanan tempat pelanggan memilih kelas dan jam. Simpan setiap pemesanan supaya nanti bisa kulihat.
Ada beberapa cara lain data bisa masuk:
- Orang yang memakai aplikasimu. Setiap pendaftaran, pesanan, atau formulir yang disimpan aplikasimu menambah satu baris.
- Datamu yang sudah ada. Lampirkan file CSV, JSON, atau Excel (maksimal 5 MB) di chat, atau berikan tautan ke file itu, lalu minta AI memuatnya. AI membuat tabelnya dan mengisinya sekaligus. Satu kali impor bisa memasukkan hingga 5.000 baris. Untuk Excel, yang dipakai adalah lembar pertama yang terlihat.
- Secara manual. Tambahkan baris sendiri di Kelola → Database (lihat di bawah).
Ini daftar produkku dalam bentuk CSV. Masukkan ke database dan tampilkan di halaman toko.
Kadang AI menyadari bahwa aplikasimu butuh akun dan data tersimpan, meski kamu tidak menyebutkannya. Sebelum menambahkannya, AI mungkin bertanya lewat kartu bernama Aplikasimu butuh akun dan data tersimpan. Klik Siapkan untuk menambahkannya, Belum dulu untuk lanjut dengan data contoh yang diberi label jelas, atau Ceritakan lebih lanjut untuk mendapat penjelasan.
Cara kerja databasemu
- Bersifat pribadi. Hanya kode server aplikasimu sendiri yang bisa mengakses database. Browser pengunjung tidak pernah berhubungan langsung dengannya, jadi tidak ada kunci di halamanmu yang bisa dipakai orang untuk membacanya.
- Pratinjaumu punya data uji cobanya sendiri. Di aplikasi baru, apa pun yang kamu simpan saat menguji di pratinjau, termasuk pendaftaran uji coba, masuk ke data uji coba yang tidak pernah dilihat pengunjung sungguhan. Aplikasimu yang sudah terbit punya data live sendiri. Lihat Data uji coba dan data live.
- Di aplikasi yang dibuat lebih awal, pratinjau dan aplikasi live memakai satu database yang sama. Apa pun yang kamu simpan saat menguji di pratinjau ada di database yang sama dengan yang dipakai aplikasimu yang sudah terbit. Setelah aplikasimu live, Kelola → Database mengingatkanmu: "Pratinjau dan aplikasi live kamu memakai data yang sama, jadi perubahan yang kamu buat saat menguji akan terlihat oleh pengunjung sungguhan."
- Berjalan memakai kreditmu. Database memakai kredit untuk waktu saat ia aktif, data yang disimpannya, riwayat pemulihannya, dan data yang dikirimkannya. Saat tidak ada yang memakai aplikasimu, database tertidur. Paketmu menyertakan kredit hosting gratis tiap bulan, dan kredit itu dipakai lebih dulu. Lihat Hosting dan Kredit dan pemakaian.
- Berhenti sementara kalau kreditmu habis. Database aplikasimu berhenti lebih dulu, dan halaman yang sudah kamu terbitkan tetap online selama 2 hari lagi. Tidak ada yang dihapus. Tambahkan kredit dan semuanya berjalan lagi dengan sendirinya.
Data uji coba dan data live
Aplikasi baru di hosting Buildliy menyimpan dua set data:
- Data uji coba dipakai oleh pratinjaumu. Semua yang disimpan olehmu, AI, dan uji coba ala pelanggan dari Buildliy selama kamu membuat aplikasi masuk ke sini. Pengunjung sungguhan tidak pernah melihatnya.
- Data live dipakai oleh aplikasimu yang sudah terbit, untuk pengunjung sungguhan.
Tab Data, Kelola → Database, dan Editor SQL punya tombol pengalih Data uji coba / Data live di bagian atas. Sebelum aplikasimu diterbitkan, yang tampil adalah data uji coba. Setelah itu, yang tampil lebih dulu adalah data live. Kelola → Pengguna menampilkan akun di data uji cobamu sampai aplikasimu diterbitkan, lalu menampilkan akun di situs live kamu.
Saat kamu menerbitkan, tabel dan kolom yang dibuat AI selama proses pembuatan disalin ke situs live kamu dalam keadaan kosong. Dialog Terbitkan menampilkannya di bawah Situs live kamu punya data sendiri. Baris tidak pernah disalin, jadi apa pun yang harus tampil di situs live kamu sejak hari pertama, seperti menu atau daftar produk, harus berasal dari aplikasimu sendiri. Minta AI di chat untuk menambah atau mengubah tabel, supaya perubahannya bisa ikut disalin. Tabel atau kolom yang kamu tambahkan sendiri dengan SQL tidak ikut disalin: dialog Terbitkan akan menyebutkan yang mana, dan penerbitan menunggu sampai kamu membuat perubahan yang sama di data live kamu atau menghapusnya dari data uji cobamu.
Untuk memulai ulang data uji cobamu, pilih Data uji coba lalu klik Reset data uji coba. Ini menghapus semua yang ada di data uji cobamu dan memulai lagi dengan tabel situs live kamu, dalam keadaan kosong. Data situs live kamu tidak tersentuh, dan tindakan ini tidak bisa dibatalkan.
Data uji cobamu punya database kecil sendiri. Database itu memakai kredit hosting aplikasimu hanya saat sedang sibuk, dan berhenti sementara saat tidak ada yang memakainya.
Melihat dan mengubah datamu
Buka bagian Database
Buka tab Kelola lalu pilih Database. Tabelmu tercantum di sebelah kiri, masing-masing dengan jumlah barisnya.
Pilih tabel
Klik sebuah tabel untuk melihat baris dan kolomnya, serta catatan singkat di bawah Siapa yang bisa melihat atau mengubah baris.
Temukan yang kamu cari
Ketik di kotak pencarian di atas baris untuk menyaringnya. Pakai Sebelumnya dan Berikutnya untuk berpindah halaman.
Dari situ kamu bisa:
- Mengubah nilai. Klik nilainya, ketik nilai baru, lalu tekan Enter untuk menyimpan atau Esc untuk membatalkan. Sebuah pesan akan mengonfirmasi bahwa perubahan tersimpan, lengkap dengan tombol Urungkan.
- Menambah baris. Klik Tambah baris lalu isi formulirnya. Kolom yang wajib diisi diberi tanda.
- Menghapus baris. Centang barisnya, klik Hapus, lalu konfirmasi. Baris itu langsung hilang dari aplikasimu. Sebelum menghapus, Buildliy menyimpan cadangan semua data aplikasimu (lihat Cadangan dan pembatalan).
- Mengunduh tabel. Klik Unduh CSV untuk menyimpan semua baris sebagai file spreadsheet, atau cari dulu lalu klik Unduh hasil pencarian untuk menyimpan hanya baris yang cocok. Kata sandi, kunci, dan nilai tersembunyi lainnya tidak disertakan. Satu unduhan memuat hingga 20.000 baris. Untuk tabel yang lebih besar, pesan yang muncul akan memberi tahu berapa baris yang disertakan.
Kata sandi, kunci, dan nilai lain yang tampak rahasia disembunyikan dan tidak bisa diubah di sini. Beberapa tabel hanya bisa dilihat, misalnya tabel yang diurus oleh sistem masuk aplikasimu. Tabel tanpa kolom id bisa dicari dan diunduh, tapi tidak bisa diubah. Kalau sebuah tabel membutuhkan nilai yang hanya bisa diisi oleh aplikasimu, seperti kata sandi, baris baru harus datang dari aplikasimu sendiri. Untuk menambah tabel baru atau mengubah kolom tabel, minta AI di chat.
Untuk melihat ringkasan dalam bahasa sehari-hari tentang apa yang disimpan aplikasimu, buka menu Ruang kerja di kanan atas lalu pilih Data.
Biarkan AI memeriksa dan memperbaiki datamu
Kamu bisa bertanya kepada AI tentang datamu, atau memintanya merapikan atau menata ulang data, langsung di chat.
Berapa banyak pemesanan yang kita punya untuk minggu depan?
Hapus pendaftaran uji coba yang kubuat dengan alamat emailku sendiri.
AI bisa membaca baris (hingga 50 sekaligus, dengan alamat email dan nomor telepon yang sebagian disembunyikan), menambah, mengubah, dan menghapus baris, serta menambah atau mengganti nama kolom. Perubahan kecil yang aman langsung dilakukan. Sebelum menghapus baris, mengubah lebih dari 20 baris dalam satu pembuatan, atau mengganti nama kolom, AI berhenti dan menampilkan kartu seperti "Ini akan menghapus 37 pemesanan", dengan tombol Batal dan tombol untuk melanjutkan. Hanya pemilik proyek yang bisa menyetujuinya, dan AI menyimpan salinan datamu sesaat sebelum perubahan itu selama maksimal 24 jam.
Alat data ini tidak bisa menghapus seluruh tabel. Di aplikasi baru, alat ini bekerja pada data live kamu setelah aplikasimu diterbitkan (sebelum itu, pada data uji cobamu), dan AI memberi tahu kamu mana yang dipakainya. Di aplikasi yang dibuat lebih awal, pratinjau dan aplikasi live memakai satu database yang sama, jadi perubahan yang dibuat AI pada datamu juga memengaruhi aplikasi live kamu.
Jalankan SQL
Kalau kamu paham SQL, buka Kelola → Editor SQL untuk menjalankan kueri pada database aplikasimu.
- Ketik SQL kamu lalu klik Jalankan, atau tekan CmdEnter (Mac) atau CtrlEnter (Windows).
- Perintah yang menghapus data, seperti menghapus tabel, mengosongkannya, atau menghapus atau mengubah baris tanpa syarat, akan berhenti dengan pesan Perintah yang menghapus — konfirmasi dulu sebelum dijalankan. Klik Tetap jalankan hanya kalau kamu yakin. Tanpa cadangan, tindakan ini tidak bisa dibatalkan.
- Kueri contoh memberimu tiga kueri siap pakai yang bisa langsung dijalankan: Tampilkan daftar tabelku, Hitung baris di setiap tabel (jumlah yang tepat), dan Tampilkan kebijakan RLS.
- Beberapa area sistem tidak boleh disentuh, dan editor menolak SQL yang menyentuhnya, seperti
information_schemaatau tabelpg_…milik database itu sendiri. Pakai kueri contoh untuk melihat tabelmu. - Di aplikasi baru, semua yang kamu jalankan sekaligus terjadi sebagai satu langkah "berhasil semua atau batal semua". Karena itu, perintah perawatan yang tidak bisa berjalan dengan cara itu, seperti
VACUUM, tidak berfungsi di sini.
Di aplikasi baru, editor SQL bekerja pada data yang kamu pilih dengan tombol pengalih Data uji coba / Data live. Di aplikasi yang dibuat lebih awal, editor ini bekerja pada data yang sama dengan aplikasi live kamu.
Siapa yang bisa melihat apa
Kalau aplikasimu punya akun, AI membuatnya sedemikian rupa sehingga setiap hal yang disimpan seseorang terhubung dengan orang itu, dan kode server aplikasimu memeriksa siapa yang sedang masuk sebelum membaca atau menyimpannya.
Di aplikasi baru, database juga ikut menegakkan hal ini. Aplikasimu terhubung dengan login terbatas, dan database hanya menampilkan baris milik masing-masing orang, bahkan kalau sebuah halaman lupa memeriksa siapa yang sedang masuk. Kamu tetap melihat semua baris di Kelola → Database dan Editor SQL. Daftar periksa peluncuran menampilkan Data tiap orang dikunci oleh database, atau menghalangi penerbitan dengan Data sebagian orang belum dikunci untuk pemiliknya kalau ada tabel berisi data pribadi orang yang belum dikunci.
Di aplikasi yang dibuat lebih awal, pemeriksaan hanya ada di kode aplikasimu, jadi semuanya bergantung pada setiap halaman dan tautan data untuk melakukannya. Daftar periksa peluncuran menandainya dengan Data tiap orang dipisahkan lewat kode aplikasimu, sebuah saran yang tidak menghalangimu menerbitkan aplikasi.
Di aplikasi baru, kalau kode aplikasimu sendiri menambahkan kode database miliknya sendiri, seperti fungsi, trigger, tampilan (view), atau aturan, Buildliy berhenti menampilkan atau mengubah data itu di Kelola → Database, Kelola → Pengguna, Editor SQL, dan alat data milik AI, karena kode itu bisa berjalan dengan akses penuh ke databasemu. Kamu akan melihat pesan yang diawali "Kode aplikasimu sendiri mengubah databasenya dengan cara yang tidak bisa Buildliy tangani dengan aman". Minta AI menghapus apa yang ditambahkan aplikasimu ke databasenya, atau kelola data itu dari dalam aplikasimu.
Data yang ingin kamu tampilkan ke semua orang, seperti menu atau daftar produk, bisa dibuat publik. Cukup bilang begitu saat kamu memintanya.
Untuk memeriksa cara kerjanya di aplikasimu, buka menu Ruang kerja lalu pilih Peran untuk melihat daftar dalam bahasa sehari-hari tentang setiap jenis pengguna dan apa yang boleh mereka lakukan. Sebelum kamu menerbitkan, pemeriksaan keamanan juga mencari halaman dan tautan data yang menampilkan detail pribadi orang kepada pengunjung yang belum masuk, atau kepada semua akun yang sudah masuk. Kalau pemeriksaan itu yakin menemukannya, kamu harus memperbaikinya sebelum bisa menerbitkan. Lihat Daftar periksa peluncuran. Untuk proses masuk itu sendiri, lihat Proses masuk pengguna.
Cadangan dan pembatalan
Ada beberapa cara untuk mendapatkan kembali data:
- Batalkan penghapusan. Saat kamu menghapus baris di Kelola → Database, cadangan semua data aplikasimu disimpan selama 24 jam (yang disimpan hanya 3 cadangan terbaru). Klik Batalkan penghapusan, pilih cadangan, klik Pulihkan, lalu Pulihkan lagi untuk mengonfirmasi. Setiap tabel kembali seperti keadaannya pada saat itu, jadi apa pun yang ditambahkan atau diubah sejak saat itu, seperti pesanan atau pendaftaran baru, ikut dibatalkan. Datamu yang sekarang disimpan selama 7 hari, jadi kamu bisa kembali ke keadaan itu.
- Kelola → Cadangan. Menampilkan salinan datamu yang dibuat sebelum perubahan besar: sebelum data diputar mundur (disimpan 7 hari, dengan Batalkan putar mundur) dan sebelum perubahan yang dibuat AI setelah kamu menyetujuinya (disimpan hingga 24 jam, dengan Kembalikan data ini). Di sini juga tercantum perubahan yang dibuat AI pada datamu.
- Pulihkan beserta data. Saat kamu memulihkan versi sebelumnya dari Riwayat versi, kamu bisa mencentang opsi data untuk memutar mundur datamu juga, bukan hanya kode dan tampilannya. Opsi ini mati secara default, dan hanya pemilik proyek yang melihatnya, untuk aplikasi yang datanya ada di hosting Buildliy. Riwayat data hanya tersimpan sampai batas waktu tertentu. Untuk versi yang lebih lama, hanya kodenya yang bisa dipulihkan. Lihat Riwayat versi.
Hanya pemilik proyek yang bisa melihat cadangan dan mengembalikan data.
Kode aplikasimu, baik yang diunduh dari tab Kode maupun yang dikirim ke GitHub, tidak menyertakan data di databasemu. Untuk menyimpan salinan datamu sendiri, unduh setiap tabel dengan Unduh CSV.
Memakai database milikmu sendiri
Kalau kamu lebih suka menyimpan datamu di akun Supabase atau Neon milikmu sendiri, kamu bisa menghubungkannya di Kelola → Backend. Cadangan, pemutaran mundur data, dan beberapa alat data AI hanya berfungsi di hosting Buildliy. Dengan proyek Neon milikmu sendiri, Kelola → Database memungkinkanmu melihat, mencari, dan mengunduh datamu, tapi perubahan dilakukan di dasbor Neon sendiri. Dengan proyek Supabase milikmu sendiri, kamu melihat dan mengubah datamu di dasbor Supabase. Lihat Pakai backend milikmu sendiri.
Terkait
Masih bingung? Baca FAQ atau hubungi kami.