Pemeriksa Basis Data memungkinkan Anda memeriksa, membuat kueri, dan memodifikasi basis data aplikasi Anda saat aplikasi sedang berjalan. Ini sangat berguna untuk debugging basis data. Inspektur Basis Data berfungsi dengan SQLite biasa dan dengan pustaka yang dibangun di atas SQLite, seperti Room
Catatan. Pemeriksa Basis Data hanya berfungsi dengan pustaka SQLite yang disertakan dalam sistem operasi Android pada API level 26 dan yang lebih tinggi. Itu tidak berfungsi dengan pustaka SQLite lain yang Anda bundel dengan aplikasi AndaBuka Inspektur Database
Untuk membuka database di Inspektur Database, lakukan hal berikut
Jalankan aplikasi Anda di emulator atau perangkat terhubung yang menjalankan API level 26 atau lebih tinggi
Catatan. Masalah umum yang terkait dengan emulator Android 11 menyebabkan aplikasi mogok saat terhubung ke Database Inspector. Untuk memperbaiki masalah tersebut,.Dari bilah menu, pilih Lihat > Jendela Alat > Inspeksi Aplikasi
Pilih tab Inspektur Basis Data
Pilih proses aplikasi yang berjalan dari menu
Database di aplikasi yang sedang berjalan muncul di panel Database. Perluas node untuk database yang ingin Anda periksa
Lihat dan ubah data
Panel Database menampilkan daftar database di aplikasi Anda dan tabel yang berisi setiap database. Klik dua kali nama tabel untuk menampilkan datanya di jendela inspektur di sebelah kanan, seperti yang ditunjukkan pada gambar 1. Klik tajuk kolom untuk mengurutkan data di jendela inspektur menurut kolom tersebut
Untuk mengubah data dalam tabel, ikuti langkah-langkah berikut
- Klik dua kali sebuah sel
- Ketik nilai baru
- tekan enter
Jika aplikasi Anda menggunakan Room dan UI Anda mengamati database, seperti dengan LiveData atau Flow, setiap perubahan yang Anda lakukan pada data akan langsung terlihat di aplikasi yang sedang berjalan. Jika tidak, perubahan hanya akan terlihat saat berikutnya aplikasi Anda membaca data yang dimodifikasi dari database
Lihat perubahan basis data langsung
Jika Anda ingin Inspektur Basis Data memperbarui data yang ditampilkannya secara otomatis saat Anda berinteraksi dengan aplikasi yang sedang berjalan, pilih kotak centang Pembaruan langsung di bagian atas jendela inspektur. Saat pembaruan langsung diaktifkan, tabel di jendela inspektur hanya dapat dibaca dan Anda tidak dapat mengubah nilainya
Alternatifnya, untuk memperbarui data secara manual, klik tombol Segarkan tabel di bagian atas jendela inspektur
Query database Anda
Pemeriksa Basis Data dapat menjalankan kueri terhadap basis data aplikasi Anda saat aplikasi sedang berjalan. Alat tersebut dapat menggunakan kueri DAO jika aplikasi Anda menggunakan Room, tetapi juga mendukung kueri SQL khusus
Jalankan kueri DAO
Jika aplikasi Anda menggunakan Room, Android Studio menyediakan tindakan gutter yang memungkinkan Anda dengan cepat menjalankan metode kueri yang telah Anda tentukan di class DAO. Tindakan ini tersedia saat aplikasi Anda berjalan dan Database Inspector terbuka di IDE
Untuk menjalankan metode kueri apa pun di DAO, klik tombol Jalankan pernyataan SQLite di Inspektur Database
Jika aplikasi Anda menyertakan lebih dari satu database, Android Studio akan meminta Anda memilih database yang akan dikueri dari daftar. Jika metode kueri Anda menyertakan named , Android Studio akan meminta nilai untuk setiap parameter sebelum menjalankan kueri. Hasil kueri ditampilkan di jendela inspektur
Jalankan kueri SQL khusus
Anda juga bisa menggunakan Database Inspector untuk menjalankan kueri SQL kustom terhadap database aplikasi Anda saat aplikasi sedang berjalan
Untuk menanyakan database, ikuti langkah-langkah berikut
Klik Buka tab Kueri Baru
di bagian atas panel Database untuk membuka tab baru di jendela inspektur.Gambar 3. Buka tab Kueri BaruJika aplikasi Anda menyertakan lebih dari satu database, pilih database yang akan dikueri dari daftar di tab Kueri Baru
Di bagian atas tab Kueri Baru, ketikkan kueri SQL kustom Anda ke dalam bidang teks
Klik Jalankan
Alternatifnya, gunakan fitur riwayat kueri untuk menjalankan kueri yang Anda gunakan sebelumnya
Klik tombol Tampilkan riwayat kueri
untuk melihat daftar kueri yang sebelumnya Anda jalankan terhadap database yang dipilih.Gambar 4. Menu riwayat kueriKlik kueri dalam daftar untuk melihat pratinjau kueri lengkap di editor, dan tekan Enter untuk menyalinnya ke editor
Klik Jalankan untuk menjalankan pernyataan
Hasil kueri yang ditampilkan di tab Kueri Baru hanya dapat dibaca dan tidak dapat diubah. Namun, Anda dapat menggunakan bidang kueri SQL kustom untuk menjalankan pernyataan pengubah seperti UPDATE, INSERT, atau DELETE
Jika aplikasi Anda menggunakan Room dan UI Anda mengamati database, seperti dengan LiveData atau Flow, setiap perubahan yang Anda lakukan pada data akan langsung terlihat di aplikasi yang sedang berjalan. Jika tidak, perubahan hanya akan terlihat saat berikutnya aplikasi Anda membaca data yang dimodifikasi dari database
Modus luring
Di Android Studio 4. 2 dan yang lebih tinggi, Anda dapat terus memeriksa database aplikasi setelah proses terputus. Ini mempermudah untuk men-debug aplikasi Anda setelah mogok
Saat pemutusan terjadi, Inspektur Basis Data mengunduh basis data Anda dan membuatnya tersedia untuk Anda dalam mode luring. Saat offline, Anda masih dapat membuka tabel dan menjalankan kueri
Saat Anda terhubung kembali ke proses aplikasi langsung, Inspektur Database meninggalkan mode offline dan hanya menampilkan data yang ada di perangkat. Dengan kata lain, data yang ditampilkan dalam mode offline tidak bertahan saat Anda menyambungkan kembali ke proses aplikasi. Karena keterbatasan ini, Inspektur Database tidak mengizinkan Anda mengedit data atau menjalankan pernyataan SQL modifikasi saat dalam mode offline
Saat Anda melihat database dalam mode offline, nama proses menyertakan [DETACHED] untuk menunjukkan bahwa inspektur tidak lagi terikat pada proses. Selain itu, ikon database
Biarkan koneksi database tetap terbuka
Pemeriksa Basis Data hanya dapat mengubah basis data saat aplikasi Anda mempertahankan koneksi langsung ke basis data tersebut. Artinya, jika aplikasi Anda sering terhubung dan terputus dari database, akan sulit untuk men-debug database tersebut. Panel Database menggunakan ikon untuk mengidentifikasi database
Selain itu, untuk mencegah koneksi database ditutup, alihkan Tetap buka koneksi database dari nonaktif
Ekspor data dari Pemeriksa Basis Data
Anda dapat mengekspor database, tabel, dan hasil kueri dari Database Inspector untuk disimpan, dibagikan, atau dibuat ulang secara lokal. Saat Anda membuka proyek aplikasi di Android Studio dan memeriksa aplikasi untuk proyek tersebut di Database Inspector, Anda bisa mulai mengekspor data dengan salah satu cara berikut
- Pilih database atau tabel di panel Database dan klik Ekspor ke file di dekat bagian atas panel
- Klik kanan database atau tabel di panel Database dan pilih Ekspor ke file dari menu konteks
- Saat memeriksa tabel atau hasil kueri di tab, klik Ekspor ke file di atas tabel atau hasil kueri
Setelah memilih tindakan ekspor, gunakan dialog Ekspor Database untuk membantu Anda melalui langkah terakhir, seperti yang ditunjukkan pada gambar 6
Bergantung pada apakah Anda mencoba mengekspor database, tabel, atau hasil kueri, Anda memiliki opsi untuk mengekspor data dalam satu atau beberapa format berikut. DB, SQL, atau CSV