Basis Data Atoms Cloud menyimpan dan mengelola data terstruktur yang diandalkan app Anda, termasuk produk, pemesanan, pesanan, pengiriman formulir, dan konten buatan pengguna. Di modul Basis Data, Anda dapat melihat environment dan tabel, mencari dan mengedit record, memeriksa struktur tabel, serta mengimpor atau mengekspor data menggunakan file CSV.

Panduan ini membahas basis data bawaan di Atoms Cloud. Jika proyek Anda menggunakan Supabase, lihat Koneksi Supabase sebagai gantinya.

Buka basis data

Sebelum membuka basis data, hubungkan proyek Anda ke Atoms Cloud. Jika belum terhubung, ikuti langkah-langkah koneksi di Atoms Cloud.

1. Buka proyek Anda di perangkat desktop.
2. Di toolbar workspace yang sama tempat Penampil App berada, pilih Atoms Cloud.
3. Pilih Basis Data di sidebar Atoms Cloud.
4. Di bawah Databases, pilih basis data yang ingin Anda periksa. Kartu basis data Development dan Production akan muncul saat tersedia untuk proyek tersebut.

Setiap kartu basis data menunjukkan berapa banyak penyimpanan yang digunakan dan jumlah total yang tersedia. Gunakan Development saat membangun dan menguji app Anda. Perubahan yang dibuat di Production dapat memengaruhi data app live, jadi selalu periksa environment mana yang sedang Anda gunakan sebelum membuat perubahan.

Pilih basis data Development atau Production.

Telusuri dan filter data tabel

1. Pilih kartu basis data Development atau Production, tergantung environment tempat Anda ingin bekerja.
2. Gunakan Search tables untuk menemukan tabel, atau pilih langsung dari daftar. Setiap kartu tabel menampilkan jumlah baris dan apakah tabel tersebut hanya-baca.
3. Gunakan Search rows untuk mencari di dalam tabel saat ini, atau pilih Filter untuk mempersempit hasil menggunakan satu atau beberapa field.
4. Gunakan kontrol panah halaman di bawah tabel untuk melihat baris tambahan.
5. Untuk memeriksa struktur tabel, buka menu ••• dan pilih Schema.

Tampilan Schema menampilkan nama setiap field, tipe data, status key, persyaratan, batasan, dan nilai default. Pilih Copy untuk menyalin schema yang ditampilkan.

Tambahkan, edit, atau hapus baris

Saat Anda telah menemukan basis data yang ingin diubah, Anda dapat menggunakan tindakan berikut untuk melakukannya:

Operasi	Cara melakukannya
Tambahkan baris	Buka ... dan pilih Add Row. Masukkan nilai yang sesuai dengan field yang tersedia, lalu kirim baris tersebut.
Edit baris	Klik dua kali sebuah sel dan masukkan nilai baru. Pilih Commit Changes untuk menyimpan semua edit yang tertunda, atau Discard untuk menghapusnya.
Hapus baris	Pilih satu atau beberapa baris, pilih Delete, lalu konfirmasi. Penghapusan baris tidak dapat dibatalkan.

Menambahkan baris atau mengonfirmasi penghapusan akan langsung menerapkan perubahan ke basis data yang dipilih. Hanya edit sel inline yang mengharuskan Anda memilih Commit Changes atau Discard. Jika Anda memiliki edit yang tertunda, commit atau discard edit tersebut sebelum menambahkan baris, mengimpor atau mengekspor file CSV, mengubah pencarian atau filter, atau berpindah ke halaman lain.

Jika proyek berada dalam workspace, hanya Editors dan workspace owner yang dapat mengedit baris di tabel yang dapat ditulis. Jika Atoms tidak dapat mendeteksi primary key untuk sebuah tabel, Anda tidak dapat mengedit atau menghapus barisnya karena Atoms tidak dapat mengidentifikasi record individual secara andal.

Tinjau edit baris yang tertunda, lalu commit atau discard perubahan tersebut.

Buat tabel atau ubah schema

Buka environment basis data yang ingin Anda perbarui, lalu ikuti petunjuk untuk perubahan yang ingin Anda lakukan:

Operasi	Cara melakukannya
Buat tabel	Di daftar tabel, klik ..., lalu pilih Create table. Masukkan nama tabel yang valid dan field awal, lalu kirim permintaan. Tunggu hingga Agen selesai, buka kembali Basis Data, dan verifikasi tabelnya.
Ubah schema	Klik tabel yang ingin Anda ubah, lalu klik ..., dan pilih Schema. Gunakan Add Field untuk membuat field, atau pilih field yang memenuhi syarat untuk mengeditnya. Anda dapat mengubah nama, tipe, nilai default, status wajib, atau keunikannya. Anda juga dapat menandai field non-key untuk dihapus. Pilih Submit Changes untuk mengirim permintaan ke Agen, atau Discard untuk menghapus perubahan tertunda Anda.

Hanya workspace owner yang dapat membuat tabel atau mengubah schema tabel.

Mengirim permintaan schema tidak berarti migrasi telah selesai. Tunggu hingga Agen selesai, verifikasi hasilnya di Basis Data, lalu uji app Anda setelahnya. Field primary key dan tabel hanya-baca tidak dapat dimodifikasi dengan cara ini.

Masukkan detail field baru di Add Field.

