当前位置： 首页 > news >正文

鸿蒙NEXT中SQLite数据库全面实战指南

news 2025/9/9 11:33:21

一文掌握HarmonyOS NEXT中SQLite的核心操作与性能优化技巧

华为自主研发的分布式全场景操作系统HarmonyOS NEXT，为开发者提供了丰富的数据管理框架，其中ArkData框架支持SQLite数据库的高效创建与管理。本文将带你全面了解在鸿蒙NEXT应用中如何使用SQLite进行数据存储和管理。

一、SQLite在鸿蒙生态中的重要性

SQLite作为一款轻量级的嵌入式关系型数据库，在移动应用开发中扮演着至关重要的角色。HarmonyOS的关系型数据库基于SQLite实现，提供了关系型数据库和基于对象的关系型数据库两种操作方式。

对于需要处理大量结构化数据的应用，如用户信息管理、内容管理系统和财务应用等，SQLite提供了一个高效、可靠的本地数据存储解决方案。

二、环境准备与配置

在开始之前，请确保你已经安装了DevEco Studio，并且配置好了鸿蒙开发环境。

添加依赖配置

在项目的module.json5文件中添加ArkData依赖和必要的权限：

json

{"module": {"reqPermissions": [{"name": "ohos.permission.DISTRIBUTED_DATASYNC","reason": "For data synchronization"}],"dependencies": {"arkdata": {"version": "1.0.0","visibility": "public"}}}
}

三、创建和配置数据库

在HarmonyOS NEXT中创建SQLite数据库需要几个关键步骤：

1. 引入必要的包

typescript

import { Database, DatabaseConfig } from '@ohos.data.arkdata';
import relationalStore from '@ohos.data.relationalStore';

2. 创建数据库配置

typescript

const config: DatabaseConfig = {name: 'myDatabase.db', // 数据库文件名securityLevel: relationalStore.SecurityLevel.S1, // 安全级别encrypt: false, // 是否加密，可选，默认不加密isReadOnly: false // 是否以只读方式打开，可选，默认false
};

3. 创建数据库和表

typescript

