Node.js v22.5+ 官方 SQLite 模块全解析:从入门到实战

在 Node.js v22.5.0 及更高版本中,node:sqlite 模块作为内置模块被引入,为开发者提供了与 SQLite 数据库交互的官方支持。以下是关于 node:sqlite 模块的详细介绍:

一、模块启用与导入

  • 启用方式 :node:sqlite 模块目前处于活跃开发阶段,需要通过 --experimental-sqlite CLI 标志来启用。
  • 导入方式 :使用 import 语句从 node:sqlite 模块中导入所需的类和方法。例如:
javascript 复制代码
import { DatabaseSync } from 'node:sqlite';

二、核心类与方法

1. DatabaseSync 类
  • 作用:表示与 SQLite 数据库的单连接,所有 API 均同步执行。
  • 构造函数 :new DatabaseSync(location[, options])
    • location :数据库位置,可以是文件路径(如 './mydb.sqlite')或内存标识(如 ':memory:')。
    • options :配置选项,包括是否自动打开数据库(open)、是否启用外键约束(enableForeignKeyConstraints)等。
2. 常用方法
  • database.exec(sql) :
    • 作用:执行一条或多条 SQL 语句,不返回结果。
    • 示例:
javascript 复制代码
database.exec(`
  CREATE TABLE data(
    key INTEGER PRIMARY KEY,
    value TEXT
  ) STRICT
`);
  • database.prepare(sql) :
    • 作用:创建预处理语句,用于高效执行重复的 SQL 操作。
    • 示例:
javascript 复制代码
const insert = database.prepare('INSERT INTO data (key, value) VALUES (?, ?)');
insert.run(1, 'hello');
insert.run(2, 'world');
  • database.close() :
    • 作用:关闭数据库连接。
    • 示例:
javascript 复制代码
database.close();

三、使用示例

以下是一个完整的示例,展示了如何使用 node:sqlite 模块进行数据库操作:

javascript 复制代码
import { DatabaseSync } from 'node:sqlite';

// 创建或打开内存数据库
const database = new DatabaseSync(':memory:');

// 创建表
database.exec(`
  CREATE TABLE data(
    key INTEGER PRIMARY KEY,
    value TEXT
  ) STRICT
`);

// 插入数据
const insert = database.prepare('INSERT INTO data (key, value) VALUES (?, ?)');
insert.run(1, 'hello');
insert.run(2, 'world');

// 查询数据
const query = database.prepare('SELECT * FROM data ORDER BY key');
console.log(query.all()); // 输出: [ { key: 1, value: 'hello' }, { key: 2, value: 'world' } ]

// 关闭数据库连接
database.close();

四、注意事项

  • 实验性特性 :node:sqlite 模块目前处于实验性阶段,API 可能在未来版本中发生变化。
  • 同步执行 :DatabaseSync 类的所有方法均同步执行,可能会阻塞事件循环。对于高并发场景,建议考虑使用异步数据库驱动(如 sqlite3 模块)。
  • 错误处理 :在使用 node:sqlite 模块时,应妥善处理可能出现的错误,如数据库连接失败、SQL 语句执行错误等。
相关推荐
Decay__5 小时前
PostgreSQL 数据库全栈运维实战系列 — 合集索引(24 篇)
运维·数据库·sql·mysql·架构
琳少_10 小时前
java程序开发笔记
java·开发语言·数据库·笔记
Pocker_Spades_A13 小时前
工业物联网时序数据库选型:一份能直接抄走的技术规格书
数据库·物联网·时序数据库
苜蓿muxu13 小时前
缓存三大问题:穿透、击穿、雪崩
数据库·redis
正在走向自律14 小时前
MySQL兼容性深度实践:建表、增删改查与迁移避坑全记录
数据库·sql·mysql·信创·数据库迁移
ZhengEnCi14 小时前
Express 企业级项目结构怎么组织:五层骨架、单向依赖和一份能跑的边界检查脚本
javascript·node.js·express
JonaHu14 小时前
关键词排名突然消失?用 Python、SQLite 和 SERP API 搭一套可解释的 SEO 监控
python·sqlite·seo·serp api
隔窗听雨眠15 小时前
openGauss开源五年的内核演进与生态工程
数据库·opengauss·国产数据库
Decay__15 小时前
PostgreSQL 体系架构全解 —— 进程模型、共享内存、MVCC 与 WAL 预写日志深入
运维·数据库·sql·mysql·架构
Dumbness17 小时前
搜 platform 却给出 Form 表单:离线文档检索把短关键词当成了子串
javascript·node.js