SQLite调试工具指导

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

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

环境要求

• 开发者在使用本工具前需开启开发者模式，且需要获取HDC工具，执行HDC shell。
• 正常连接设备。

操作准备

在使用SQLite之前需先切换至具备读写权限的目录。

# 打开 HDC 命令行
c:/users/zzz>hdc shell
# cd data
# mkdir temp
# cd temp
# sqlite3
SQLite version 3.40.1 2022-12-28 14:03:47
Enter ".help" for usage hints.
Connected to a transient in-memory database.
Use ".open FILENAME" to reopen on a persistent database.

当在不具备读写权限的路径下尝试执行数据库和表的创建操作时，系统将抛出权限错误。

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

# 打开 HDC 命令行
c:/users/zzz>hdc shell
# 尝试打开或创建新的数据库
#sqlite3 a.db
SQLiteversion 3.40.1
2022-12-28 14:03:47
Enter ".help" for usage hints.
# 创建表
sqlite>create table t1(a int);
Error:unable to open
# 打开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
# 打开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_mater;
Parse error: file is not a database (26)
sqlite> .table
Error: file is not a database
sqlite> .q
# pwd
/data/temp
# ls
wallet_personal_info_data_relational_store
wallet_personal_info_data_relational_store-compare
wallet_personal_info_data_relational_store-shm
wallet_personal_info_data_relational_store-wal

命令列表

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

注意事项

• SQLite命令不需要分号：与SQL语句不同，SQLite命令直接回车执行，无需添加分号。
• 需确保sqlite>提示符与命令之间不存在空格，否则将导致命令无法正常执行。

命令的具体使用及示例

帮助命令（.help）

sqlite>.help

创建或打开已有的数据库

• 打开已有数据库

若数据库文件已存在，可通过.open打开：

  sqlite3          # 进入SQLite交互式Shell
  .open mydb.db    # 在Shell内打开已有数据库

或直接在命令行指定文件路径：

  sqlite3 mydb.db  # 直接打开数据库（跳过进入Shell步骤）

• 创建并打开新数据库

若指定的数据库文件不存在，SQLite将自动创建该文件：

  sqlite3          # 进入SQLite Shell
  .open newdb.db   # 在Shell内创建并打开新数据库

或直接通过命令行创建：

  sqlite3 newdb.db  # 直接创建并打开新数据库

创建表

可通过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
);

查询表

通过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
);

删除表

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

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

sqlite>DROP TABLE COMPANY;

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

sqlite>.tables

插入数据

• 在 sqlite> 提示符下，输入以下SQL语句插入单条数据：

  INSERT INTOCOMPANY(name, age,) VALUES ('张三', 25);

通过SQL语句SELECT * FROM 表的名称可获取表的完整信息，具体如下：

  sqlite> SELECT * FROM COMPANY;
  1|张三|28|北京市朝阳区|20000.5

• 输入以下SQL语句INSERT INTOCOMPANY(字段)values()语句插入多条数据：

  sqlite> INSERT INTOCOMPANY(ID, NAME, AGE, ADDRESS, SALARY)
     ...> VALUES
     ...> (3, '王五', 25, '广州市天河区', 18000.75),
     ...> (4, '赵六', 40, '深圳市南山区', 30000.25);

通过SQL语句SELECT * FROM 表的名称可获取表的完整信息，具体如下：

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

查询数据

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

• 可通过SQL语句SELECT * FROM 表的名称查询所有数据

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

• 可通过SQL语句SELECT 指定字段, 指定字段 FROM 表的名称查询指定字段的数据

  sqlite> SELECT name, age FROM COMPANY;
  张三|28
  王五|25
  赵六|40

• 可通过SQL语句SELECT * FROM 表的名称 WHERE 指定字段 > 30;指定条件查询

  sqlite> SELECT * FROM COMPANY WHERE age > 30;
  4|赵六|40|深圳市南山区|30000.25

• 可通过SQL语句SELECT * FROM 表的名称 ORDER BY 指定字段 ASC;指定字段排序查询

  sqlite>SELECT * FROM COMPANY ORDER BY age ASC;
  3|王五|25|广州市天河区|18000.75
  1|张三|28|北京市朝阳区|20000.5
  4|赵六|40|深圳市南山区|30000.25

更新数据

在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

删除数据

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

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

相关参考

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

常见问题

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

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

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

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkData（方舟数据管理）

harmony 鸿蒙基于设备分类和数据分级的访问控制（ArkTS）

harmony 鸿蒙应用数据向量化

harmony 鸿蒙应用数据持久化概述

harmony 鸿蒙基于标准化数据结构的控件

harmony 鸿蒙数据库备份与恢复（ArkTS）

harmony 鸿蒙数据库加密（ArkTS）

harmony 鸿蒙ArkData简介

harmony 鸿蒙通过键值型数据库实现数据持久化（ArkTS）

harmony 鸿蒙通过用户首选项实现数据持久化 (ArkTS)