如何导出并查看数据库文件
============

#### 问题现象

开发者在开发数据库过程中，通常会碰到需要将数据库文件导出查看，以便确认表格创建、数据增删改查的成功。本文介绍了在HarmonyOS侧如何将数据库文件导出并查看。

#### 背景知识

HarmonyOS侧提供了关系型数据库（Relational Database，RDB）供开发者实现数据的持久化。关系型数据库（Relational Database，RDB）是一种基于关系模型来管理数据的数据库。关系型数据库基于SQLite组件提供了一套完整的本地数据库管理机制，对外提供了一系列的增、删、改、查等接口，也可以直接运行用户输入的SQL语句来满足复杂的场景需要。详情请参考[通过关系型数据库实现数据持久化](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/data-persistence-by-rdb-store)。

#### 解决方案

查看已持久化的数据库文件可分为两步，**导出**与**查看**。

**导出**数据库文件需先了解数据库文件的存放路径，通过参考[应用沙箱路径和真实物理路径的对应关系](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-sandbox-directory#应用沙箱路径和真实物理路径的对应关系)中的应用el2级别加密数据库目录，可知数据库文件的存放路径为：/data/app/el2/100/database/{bundleName}/entry/rdb。

导出数据库文件可通过以下两种方式来实现：

*   通过hdc命令导出，参考如下命令：
    
    hdc file recv 数据库所在目录 导出的目的路径 。
    
    例：hdc file recv /data/app/el2/100/database/{bundleName}/entry/rdb D:\\rdb
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a9/v3/g5xV_ztDR6CzFSp_MG-XkA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T134124Z&HW-CC-Expire=86400&HW-CC-Sign=1A2FB5C5BB0927F79EDE5FF3A4F89C7B9ADC6914B66D64D59B9224A052014FA0)
    
    hdc命令可参考[hdc命令列表](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hdc#hdc命令列表)。
    
*   通过DevEco Studio导出。打开DevEco Studio使用自带的Device File Browser找到数据库存放的路径，选中文件->右键->Save As导出。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/75/v3/t9O0IFmISMq6eccqTYfFKQ/zh-cn_image_0000002659138353.png?HW-CC-KV=V1&HW-CC-Date=20260709T134124Z&HW-CC-Expire=86400&HW-CC-Sign=94FAF58F01CA849D036A2ED8C52F7AA8A0D53B9B3458C97DB5155D85193BAFD3 "点击放大")
    
*   使用三方库[@hadss/debug-db](https://ohpm.openharmony.cn/#/cn/detail/@hadss%2Fdebug-db)实现,项目中集成debug-db后，通过浏览器访问可视化页面查看并操作数据，点击Download下载数据库文件（db文件+wal文件+shm文件）。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a0/v3/cTcMDk7PSom0Q5qYWsUTXw/zh-cn_image_0000002629059002.png?HW-CC-KV=V1&HW-CC-Date=20260709T134124Z&HW-CC-Expire=86400&HW-CC-Sign=F6741E97805B3326AED57F8775E29F4B51AAA06C57949E515A5F94226D30B34E "点击放大")
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/20/v3/wQb9drQVRZq9AwlVNlbVmg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T134124Z&HW-CC-Expire=86400&HW-CC-Sign=7B58268B1B603C698925A8588715D4FE247ABB4BCE0DA882EE29390EA37479D5)
    
    **导出数据库文件（db文件+wal文件+shm文件）三个都要导出。**
    

**查看**数据库文件，HarmonyOS侧未给出官方的可视化工具，可通过第三方数据库工具查看如（DB Browser for SQLite、SQLitestudio等）或者集成三方库@hadss/debug-db，通过可视化页面查看。下图以DB Browser for SQLite工具为例，打开了名为database.db的数据库文件，可看到对应的数据库结构及表数据，使用系统默认加密的数据库不支持导出到本地使用数据库工具查看。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cf/v3/2OXFiYZFRlunSXvTF2Wu_g/zh-cn_image_0000002628899084.png?HW-CC-KV=V1&HW-CC-Date=20260709T134124Z&HW-CC-Expire=86400&HW-CC-Sign=3CBAFB103B43B91BC0E2BEB286C70804465DBA7BAD6E3643D036A507AF814DCD "点击放大")![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f3/v3/gXZ-5SvVQxuzPJ-GbiItBA/zh-cn_image_0000002659258295.png?HW-CC-KV=V1&HW-CC-Date=20260709T134124Z&HW-CC-Expire=86400&HW-CC-Sign=130EBAD350A51434D074219F9CA11FD1FFED8A2BAE3B454417DDC6F8719ED782 "点击放大")