目录

SQLite调试工具指导

SQLite是一款轻量级、嵌入式、无服务器的关系型数据库管理系统，其核心优势在于将整个数据库存储于单一文件中，无需独立服务器进程，支持跨平台运行，被广泛应用于移动应用、嵌入式设备和桌面软件等场景。

本调试工具基于hdc命令实现对SQLite数据库的操作，提供一种通过命令行接口高效管理SQLite数据库的方式，适用于开发、调试和运维阶段对数据库的快速操作与验证。

  • 从HarmonyOS 6.0.0开始，支持使用SQLite调试工具。

  • 开发者也可以通过DevEco Studio调试数据库，具体操作方式请参考访问应用数据库。

环境要求

操作准备

在使用SQLite之前需先切换至目标调试应用路径下，再使用命令进入到SQLite调试工具。

# 打开 hdc 命令行
c:/users/zzz>hdc shell
$ cd /data/app/el1/100/base/com.test.myapplication   // 进入到目标调试应用路径下（当前路径为示例，开发者需自己获取调试应用路径）。
$ ls -lZ                                             // 查看路径下的数据库文件，有debug_hap_data_file标签，则确认为调试应用的文件。
total 9531
drwxrwsr-x 2 20020197 ddms o:object_r:debug_hap_data_file:s0:x229,x334,x512,x868,x1024     3440 2025-08-08 16:54 lock
-rw-rw---- 1 20020197 ddms o:object_r:debug_hap_data_file:s0:x229,x334,x512,x868,x1024  9228288 2025-08-08 16:55 rdbPerfTest.db
-rw-rw---- 1 20020197 ddms o:object_r:debug_hap_data_file:s0:x229,x334,x512,x868,x1024      343 2025-08-08 16:54 rdbPerfTest.db-compare
-rw-rw---- 1 20020197 ddms o:object_r:debug_hap_data_file:s0:x229,x334,x512,x868,x1024    12288 2025-08-08 16:55 rdbPerfTest.db-dwr
-rw-rw---- 1 20020197 ddms o:object_r:debug_hap_data_file:s0:x229,x334,x512,x868,x1024    32768 2025-08-08 16:55 rdbPerfTest.db-shm
-rw-rw---- 1 20020197 ddms o:object_r:debug_hap_data_file:s0:x229,x334,x512,x868,x1024   444992 2025-08-08 16:55 rdbPerfTest.db-wal
$ sqlite3 rdbPerfTest.db                             // 打开数据库文件。
SQLite version 3.44.4 2025-02-19 00:18:53
Enter ".help" for usage hints.
sqlite>

在非调试应用路径下，尝试执行数据库和表的创建操作时，系统将抛出权限错误。

使用SQL语句中的CREATE TABLE命令创建表，具体如下：

# 打开 hdc 命令行
c:/users/zzz>hdc shell
# 尝试打开或创建新的数据库
$ sqlite3 a.db
SQLite version 3.44.4 2025-02-19 00:18:53
Enter ".help" for usage hints.
# 创建表
sqlite>create table t1(a int);
Error: unable to open database "a.db": unable to open database file
# 打开asd.db数据库
sqlite>.open asd.db
Error: unable to open database "asd.db": unable to open database file
Notice: using substitute in-memory database instead of "asd.db"

执行上述命令时，SQLite尝试打开或创建表与asd.db数据库，但由于没有权限，会出现以下的错误信息：

# 创建表
sqlite>create table t1(a int);
Error: unable to open database "a.db": unable to open database file
# 打开asd.db数据库
sqlite>.open asd.db
Error: unable to open database "asd.db": unable to open database file
Notice: using substitute in-memory database instead of "asd.db"

SQLite访问加密数据库后，查询会出现以下报错：

# sqlite3 ./wallet_personal_info_data_relational_store
SQLite version 3.44.4 2025-02-19 00:18:53
Enter ".help" for usage hints.
sqlite> select * from sqlite_master;
Parse error: file is not a database (26)
sqlite>.table
Error: file is not a database
sqlite>.q

命令列表

当前SQLite调试工具支持的命令如下表所示：

命令 功能描述
.help 显示所有可用的SQLite命令及简要说明。
.open 数据库名称 打开或创建一个数据库文件。
.databases 列出当前连接的所有数据库。
.tables 列出当前数据库中的所有表。
.show 查看SQLite命令提示符的默认设置。
.schema 获取表的完整信息。
.quit 或 .exit 退出SQLite命令行界面。
.schema [TABLE] 显示表的创建SQL语句（或所有表的结构）。

注意事项

命令的具体使用及示例

[h2]帮助命令（.help）

sqlite>.help

[h2]创建或打开已有的数据库

[h2]创建表

可通过SQL语句create table创建COMPANY表，将ID设置为主键，NOT NULL约束表示在表中创建记录时这些字段不可为空：

sqlite>create table COMPANY(
   ID INT PRIMARY KEY     NOT NULL,
   NAME           TEXT    NOT NULL,
   AGE            INT     NOT NULL,
   ADDRESS        CHAR(50),
   SALARY         REAL
);

[h2]查询表

通过SQLite命令.tables命令验证表是否创建成功，该命令用于列出附加数据库中的所有表。

sqlite>.tables
COMPANY

在此处可查看到刚创建的表COMPANY。

通过SQLite命令.schema命令可获取表的完整信息，具体如下：

sqlite>.schema COMPANY
CREATE TABLE COMPANY(
   ID INT PRIMARY KEY     NOT NULL,
   NAME           TEXT    NOT NULL,
   AGE            INT     NOT NULL,
   ADDRESS        CHAR(50),
   SALARY         REAL
);

[h2]删除表

SQL语句DROP TABLE语句用于删除表定义及其关联的所有数据、索引、触发器、约束和权限规范。

示例：若数据库中已存在 COMPANY 表，可通过以下操作将其删除：

sqlite>DROP TABLE COMPANY;

执行后，使用 .tables 命令将无法查询到 COMPANY 表，显示结果为空即表示删除成功。

sqlite>.tables

[h2]插入数据

[h2]查询数据

在sqlite>提示符下，可通过 SELECT查询数据，支持以下几种数据查询：

[h2]更新数据

在sqlite>提示符下，可通过SQL语句UPDATE 表名称 SET age = 31 WHERE name = '张三';更新数据

sqlite>UPDATE COMPANY SET age = 31 WHERE name = '张三';
sqlite>SELECT * FROM COMPANY;
1|张三|31|北京市朝阳区|20000.5
3|王五|25|广州市天河区|18000.75
4|赵六|40|深圳市南山区|30000.25

[h2]删除数据

在sqlite>提示符下，可通过SQL语句DELETE FROM 表名称 WHERE name = '王五';删除数据

sqlite> DELETE FROM COMPANY WHERE name = '王五';
sqlite> SELECT * FROM COMPANY;
1|张三|31|北京市朝阳区|20000.5
4|赵六|40|深圳市南山区|30000.25

相关参考

SQLite官方网站提供了丰富的示例代码，包括创建数据库、创建表、插入数据和查询数据等操作，开发者可以进行参考和查看。

常见问题

[h2]查询结果为空时的问题处理

在实际的数据库操作中，有时会遇到查询结果为空的情况，这是因为表中没有数据。

为了避免这种情况，需确保已在表中插入相关数据，再进行查询操作。

[h2]如何删除字符

使用Ctrl+BackSpace删除单个字符，使用Ctrl+U删除全部字符。