Database Inspector: шта је то, како радити са SQLite и отклањати грешке Room

Шта је Database Inspector?

Database Inspector — алат Android Studio за инспекцију и отклањање грешака локалних база података у мобилној апликацији. Омогућава преглед свих SQLite база података креираних од стране апликације, укључујући Room базе, SQLiteOpenHelper и библиотека трећих страна. Алат је доступан од Android Studio 4.1 и покреће се преко Android Profiler-а или директно из View менија.

Намена и могућности

Основни задатак Database Inspector-а је визуелизација података у процесу развоја. Уместо исписивања садржаја базе у лог или писања посебног екрана за преглед података, програмер може отворити Database Inspector и одмах видети све табеле, њихову шему и садржај. Алат подржава како релационе SQLite базе, тако и Room са Auto-миграцијама.

Када користити Database Inspector

Алат је незамењив у сценаријима када је потребно проверити исправност чувања података након извршења операције: регистрација корисника, синхронизација са сервером, кеширање листи. Уместо писања тестног UI-ја, дамп базе се прегледа кроз Database Inspector. Алат се такође активно користи за отклањање грешака миграција Room-а — може се видети актуелна шема табела након сваког ажурирања шеме.

Како ради Database Inspector

Database Inspector повезује се са процесом Android апликације преко Android Profiler Service-а. Открива све отворене SQLite конекције у апликацији и приказује их у бочном панелу. За рад је потребна Debug верзија апликације са API Level 26 (Android 8.0) и вишим.

Архитектура и механизам рада

При покретању Database Inspector креира ADB тунел између апликације на уређају и IDE-а на рачунару. WAL (Write-Ahead Logging) датотеке базе података се преносе кроз овај тунел ради приказивања садржаја. SQL команде се шаљу директно SQLite мотору апликације преко подршке Database Inspector-а у Room-у и SQLiteDatabase-у. Алат аутоматски открива тренутак када апликација отвара базу података и додаје је на листу инспектираних.

Захтеви окружења

За исправан рад Database Inspector-а потребно је: Android Studio 4.1+, уређај или емулатор са API Level 26+, Debug верзија апликације. За Room додатно је потребна библиотека room-runtime верзије 2.2+. Ако је база података креирана у WAL режиму, што је стандардно за Room 2.2+, алат може читати податке без блокирања главне апликације.

// Пример Room базе података коју подржава Database Inspector
@Database(
    entities = [User::class, Order::class],
    version = 2,
    autoMigrations = [AutoMigration(from = 1, to = 2)]
)
abstract class AppDatabase : RoomDatabase() {
    abstract fun userDao(): UserDao
    abstract fun orderDao(): OrderDao
}

Основне могућности Database Inspector-а

Database Inspector пружа пун скуп функција за рад са локалним подацима: од прегледа шеме табела до извршавања сложених SQL упита и уређивања записа.

Преглед табела и шеме

У левом панелу приказују се све базе података и табеле. При избору табеле отвара се њен садржај у облику табеле са колонама: сва поља записа се приказују као колоне, сваки ред је посебан запис. Шема табеле (име, тип, ограничења) приказује се изнад. За спољне кључеве приказују се везе између табела.

Извршавање SQL упита

Картица Query омогућава извршавање произвољних SQL команди директно на изабраној бази података. Подржани су SELECT, INSERT, UPDATE, DELETE, CREATE INDEX, JOIN и било који други SQL оператори SQLite-а. Резултати се приказују у табеларном облику испод уређивача упита. Историја упита се чува током сесије.

Уређивање записа

Ћелије табеле могу се уређивати директно — довољно је кликнути на вредност и унети нову. Промене се одмах примењују на радну апликацију. Ово је посебно корисно за тестирање граничних случајева: постављање null у обавезно поље, замена ID-а непостојећим, провера обраде дугих стрингова. Све промене се бележе у реалном времену.

Отклањање грешака Room-а са Database Inspector-ом

Database Inspector има дубоку интеграцију са Room-ом, што га чини незамењивим при развоју апликација са овом библиотеком. Поред стандардне функционалности, инспектор пружа специфичне могућности за Room.

Преглед DAO упита

За Room базе, Database Inspector приказује генерисане SQL упите за сваку DAO методу. Ово омогућава проверу да Room генерише исправан SQL, посебно за сложене упите са JOIN, @Relation и @Transaction. Ако Room извршава неефикасан упит (нпр. N+1 упита уместо једног JOIN-а), то је одмах видљиво у дневнику упита Database Inspector-а.

Отклањање грешака миграција

При ажурирању шеме Room-а са AutoMigration или ручним миграцијама, Database Inspector приказује актуелну структуру табела након миграције. Довољно је отворити инспектора након покретања апликације и проверити да су све колоне, индекси и спољни кључеви исправно креирани. Ако је миграција пала са грешком, база података се неће отворити — алат ће приказати последњу доступну верзију.

Провера Relations и Embedded

Room омогућава комбиновање података из више табела преко @Relation и @Embedded. Database Inspector помаже у визуелној провери исправности веза, приказујући податке повезаних табела једно поред другог. За сваки спољни кључ може се прећи на повезану табелу једним кликом.

// Entity са Relation за проверу кроз Database Inspector
@Entity(tableName = "users")
data class User(
    @PrimaryKey val id: Int,
    val name: String
)

data class UserWithOrders(
    @Embedded val user: User,
    @Relation(parentColumn = "id", entityColumn = "user_id")
    val orders: List<Order>
)

Практични сценарији коришћења Database Inspector-а

Database Inspector решава конкретне програмске задатке који се јављају при раду са локалним складиштењем података. Размотримо најчешће сценарије коришћења алата у свакодневном раду.

Провера кеширања података

Често апликација кешира одговоре API-ја у локалну базу података. Database Inspector омогућава проверу исправности кеширања: након извршења синхронизације могу се видети актуелни записи у табели кеша. Ако се подаци нису појавили — проблем је у коду за чување. Ако су се појавили дупликати — проблем је у логици упсерт-а.

Отклањање грешака уметања података

Када DAO метода не чува податке, али не баца изузетак, Database Inspector приказује актуелно стање табеле. Типични узроци: конфликт Primary Key (подешавање OnConflictStrategy), нетачан тип података у колони, кршење NOT NULL ограничења или Foreign Key violation. Инспектор омогућава увид у changeset базе пре и после операције. Поређење снимака података пре и после позива DAO-а — један од најефикаснијих начина за отклањање грешака трансакција и проверу исправности пословне логике апликације при сложеним операцијама уписа.

Рефакторисање шеме базе података

При промени шеме табела — додавању колона, преименовању поља, раздвајању табела — Database Inspector помаже у провери резултата миграције. Довољно је покренути апликацију са новом верзијом базе и уверити се да су сви подаци исправно пренети у нову структуру. Ако су након миграције подаци нестали, могу се обновити из дампа сачуваног пре рефакторисања. Овај сценариј је посебно актуелан при преласку са SQLiteOpenHelper на Room или при промени структуре постојећих табела у новој верзији апликације.

Праћење перформанси упита

Database Inspector се такође може користити за процену перформанси SQL упита. Извршавањем SELECT-а кроз картицу Query и мерењем времена одговора, могу се идентификовати упити којима недостају индекси. Room аутоматски евидентира споре упите у Logcat-у са ознаком SLOW SQL, а Database Inspector омогућава тренутно извршавање EXPLAIN QUERY PLAN ради анализе плана извршења.