Basis Data

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

Membuka 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 ruang kerja yang sama dengan Penampil App, 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 sedang digunakan dan total jumlah yang tersedia. Gunakan Development saat membangun dan menguji app Anda. Perubahan yang dibuat di Production dapat memengaruhi data app yang aktif, jadi selalu periksa environment mana yang sedang Anda gunakan sebelum membuat perubahan.

Pilih basis data Development atau Production.

Menelusuri dan memfilter data tabel

1. Pilih kartu basis data Development atau Production, tergantung pada environment yang ingin Anda gunakan.
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 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, constraint, dan nilai default. Pilih Copy untuk menyalin schema yang ditampilkan.

Menambahkan, mengedit, atau menghapus baris

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

Operation	How to do it
Menambahkan baris	Buka... dan pilih Add Row. Masukkan nilai yang sesuai dengan field yang tersedia, lalu kirim baris tersebut.
Mengedit baris	Klik dua kali sebuah sel dan masukkan nilai baru. PilihCommit Changes untuk menyimpan semua edit yang tertunda, atau Discard untuk menghapusnya.
Menghapus baris	Pilih satu atau beberapa baris, pilihDelete, lalu konfirmasi. Penghapusan baris tidak dapat dibatalkan.

Menambahkan baris atau mengonfirmasi penghapusan akan langsung menerapkan perubahan ke basis data yang dipilih. Hanya pengeditan 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 ruang kerja, 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.

Membuat tabel atau mengubah schema

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

Operation	How to do it
Membuat 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 tabel tersebut.
Mengubah 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 sudah 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.

Mengimpor atau mengekspor data CSV

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

Operation	How to do it
Import 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.
Export 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

Action	Who can perform it	Additional requirements
Menambahkan, mengedit, atau menghapus baris	Editor atau workspace owner	Tabel harus dapat ditulis. Mengedit dan menghapus baris juga memerlukan informasi primary key.
Membuat tabel atau mengubah schema	Ruang Kerja owner	Field primary-key dan tabel hanya-baca tidak dapat dimodifikasi.
Mengimpor atau mengekspor file CSV	Ruang Kerja owner	File CSV tidak dapat diimpor ke tabel hanya-baca.

Tabel sistem atau 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.

Memperbaiki masalah basis data umum

“No databases found” atau “No tables found”

Pastikan Atoms Cloud terhubung ke proyek. Jika sudah terhubung, pastikan 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 Anda di ruang kerja 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 ruang kerja, 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 dari 10 MB.
• Kolom dan datanya kompatibel dengan schema tabel tujuan.
• Anda telah melakukan commit atau discard pada semua edit baris yang tertunda.

Jika impor masih gagal, hubungi Support dan sertakan tautan proyek atau Chat, environment, tabel tujuan, peran ruang kerja, 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 mengisi 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 mengisi record yang hilang?

3. Apakah Anda sudah memiliki backup?

4. Berapa jendela 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 atau jumlah record yang menunjukkan perbedaannya.

Bisakah saya memindahkan basis data dari satu proyek Atoms ke proyek Atoms lain tanpa kehilangan data?

Atoms saat ini tidak mendukung migrasi basis data otomatis tanpa kehilangan data antarproyek. Membuat proyek baru atau membagi proyek yang ada tidak akan secara otomatis menyalin akun pengguna atau record basis data yang ada ke proyek baru.

Sebelum melanjutkan:

• Jangan mereset, mengganti, memigrasikan, atau menghapus basis data atau sumber daya proyek yang ada.
• Biarkan proyek asli tetap tidak berubah sebagai sumber data yang ada.
• Hubungi Atoms Support dan berikan proyek sumber, proyek tujuan, penyedia basis data, serta data yang harus dipertahankan.

Dalam beberapa kasus, tim mungkin dapat membantu dengan penyalinan manual satu kali dari basis data sumber ke basis data tujuan. Ini bukan sinkronisasi berkelanjutan: data baru apa pun yang ditulis ke sumber setelah penyalinan dimulai tidak akan otomatis muncul di tujuan.

Untuk meminimalkan perbedaan data, jeda penulisan ke basis data sumber selama jendela migrasi dan verifikasi data yang disalin di proyek tujuan sebelum beralih ke sana. Migrasi yang sepenuhnya tanpa kehilangan data saat ini tidak dapat dijamin.