Tinjau perubahan schema yang tertunda sebelum memilih Submit Changes.

Impor atau ekspor data CSV

Pilih tabel yang ingin Anda gunakan, lalu ikuti petunjuk untuk operasi yang relevan:

Operasi	Cara melakukannya
Impor CSV	Klik ... dan pilih Import CSV. Pilih file .csv yang tidak lebih besar dari 10 MB, lalu tinjau nama file, perkiraan jumlah baris, tabel yang dipilih, dan environment sebelum mengonfirmasi. Kolom CSV harus sesuai dengan schema tabel. Baris yang diimpor langsung ditambahkan dan tidak dapat dibatalkan secara otomatis, jadi pertimbangkan untuk mengekspor data yang ada terlebih dahulu.
Ekspor CSV	Klik ... dan pilih Export CSV. Jika pencarian atau filter aktif, hanya baris yang cocok yang akan diekspor. Jika tidak, semua data dari tabel saat ini akan diekspor.

Hanya workspace owner yang dapat mengimpor atau mengekspor file CSV. Untuk tabel hanya-baca, Export CSV adalah satu-satunya opsi yang tersedia.

Izin dan tabel yang dilindungi

Tindakan	Siapa yang dapat melakukannya	Persyaratan tambahan
Tambahkan, edit, atau hapus baris	Editor atau workspace owner	Tabel harus dapat ditulis. Mengedit dan menghapus baris juga memerlukan informasi primary key.
Buat tabel atau ubah schema	Ruang Kerja owner	Field primary key dan tabel hanya-baca tidak dapat dimodifikasi.
Impor atau ekspor file CSV	Ruang Kerja owner	File CSV tidak dapat diimpor ke tabel hanya-baca.

Tabel sistem atau tabel pengguna yang dilindungi mungkin menampilkan badge Read-only. Anda dapat melihat datanya dan memeriksa schemanya jika tersedia, tetapi Anda tidak dapat memodifikasi baris atau strukturnya dari halaman ini.

Perbaiki masalah basis data umum

“No databases found” atau “No tables found”

Pastikan Atoms Cloud terhubung ke proyek. Jika sudah terhubung, konfirmasikan bahwa app Anda menyertakan fitur yang menyimpan data persisten. Jika perlu, minta Agen untuk menambahkan fitur yang didukung basis data. Setelah Agen selesai, buka kembali Basis Data atau pilih Refresh.

Tindakan basis data tidak ada atau tidak tersedia

Periksa apakah tabel memiliki badge Read-only, lalu tinjau izin di atas untuk memastikan bahwa peran workspace Anda mengizinkan tindakan tersebut. Mengedit dan menghapus baris juga memerlukan informasi primary key.

Edit baris yang tertunda dapat mencegah tindakan lain. Pilih Commit Changes atau Discard sebelum menambahkan baris, mengimpor atau mengekspor file CSV, mengubah pencarian atau filter, atau berpindah ke halaman lain.

Jika tindakan masih tidak tersedia setelah pemeriksaan ini, hubungi Support dan sertakan tautan proyek atau Chat, environment, tabel, peran workspace, tindakan yang dicoba, dan teks error yang tepat.

File CSV tidak dapat diimpor

Hanya workspace owner yang dapat mengimpor data, dan tabel tujuan harus dapat ditulis. Pastikan bahwa:

• File menggunakan format .csv.
• Ukuran file tidak lebih besar dari 10 MB.
• Kolom dan datanya kompatibel dengan schema tabel tujuan.
• Anda telah melakukan commit atau discard pada edit baris yang tertunda.

Jika impor masih gagal, hubungi Support dan sertakan tautan proyek atau Chat, environment, tabel tujuan, peran workspace, nama dan ukuran file, tindakan yang dicoba, serta teks error yang tepat.

FAQ

Basis data production saya tidak tersinkron. Apa yang harus saya lakukan?

Jika Development berfungsi normal tetapi situs live (Production) menampilkan tabel, kolom, atau error migrasi yang hilang:

Penting: Jangan membangun ulang atau menimpa basis data production sendiri.

Informasi yang dibutuhkan:

• Tautan Chat dan URL live
• Pesan error SQL lengkap
• Nama tabel/kolom yang hilang
• Perubahan schema basis data terakhir
• Versi live terakhir yang berfungsi
• Apakah data production harus dipertahankan
• Apakah Anda ingin menyinkronkan sepenuhnya data Development atau hanya melengkapi struktur yang hilang

Hubungi support dengan detail ini agar kami dapat membandingkan versi Development/Production, status migrasi, dan perbedaan schema sebelum membuat perubahan.

Mengapa data development saya berbeda dari data production?

Jika Anda telah memublikasikan beberapa kali tetapi Production masih menampilkan data lama sementara pembaruan kode berfungsi dengan baik:

Sebelum menghubungi support, konfirmasikan:

1. Apakah data production saat ini harus dipertahankan?

2. Apakah Anda ingin menimpa sepenuhnya dengan data Development saat ini, atau hanya melengkapi record yang hilang?

3. Apakah Anda sudah memiliki backup?

4. Berapa jangka waktu maintenance yang dapat Anda terima?

Kami tidak akan menimpa atau membangun ulang data production sampai tujuan penanganan data dikonfirmasi. Berikan URL Development/Production dan contoh ID record atau jumlah yang menunjukkan perbedaannya.