使用 Database Inspector 调试数据库

在 Android Studio 4.1 及更高版本中,您可以利用 Database Inspector 在应用运行时检查、查询和修改应用的数据库。这对于数据库调试尤为有用。Database Inspector 可处理普通的 SQLite 数据库以及在 SQLite 的基础上构建的库(例如 Room)。

注意:Database Inspector 仅可与 API 级别 26 及更高版本的 Android 操作系统中所包含的 SQLite 库结合使用。它无法处理与您的应用捆绑的其他 SQLite 库。

打开 Database Inspector

如需在 Database Inspector 中打开数据库,请执行以下操作:

  1. 在模拟器或搭载 API 级别 26 或更高版本的已连接设备上运行您的应用

    注意:与 Android 11 模拟器有关的已知问题会导致应用在连接到 DB Inspector 时发生崩溃。如需解决此问题,请按以下步骤操作

  2. 从菜单栏中依次选择 View > Tool Windows > Database Inspector

  3. 从下拉菜单中选择正在运行的应用进程。

  4. 当前正在运行的应用中的数据库显示在 Databases 窗格中。展开要检查的数据库的节点。

查看和修改数据

Databases 窗格显示应用中的数据库列表以及每个数据库包含的表格。双击表格名称即可在检查器窗口的右侧显示其数据。您可以点击列标题,按该列对检查器窗口中的数据进行排序。


db-inspector-window.png

您可以通过以下方式修改表中的数据:双击单元格,输入新值,然后按 Enter 键。如果您的应用使用 Room 并且界面会观察数据库(例如使用 LiveData 或 Flow),那么您对数据所做的任何更改会立即显示在正在运行的应用中。否则,只有当应用下次从数据库中读取修改后的数据时,您才会看到更改。

查看实时数据库更改

如果您希望 Database Inspector 在您与正在运行的应用交互时自动更新它呈现的数据,请勾选检查器窗口顶部的 Live updates 复选框。启用实时更新后,检查器窗口中的表格将变为只读状态,您无法修改其中的值。

或者,您也可以通过点击检查工具窗口顶部的 Refresh table 按钮以手动更新数据。

查询数据库

Database Inspector 可以在应用运行时对应用的数据库运行查询。Database Inspector 可以在您的应用使用 Room 的情况下使用 DAO 查询,但也支持自定义 SQL 查询。

运行 DAO 查询

如果您的应用使用 Room,那么 Android Studio 会提供边线操作,让您可以快速运行您已在 DAO 类中定义的查询方法。如果您的应用正在运行且 Database Inspector 已在 Android Studio 中打开,就可以执行这些操作。您可以在 DAO 中运行任何查询方法,方法是点击 @Query 注解旁边的 Run SQLite statement in Database Inspector 按钮。

db-inspector-dao-gutters.png

如果应用包含多个数据库,Android Studio 会提示您从下拉列表中选择要查询的数据库。如果您的查询方法包含已命名的绑定参数,Android Studio 会在运行查询之前请求获取每个参数的值。查询结果会显示在检查器窗口中。

运行自定义 SQL 查询

您也可以在应用运行时使用数据库 Database Inspector 运行自定义 SQL 查询来查询您应用的数据库。如需查询数据库,请按以下步骤操作:

  1. 点击 Databases 窗格顶部的 Open New Query 标签页 ,在检查器窗口中打开新标签页。

    db-inspector-new-query.png

  2. 如果应用包含多个数据库,请从 New Query 标签页顶部的下拉列表中选择要查询的数据库。

  3. 在 New Query 标签页顶部的文本字段中输入您的自定义 SQL 查询,然后点击 Run。

New Query 标签页中显示的查询结果是只读的,无法修改。但是,您可以使用自定义 SQL 查询字段运行 UPDATE、INSERT 或 DELETE 等修饰符语句。如果您的应用使用 Room 并且界面会观察数据库(例如使用 LiveData 或 Flow),那么您对数据所做的任何更改会立即显示在正在运行的应用中。否则,只有当应用下次从数据库中读取修改后的数据时,您才会看到更改。

其他资源

如需详细了解 Database Inspector,请参阅下面列出的其他资源:

博文

视频

文章来源

使用 Database Inspector 调试数据库

扩展阅读

我又开发了一个非常好用的开源库,调试Android数据库有救了

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,560评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,104评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,297评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,869评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,275评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,563评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,833评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,543评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,245评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,512评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,011评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,359评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,006评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,062评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,825评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,590评论 2 273
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,501评论 2 268

推荐阅读更多精彩内容