async function createDatabaseAndTable() {try {// 打开或创建数据库const database: Database = await Database.open(config);// 创建表的SQL语句const createTableSql = `CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT,name TEXT NOT NULL,age INTEGER);`;// 执行SQL语句await database.executeSql(createTableSql);console.log('Database and table created successfully.');// 关闭数据库await database.close();} catch (error) {console.error('Error creating database and table:', error);}
}

四、基本CRUD操作

1. 插入数据

typescript

async function insertData() {try {const database: Database = await Database.open(config);// 插入数据的SQL语句（使用参数化查询）const insertSql = 'INSERT INTO users (name, age) VALUES (?, ?)';const values = ['John Doe', 30];// 执行插入操作await database.executeSql(insertSql, values);console.log('Data inserted successfully.');await database.close();} catch (error) {console.error('Error inserting data:', error);}
}

2. 查询数据

typescript

async function queryData() {try {const database: Database = await Database.open(config);// 查询数据的SQL语句const querySql = 'SELECT * FROM users';// 执行查询操作const resultSet = await database.querySql(querySql);// 遍历结果集while (await resultSet.goToNextRow()) {const id = await resultSet.getLong(0);const name = await resultSet.getString(1);const age = await resultSet.getLong(2);console.log(`ID: ${id}, Name: ${name}, Age: ${age}`);}// 关闭结果集和数据库await resultSet.close();await database.close();} catch (error) {console.error('Error querying data:', error);}
}

3. 更新数据

typescript

async function updateData() {try {const database: Database = await Database.open(config);// 更新数据的SQL语句const updateSql = 'UPDATE users SET age = ? WHERE name = ?';const values = [31, 'John Doe'];// 执行更新操作await database.executeSql(updateSql, values);console.log('Data updated successfully.');await database.close();} catch (error) {console.error('Error updating data:', error);}
}

4. 删除数据

typescript

async function deleteData() {try {const database: Database = await Database.open(config);// 删除数据的SQL语句const deleteSql = 'DELETE FROM users WHERE name = ?';const values = ['John Doe'];// 执行删除操作await database.executeSql(deleteSql, values);console.log('Data deleted successfully.');await database.close();} catch (error) {console.error('Error deleting data:', error);}
}

五、使用关系型数据库API

除了直接执行SQL语句，HarmonyOS还提供了关系型数据库API，使数据库操作更加简便和安全。

1. 使用RdbStore操作数据

typescript

// 获取RdbStore对象
let storeConfig = {name: 'Poetry.db',securityLevel: relationalStore.SecurityLevel.S1,encrypt: false,isReadOnly: false,
}relationalStore.getRdbStore(context, storeConfig).then(store => {// 创建表store.executeSql('CREATE TABLE...');}).catch((err: Error) => {console.error('Failed to get RdbStore:', err);});// 插入数据
let data = {name: "zhangsan",age: 23,
}
store.insert("tableName", data).then((rowId) => {console.log('Inserted row ID:', rowId);
})// 使用谓词查询数据
let predicates = new relationalStore.RdbPredicates("tableName")
predicates.equalTo("name", "zhangsan")
store.query(predicates).then((resultSet) => {while (resultSet.goToNextRow()) {const name = resultSet.getString(resultSet.getColumnIndex("name"))const age = resultSet.getLong(resultSet.getColumnIndex("age"))}resultSet.close()
})

六、事务处理

SQLite数据库支持事务处理，以确保数据的一致性和完整性。

typescript

async function performTransaction() {const database: Database = await Database.open(config);try {// 开始事务await database.startTransaction();// 执行多个SQL操作await database.executeSql('UPDATE accounts SET balance = balance - ? WHERE id = ?', [100, 1]);await database.executeSql('UPDATE accounts SET balance = balance + ? WHERE id = ?', [100, 2]);// 提交事务await database.commitTransaction();console.log('Transaction committed successfully.');} catch (error) {// 回滚事务await database.rollbackTransaction();console.error('Transaction failed, rolled back:', error);} finally {await database.close();}
}

七、数据库升级与迁移

随着应用版本的迭代，数据库结构可能需要进行变更。

typescript

// 数据库版本管理
const DATABASE_VERSION = 2;async function upgradeDatabase() {try {const database: Database = await Database.open(config);const version = await database.getVersion();if (version < DATABASE_VERSION) {// 执行升级操作await database.executeSql('ALTER TABLE users ADD COLUMN email TEXT');await database.setVersion(DATABASE_VERSION);console.log('Database upgraded to version:', DATABASE_VERSION);}await database.close();} catch (error) {console.error('Error upgrading database:', error);}
}

八、性能优化技巧

为了提高数据库的性能，开发者可以采取以下优化措施：

1. 合理设计表结构和索引

typescript

// 创建索引
const createIndexSql = 'CREATE INDEX IF NOT EXISTS idx_users_name ON users(name)';
await database.executeSql(createIndexSql);

2. 使用批量操作

typescript

async function bulkInsertData() {try {const database: Database = await Database.open(config);// 开始事务await database.startTransaction();// 批量插入数据const insertSql = 'INSERT INTO users (name, age) VALUES (?, ?)';for (let i = 0; i < 1000; i++) {await database.executeSql(insertSql, [`User ${i}`, 20 + i % 30]);}// 提交事务await database.commitTransaction();console.log('Bulk insert completed successfully.');await database.close();} catch (error) {// 回滚事务await database.rollbackTransaction();console.error('Error in bulk insert:', error);}
}

3. 使用参数化查询

参数化查询不仅能提高安全性（防止SQL注入攻击），还能提升性能，因为数据库可以缓存编译后的查询计划。

4. 合理使用连接池

尽量减少频繁打开和关闭数据库连接，因为这会带来额外的开销。可以在应用启动时打开数据库连接，在应用关闭时关闭连接。

九、数据安全

1. 防止SQL注入

始终使用参数化查询，避免直接拼接用户输入的数据。

typescript

// 不安全的做法（不要这样写！）
const unsafeQuery = `SELECT * FROM users WHERE name = '${userInput}'`;// 安全的做法（使用参数化查询）
const safeQuery = 'SELECT * FROM users WHERE name = ?';
await database.executeSql(safeQuery, [userInput]);

2. 数据加密

对于敏感数据，可以考虑在存储到数据库之前进行加密处理。

typescript

import crypto from '@ohos.security.crypto';async function encryptData(data: string): Promise<string> {// 使用鸿蒙的加密API对数据进行加密// 具体实现取决于加密算法和需求return encryptedData;
}

十、备份与恢复

HarmonyOS提供了简便的数据库备份和恢复功能。

typescript

// 备份数据
store.backup("backup.db").then(() => {console.log('Backup completed successfully.');
}).catch((err) => {console.error('Backup failed:', err);
});// 恢复数据
store.restore("backup.db").then(() => {console.log('Restore completed successfully.');
}).catch((err) => {console.error('Restore failed:', err);
});

十一、总结

本文详细介绍了在HarmonyOS NEXT中如何使用SQLite数据库进行数据存储和访问。通过清晰的步骤和示例代码，帮助开发者快速上手并掌握关键技能。在实际开发中，开发者需要根据具体需求进行更多的配置和优化，并确保正确处理数据库异常和资源释放，以避免潜在的问题。

随着大数据和智能应用需求的增长，关系型数据存储将继续演变。未来，HarmonyOS可能会增强其数据库支持，包括更高的性能优化、更强的数据安全性，以及与分布式架构的更紧密集成。

希望本文能够对你在鸿蒙应用开发中使用SQLite数据库有所帮助！如果你有任何问题或经验分享，欢迎在评论区留言讨论。


文章转载自：

http://3zP8CeEE.pwwjs.cn
http://DM9md1uU.pwwjs.cn
http://ULPF884x.pwwjs.cn
http://Im8kUKaB.pwwjs.cn
http://AH2cbQiF.pwwjs.cn
http://2kRZAWfK.pwwjs.cn
http://3yaevmD1.pwwjs.cn
http://LSMxWnWo.pwwjs.cn
http://v7p12OvQ.pwwjs.cn
http://1P21lmnP.pwwjs.cn
http://7yWONd27.pwwjs.cn
http://tyWAlD1J.pwwjs.cn
http://yuKQAtpX.pwwjs.cn
http://NnTGck83.pwwjs.cn
http://lhIhDSN9.pwwjs.cn
http://bL3sYOQN.pwwjs.cn
http://TfDyiaK4.pwwjs.cn
http://ZQW322aW.pwwjs.cn
http://qCXOJ9FB.pwwjs.cn
http://HjYifasb.pwwjs.cn
http://Jrw545ka.pwwjs.cn
http://oOoZBmuP.pwwjs.cn
http://CS5kAVlL.pwwjs.cn
http://lC8btg8g.pwwjs.cn
http://AQ1RbedT.pwwjs.cn
http://Db1Zd31g.pwwjs.cn
http://9nKQ7kQG.pwwjs.cn
http://yG4UQjQG.pwwjs.cn
http://EjEmabid.pwwjs.cn
http://HSpnsEkZ.pwwjs.cn
http://www.dtcms.com/a/374010.html

相关文章：

  • Go语言文件处理实战指南
  • 【鸿蒙（openHarmony）ETS语言实现视频播放器的详细步骤】
  • SpringBoot教程（三十一） | SpringBoot集成SpringSecurity权限框架
  • 第四十九篇-Tesla P40+Fastllm+Hunyuan-A13B-Instruct+CPU+GPU混合部署推理
  • 安装docker遇到的问题1: [Errno 14] curl#35 - “TCP connection reset by peer“
  • 【Debug日志 | 模型loss不降】
  • 千呼万唤始出来 谭维维音乐会官宣北京
  • 如何给智能家居注入“温度”？世强详解无线通信与AI算力背后的创新方案​
  • 金智维的智能财务管理工具有哪些？
  • 嵌入式 - ARM（1）：ARM体系结构
  • 关于对鱼眼相机图片进行畸变校正的两种思路
  • mybatis-plus原生的批量插入
  • 设计模式 概述
  • SQL 注入与防御-第九章：平台层防御
  • SCADA与DCS深度集成实践：打破工厂“信息孤岛”，让实时控制更智能
  • 小学挫折教育主题班会PPT课件模板下载
  • 深入理解 MyBatis-Plus 的 `BaseMapper`
  • YOLOv8 TensorRT C++部署实战详解：从XMake构建到推理流水线
  • HTML HTML基础(3)
  • 几何动点问题
  • C++从字符串中移除前导零
  • PPP PRIVATE NETWORK™ 2 企业级虚拟以太网接入综合解决方案介绍
  • 《会“偷听”的石头：声流石的震撼发现》
  • 线程的控制（互斥+同步)
  • SpringBoot中添加健康检查服务
  • Android 开发 - 一些画板第三方库（DrawBoard、FingerPaintView、PaletteLib）
  • Skopeo 工具介绍与 CentOS 7 安装指南
  • 面向对象设计原则(未完)
  • Python数据挖掘实战：从理论到工具
  • Highcharts 数据源安全最佳实践：保障数据安全，助力可视化可信部署