调试时想看看数据库里到底存了什么、手动改条数据构造场景，以前得先导出数据库到本地。从 DevEco Studio 6.0.2 Beta1 开始，新增了 Database Inspector，直接在 IDE 里就能执行 SQL 查看和修改数据。

一、Database Inspector

从 DevEco Studio 6.0.2 Beta1 版本开始，新增 Database Inspector，支持在 DevEco Studio 上执行 SQL 语句查看、修改应用数据库，无需将应用数据库先导出到本地，提升开发调试效率。

支持类型：当前支持 SQLite 和向量数据库。

场景	说明
实时查看修改结果	应用某个操作会修改数据库内容，可以实时查看修改后的内容是否符合预期
构造测试场景	可以实时修改数据库内数据，构造测试场景，提升测试效率

二、使用限制

限制项	说明
设备系统版本	设备系统需要不低于 API 22。 • 低于 API 22 时，SQLite 数据库仅支持查看，不支持修改，向量数据库无法使用
签名类型	不支持使用 release 签名的应用
数据库范围	仅支持调试 database 目录下的数据库
加密数据库	不支持调试加密数据库，建议使用非加密库
多用户/隐私用户	不支持调试隐私用户、多用户数据库，建议使用默认用户
导入导出	不支持导入导出数据库

SQL 执行的额外约束

约束项	说明
历史记录	SQL 执行不支持历史记录
事务	SQL 执行不支持事务
语法高亮与联想（26.0.0 起）	支持 SQLite 数据库语法高亮和关键词、表字段的自动联想补全
多条 SQL（26.0.0 起）	SQL 编辑窗口支持执行多条 SQL（以分号分隔），或者选中单条或多条 SQL 后点击右键执行

三、操作步骤

步骤1：打开 Database Inspector

点击菜单栏：

View > Tool Windows > Database Inspector

各区域作用：

区域	作用
①	选择设备
②	选择应用包名
③	数据库和表信息展示
④	SQL 执行和数据查看

步骤2：选择设备

从设备下拉列表中选择设备（设备需已连接）。

步骤3：连接数据库

1. 选择包名

2. 点击右侧的 Connect to Databases 按钮

3. 即可查看数据库相关信息

说明：

• 设备系统版本低于 API 22 时，Database Inspector 会将数据库下载到本地计算机，界面上显示的是本地计算机路径

• 设备系统为 API 22 及以上时，界面上显示的是设备上的数据库路径

步骤4：查看和修改表数据

1. 双击数据库表名，右侧区域展示表数据，默认按照 20 条/页展示

2. 从 26.0.0 版本开始，支持可视化修改表中的数据

   • 仅支持常规基础数据类型：字符串、数值、布尔等

   • 不支持二进制数据类型

   • 操作方式：双击单元格，输入数据后，按 Enter 键或点击其他区域提交

步骤5：通过 SQL 执行查看或修改

1. 左侧区域点击 New Query

2. 右侧会出现 SQL Editor 页签

3. 选择数据库，输入 SQL

4. 点击 Execute 按钮即可查看或修改数据

5. 修改数据后，点击 SQL 输入框下方的 Refresh Table 刷新页面上的数据

说明：

• 通过 SQL 修改数据或应用更新数据后，数据展示页面不支持自动刷新，需要重新执行查询语句或者点击刷新按钮

• 数据展示页面不支持可视化修改

几个关键点：

1. 版本门槛：

   • IDE 版本：6.0.2 Beta1 起才有 Database Inspector

   • 设备 API：不低于 API 22，低于 22 只能看不能改，向量数据库还用不了

2. release 签名不支持：和位置模拟、CPU 高负载检测一样，只支持 debug 签名，发布版用不了。

3. 数据库范围有限制：仅支持 database 目录下的数据库，加密库、多用户/隐私用户都不支持，用默认用户 + 非加密库最稳。

4. 不能导入导出：只能在线看和改，不能把数据库导出到本地。

5. 低于 API 22 的降级行为：数据库下载到本地，显示本地路径，只能看不能改。调试老设备时注意这个差异。

6. SQL 不支持事务和历史：执行 SQL 是单次、无事务的，改错了没有回滚，也没有历史记录可查。改数据前建议先查一遍确认，重要数据手动备份。

7. 调试前提设备已开发者选项开启 + debug 签名。