数据库调试
=====

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

开发者也可以通过命令行工具调试数据库，具体操作方式请参考[vector-store数据库调试工具指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/vector-store-debug-tool)、[SQLite调试工具指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/sqlite-database-debug-tool)。

#### 使用场景

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

#### 使用约束

*   设备系统需要不低于API 22。低于API 22时，SQLite数据库仅支持查看，不支持修改，向量数据库无法使用。
*   不支持使用release签名的应用。
*   仅支持调试database目录下的数据库。
*   不支持调试加密数据库，建议使用非加密库。
*   不支持调试隐私用户、多用户数据库，建议使用默认用户。
*   不支持导入导出数据库。
*   执行SQL时，存在以下约束：
    *   不支持执行多条SQL。
    *   存在多条SQL时，不支持高亮选择后执行单条SQL。
    *   SQL执行不支持历史记录。
    *   SQL执行不支持事务。
*   从26.0.0 Beta1版本开始，SQL编辑窗口支持SQL语法高亮和关键词、表字段的自动联想补全。

#### 操作步骤

1.  点击菜单栏**View > Tool Windows > Database Inspector**，打开Database Inspector。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3/v3/XNaaIdjkS5ykqvJBk7pwDQ/zh-cn_image_0000002594634580.png?HW-CC-KV=V1&HW-CC-Date=20260612T073900Z&HW-CC-Expire=86400&HW-CC-Sign=EE894700E8B211D1DD87136B35EC49413614F5118760DB088D0B19C0AACD5367)
    
    Database Inspector打开后，页面各区域作用如下：①选择设备，②选择应用包名，③数据库和表信息展示，④SQL执行和数据查看。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d/v3/9-bHxIB3Qa-aRxgTbnz0og/zh-cn_image_0000002624994013.png?HW-CC-KV=V1&HW-CC-Date=20260612T073900Z&HW-CC-Expire=86400&HW-CC-Sign=1E2264F86FB2CBDCD8D1CC3E753729BFDAD6039CEC9C854799573A5AAE3F2DBF)
    
2.  从设备下拉列表中选择设备（设备需已连接）。
3.  选择包名，点击右侧的**Connect to Databases**按钮，即可查看数据库相关信息。（如果使用DevEco Studio 6.0.2 Beta1版本，按钮名称是**Execute**）。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3/v3/NfaLROfXSOC8E_KZahskIA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073900Z&HW-CC-Expire=86400&HW-CC-Sign=8EF9938ACA394670F6CB947B6448E91F3F4743B07E6E80717C430E1C15949904)
    
    设备系统版本低于API 22时，Database Inspector会将数据库下载到本地计算机，界面上显示的是本地计算机路径，设备系统为API 22及以上版本时，界面上显示的是设备上的数据库路径。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b6/v3/Ckq7T-7QS-C52q_W-PYPyQ/zh-cn_image_0000002624994011.png?HW-CC-KV=V1&HW-CC-Date=20260612T073900Z&HW-CC-Expire=86400&HW-CC-Sign=BA67DB4C1799C5FCECDA53D6CF0AD28565EA4E5747B95D5A929FDECF822A711D)
    
4.  双击数据库表名，右侧区域展示表数据，默认按照20条/页展示。
    
    从26.0.0 Beta1版本开始，支持可视化修改表中的数据（仅支持常规基础数据类型：字符串、数值、布尔等，不支持二进制数据类型）。双击单元格，输入数据后，按Enter键或点击其他区域提交。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2/v3/rnGQCiujRD6lYK7bDk9CLw/zh-cn_image_0000002594474654.png?HW-CC-KV=V1&HW-CC-Date=20260612T073900Z&HW-CC-Expire=86400&HW-CC-Sign=AAE655F3E1563B0B79337807B0BD6F9A21175CBE2DFD130264D1CC25C2D315EC)
    
5.  左侧区域点击**New Query**后，右侧会出现**SQL Editor**页签，根据需要选择数据库，并输入SQL后，点击**Execute**按钮即可查看或修改数据。
    
    修改数据后，点击SQL输入框下方的**Refresh Table**刷新页面上的数据。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d9/v3/-Jlukp_qQ4-m86knrD0Cdw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073900Z&HW-CC-Expire=86400&HW-CC-Sign=E3B999A93DD388332C3F0FAAD6F6E05F2C2354EB4C7DA71CF68881D064C743BC)
    
    *   通过SQL修改数据或应用更新数据后，数据展示页面不支持自动刷新，需要重新执行查询语句或者点击刷新按钮。
    *   数据展示页面不支持可视化修改。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6d/v3/ipYFhxcDQWOYulhkedHOIA/zh-cn_image_0000002625074155.png?HW-CC-KV=V1&HW-CC-Date=20260612T073900Z&HW-CC-Expire=86400&HW-CC-Sign=E61AD432D7DCCC8E609832A5B3CEB4B9A921BE4D2022671B55634A5B946F94D7)