鸿蒙应用本地数据库导出与查看指南

鸿蒙应用本地数据库导出与查看指南

一、导出方法(推荐3种)

方法1:DevEco Studio可视化导出(开发调试首选)

  1. 在IDE右侧打开 Device File Browser

  2. 导航至数据库路径:/data/storage/el2/database/entry/rdb/

  3. 同时选中以下三个文件:

    • 数据库名.db
    • 数据库名.db-wal
    • 数据库名.db-shm
  4. 右键选择 Save As → 保存到本地文件夹

方法2:使用hdc命令行工具

bash

perl 复制代码
# 连接设备
hdc shell

# 查找数据库路径
find /data -name "数据库名.db"

# 退出shell后导出文件
hdc file recv /沙箱路径/数据库名.db 本地路径
hdc file recv /沙箱路径/数据库名.db-wal 本地路径
hdc file recv /沙箱路径/数据库名.db-shm 本地路径

方法3:代码实现导出(应用内功能)

typescript

javascript 复制代码
import picker from '@ohos.file.picker';

// 备份数据库
async backupDatabase() {
    const dbBackupPath = this.context.databaseDir + '/backup.db';
    await this.rdbStore.backup(dbBackupPath);
    return dbBackupPath;
}

// 导出到用户设备
async exportDatabase() {
    const backupPath = await this.backupDatabase();
    const filePicker = new picker.DocumentViewPicker();
    const targetUri = await filePicker.save({newFileNames: ['backup.db']});
    await fs.copyFile(backupPath, targetUri[0]);
}

二、查看数据库内容

必备条件

  1. 三个文件必须保持在同一目录
  2. 文件名必须保持原始名称
  3. 使用支持WAL模式的工具(推荐SQLiteStudio)

查看步骤(SQLiteStudio)

  1. 下载安装 SQLiteStudio
  2. 打开软件 → Database → Add a database
  3. 选择导出的 .db 文件
  4. 关键设置 :勾选 Use WAL mode (Write-Ahead Logging)
  5. 双击左侧数据库连接 → 展开Tables查看数据表
  6. 右键表名 → Edit table 查看数据

sqlitestudio.pl/images/scre...

三、常见问题解决

问题现象 原因 解决方案
看不到最新数据 WAL文件未正确处理 1. 确认三个文件在同一目录 2. 执行SQL命令:PRAGMA journal_mode=DELETE;
"database disk image is malformed" 文件导出不完整 1. 重新导出三个文件 2. 使用代码备份后导出单个backup.db文件
加密数据库无法打开 缺少密钥 1. 代码中配置加密密钥 2. 在SQLiteStudio中选择SQLCipher标签输入密钥
导出文件权限不足 未声明文件权限 在module.json5中添加: "requestPermissions": [{ "name": "ohos.permission.FILE_ACCESS_PERSISTED" }]

四、高级技巧

命令行查看(需安装SQLite3)

bash

sql 复制代码
sqlite3 数据库名.db

-- 合并WAL文件
PRAGMA wal_checkpoint(FULL);

-- 查看所有表
.tables

-- 查询数据
SELECT * FROM 表名;

导出为JSON(代码实现)

typescript

typescript 复制代码
async exportToJSON(tableName: string) {
    const data = await this.rdbStore.query(`SELECT * FROM ${tableName}`);
    const jsonStr = JSON.stringify(data);
    
    const filePicker = new picker.DocumentViewPicker();
    const uri = await filePicker.save({
        newFileNames: [`${tableName}.json`]
    });
    
    await fs.writeText(uri[0], jsonStr);
}

五、注意事项

  1. 必须同时导出三个文件(.db、.db-wal、.db-shm)
  2. 开发阶段优先使用DevEco Studio导出
相关推荐
用户861941772074111 分钟前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
微信·harmonyos
码间留白1 小时前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
GitCode官方13 小时前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
程序猿追15 小时前
鸿蒙 PC 用 Tauri 做本地查找,怎样让慢请求给新请求让路
华为·状态模式·harmonyos
程序猿追18 小时前
鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗
华为·harmonyos
jianqiang.xue19 小时前
1颗NPU分时复用:鸿蒙把轻AI塞进了MCU
人工智能·单片机·mcu·嵌入式·harmonyos·鸿蒙·端侧ai
程序猿追1 天前
鸿蒙 PC 用 Tauri 迁移配置文件,先保留旧版再写新版
华为·harmonyos
码间留白2 天前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
二流小码农2 天前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
威哥爱编程2 天前
模拟面试智能体开发实战 12:每篇都能跑不等于接起来能跑,端到端联调收官把十一块拼图合成一个能用的智能体
python·agent·harmonyos