前端项目接入sqlite轻量级数据库sql.js指南
前端项目接入sqlite轻量级数据库sql.js指南
引言
sql.js 是一个强大的JavaScript库,它使得SQLite数据库能够在网页浏览器中运行。这个开源项目提供了一种方式,让开发者可以在前端环境中实现轻量级的数据库操作,无需依赖服务器端数据存储,极大地增强了Web应用的数据处理能力。通过将SQLite编译成WebAssembly(wasm),sql.js实现了高效的数据库操作,支持标准的SQL查询语言。
如果你需要在浏览器中处理大量数据,并且希望使用 SQL 语法来操作这些数据,那么 SQL.js 将是一个不错的选择。
如果您不想在主应用程序线程中运行 CPU 密集型 SQL 查询, 您可以使用更有限的 WebWorker API。
详细api请移步官方文档sql.js sqlite 官网:https://sql.js.org/#/?id=inside-the-browser
sqlite 不会持久化缓存数据,只会存在运行内存中,需要自行导入导出文件。
我们的目标
本指南将sqlite数据集成到网页项目中,并学习相应api操作,
实现案例效果
本教程使用版本*“sql.js”: “^1.11.0”*
项目中加载sql.js
实现的最终效果,浏览器无任何错误,且,会在控制打印
{a:1,b:'world'}
您始终可以在 https://github.com/sql-js/sql.js/releases/latest 上找到最新发布的工件。
对于每个版本,您都会在发布资产中找到一个名为的文件。它将包含:
sqljs.zip
sql-wasm.js
:Sql.js 的 Web Assembly 版本。缩小并适合生产。使用这个。如果您使用此项,您还需要包含/发货。sql-wasm.wasm
sql-wasm-debug.js
:Web 程序集,Sql.js. Larger 的调试版本,打开了断言。对本地开发有用。如果您使用这个,您将需要包含/发货。sql-wasm-debug.wasm
sql-asm.js
:较旧的 asm.js Sql.js 版本。速度较慢且较大。出于兼容性原因提供。sql-asm-memory-growth.js
:默认情况下,Asm.js不允许内存增长,因为它速度较慢且会取消优化。如果您使用的是 sql-asm.js 并看到此错误 (),请使用此文件。Cannot enlarge memory arrays
sql-asm-debug.js
:Sql.js的 Debug asm.js 版本。用于本地开发。worker.*
- 上述库的 Web Worker 版本。更有限的 API。参见 examples/GUI/gui.js 这是一个很好的例子。
有两个版本,一个是在网页中直接加载的版本,一个是electron等桌面端应用使用的版本
1.在网页中加载的版本(本教程的版本),有两种加载方式
-
可以使用npm包安装(推荐),使用构建工具webpack或vite等
库下载地址:sql.js - npm (npmjs.com)
npm i sql.js
sql.js需要依赖sql-wasm.wasm文件,我们需要添加到自己的目录下面引用
node_modules- sql.js- sql-wasm.wasm将这个文件放在自己的dist目录下面
新建dist目录/
dist- sql-wasm.wasm
运行下面的代码,没有报错,且控制台打印对应数据
import initSqlJs from 'sql.js'; const SQL = await initSqlJs({ // 这里会加载dist/sql-wasm.wasm locateFile: file => `./dist/${file}` }); // Create a database const db = new SQL.Database(); let sqlstr = "CREATE TABLE hello (a int, b char); \ INSERT INTO hello VALUES (0, 'hello'); \ INSERT INTO hello VALUES (1, 'world');"; db.run(sqlstr); // Run the query without returning anything // Prepare an sql statement const stmt = db.prepare("SELECT * FROM hello WHERE a=:aval AND b=:bval"); // Bind values to the parameters and fetch the results of the query const result = stmt.getAsObject({':aval' : 1, ':bval' : 'world'}); console.log(result); // Will print {a:1, b:'world'}
-
也可以直接在网页中加入(没有使用任何构建工具),需要在 web 静态服务器下访问本文件(推荐 vscode 插件 liveserver)
库下载地址:sql.js - Libraries - cdnjs - The #1 free and open source CDN built to make life easier for developers
-
一种是直接在网页头部引入(不推荐)
如果cdn出现问题,会导致不可用
<!DOCTYPE html> <html lang="en"><head><meta charset="UTF-8" /><link rel="icon" type="image/svg+xml" href="/vite.svg" /><meta name="viewport" content="width=device-width, initial-scale=1.0" /><title>Vite App</title><script src="https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.11.0/sql-wasm.js" integrity="sha512-tz0jOZaOg9RtWWB6AdxSkINQwIs7S5obj1Dlml9KewZLPTblTWCux5eLtnexBb8kbLUo5crPmjsi8/vI17Vw0w==" crossorigin="anonymous" referrerpolicy="no-referrer"></script></head><body><div id="app"></div><script>config = {// 从云端加载https://sql.js.org/distsql-wasm.wasmlocateFile: file => `https://sql.js.org/dist/${file}`};initSqlJs(config).then(function (SQL) {//Create the databaseconst db = new SQL.Database();// Run a query without reading the resultsdb.run('CREATE TABLE test (col1, col2);');// Insert two rows: (1,111) and (2,222)db.run('INSERT INTO test VALUES (?,?), (?,?)', [1, 111, 2, 222]); // Prepare a statementconst stmt = db.prepare('SELECT * FROM test WHERE col1 BETWEEN $start AND $end');stmt.getAsObject({ $start: 1, $end: 1 }); // {col1:1, col2:111} // Bind new valuesstmt.bind({ $start: 1, $end: 2 });while (stmt.step()) {//const row = stmt.getAsObject();console.log('Here is a row: ' + JSON.stringify(row));}});</script></body> </html>
-
一种是将文件下载在自己的文件目录中,然后引入(推荐)
库下载地址:sql.js - Libraries - cdnjs - The #1 free and open source CDN built to make life easier for developers
从下载地址下载两个文件,存在dist目录
dist- sql-wasm.wasm- sql-wasm.js
<!DOCTYPE html> <html lang="en"><head><meta charset="UTF-8" /><link rel="icon" type="image/svg+xml" href="/vite.svg" /><meta name="viewport" content="width=device-width, initial-scale=1.0" /><title>Vite App</title><script src="./dist/sql-wasm.js"></script></head><body><div id="app"></div><script>config = {// 这里请求自己目录下面的.dist/sql-wasm.wasmlocateFile: file => `./dist/${file}`};initSqlJs(config).then(function (SQL) {//Create the databaseconst db = new SQL.Database();// Run a query without reading the resultsdb.run('CREATE TABLE test (col1, col2);');// Insert two rows: (1,111) and (2,222)db.run('INSERT INTO test VALUES (?,?), (?,?)', [1, 111, 2, 222]); // Prepare a statementconst stmt = db.prepare('SELECT * FROM test WHERE col1 BETWEEN $start AND $end');stmt.getAsObject({ $start: 1, $end: 1 }); // {col1:1, col2:111} // Bind new valuesstmt.bind({ $start: 1, $end: 2 });while (stmt.step()) {//const row = stmt.getAsObject();console.log('Here is a row: ' + JSON.stringify(row));}});</script></body> </html>
-
2.在node版本(electron等本机桌面应用程序使用)
库下载地址:sqlite3 - npm (npmjs.com)
npm install sqlite3
案例
持久化缓存
<!doctype html>
<html>
<head><meta charset="utf8"><title>Persistent sqlite</title><script src="../dist/sql-wasm.js"></script>
</head>
<body><p>You have seen this page <span id="views">0</span> times.</p><div>You have been here on the following dates: <ol id="dates"></ol></div><script>var baseUrl = '../dist/';
function toBinArray(str) {var l = str.length,arr = new Uint8Array(l);for (var i = 0; i < l; i++) arr[i] = str.charCodeAt(i);return arr;}
function toBinString(arr) {var uarr = new Uint8Array(arr);var strings = [], chunksize = 0xffff;// There is a maximum stack size. We cannot call String.fromCharCode with as many arguments as we wantfor (var i = 0; i * chunksize < uarr.length; i++) {strings.push(String.fromCharCode.apply(null, uarr.subarray(i * chunksize, (i + 1) * chunksize)));}return strings.join('');}
// Normally Sql.js tries to load sql-wasm.wasm relative to the page, not relative to the javascript// doing the loading. So, we help it find the .wasm file with this function.var config = {locateFile: filename => `${baseUrl}/${filename}`}initSqlJs(config).then(function (SQL) {var dbstr = window.localStorage.getItem("viewcount.sqlite");if (dbstr) {var db = new SQL.Database(toBinArray(dbstr));} else {var db = new SQL.Database();db.run("CREATE TABLE views (date INTEGER PRIMARY KEY)");}db.run("INSERT INTO views(date) VALUES (?)", [Date.now()]);
document.getElementById('views').textContent = db.exec("SELECT COUNT(*) FROM views")[0].values[0][0];
var count = 0,dates = document.getElementById("dates");
db.each("SELECT date FROM views ORDER BY date ASC",function callback(row) {var li = document.createElement("li");li.textContent = new Date(row.date);dates.appendChild(li);}, function done() {var dbstr = toBinString(db.export());window.localStorage.setItem("viewcount.sqlite", dbstr);});});
</script>
</body>
</html>
交互案例
<!doctype html>
<html>
<!--Simple Read eval print loop for SQL-->
<head><meta charset="utf8"><title>SQL REPL</title><script src="../dist/sql-wasm.js"></script>
</head>
<body><input type='text' id='input' placeholder="ENTER SOME SQL" size='50'value="CREATE TABLE test(val);INSERT INTO test VALUES (666); SELECT * FROM test"><button id='submit'>Execute</button><pre id='result'></pre><pre id='error'></pre><script>
//Open a blank databasevar db;initSqlJs({ locateFile: filename => `../dist/${filename}` }).then(function (SQL) {db = new SQL.Database();});
document.getElementById('submit').onclick = function () {var sql = document.getElementById('input').value;var result = '', error = '';try { result = db.exec(sql); }catch (e) { error = e; }document.getElementById('result').innerHTML = JSON.stringify(result, null, ' ');document.getElementById('error').innerHTML = error;};</script>
</body>
代码解析
initSqlJs 函数
API 中的根对象是 initSqlJs 函数,它接受一个 SqlJsConfig 参数,并返回一个 SqlJs 对象
SqlJs 对象
initSqlJs返回主 sql.js 对象 SqlJs 模块,其中包含:
-
Database
-
构造函数
-
const db = new SQL.Database();
-
let data = const db = new SQL.Database(data);
-
-
close()
- 关闭数据库
-
注册自定义aggregate
-
db.create_aggregate("js_sum", {init: () => 0,step: (state, value) => state + value,finalize: state => state});db.exec("SELECT js_sum(column1) FROM (VALUES (1), (2))"); // = 3
-
-
创建函数
-
db.create_function("addOne", function (x) {return x+1;})db.exec("SELECT addOne(1)") // = 2
-
-
执行 sql 语句,并为每行 result 调用回调。
-
db.each("SELECT name,age FROM users WHERE age >= $majority", {$majority:18},function (row){console.log(row.name + " is a grown-up.")});
-
-
执行sql
-
var db = new SQL.Database(); var res = db.exec("DROP TABLE IF EXISTS test;\n"+ "CREATE TABLE test (id INTEGER, age INTEGER, name TEXT);"+ "INSERT INTO test VALUES ($id1, :age1, @name1);"+ "INSERT INTO test VALUES ($id2, :age2, @name2);"+ "SELECT id FROM test;"+ "SELECT age,name FROM test WHERE id=$id1",{"$id1": 1, ":age1": 1, "@name1": "Ling","$id2": 2, ":age2": 18, "@name2": "Paul"} );
-
-
将数据库的内容导出到二进制数组。此操作将关闭并重新打开数据库,这将导致程序设置回其默认值。
-
let res = db.export() console.log(res)
-
-
准备sql
-
const stmt = db.prepare('SELECT * FROM test WHERE col1 BETWEEN $start AND $end');stmt.getAsObject({ $start: 1, $end: 1 }); // {col1:1, col2:111} // Bind new valuesstmt.bind({ $start: 1, $end: 2 });while (stmt.step()) {//const row = stmt.getAsObject();console.log('Here is a row: ' + JSON.stringify(row));}
-
-
执行sql
-
db.run("INSERT INTO test VALUES (:age, :name)",{ ':age' : 18, ':name' : 'John' });
-
-
-
Statement
Statement 类用于准备好的语句。
var stmt = db.prepare("UPDATE test SET a=@newval WHERE id BETWEEN $mini AND $maxi");stmt.bind({$mini:10, $maxi:20, '@newval':5});
常用操作
详细api请移步官方文档sql.js
创建数据库/导入数据
// 创建一个新的数据库实例
const db = new SQL.Database();
// 创建并加载数据(见案例章节)
var db = new SQL.Database(toBinArray(dbstr));
查询
// 执行一个 INSERT 语句
db.run("INSERT INTO tasks (name, priority) VALUES ('Buy groceries', 'high')");
// 执行一个 SELECT 语句
const result = db.exec("SELECT * FROM tasks WHERE priority='high'");
// 输出结果
console.log(result);
导出
// 导出数据库
const databaseBlob = db.export();
可能遇到的问题
1. 配置 Vite 以包括 .db
文件
在 vite.config.js
中,您可以添加以下配置:
javascriptCopy Code
import { defineConfig } from 'vite';export default defineConfig({assetsInclude: ['**/*.db'],
});
2. 确保文件路径正确
确保您在项目中引用 .db
文件的路径是正确的。例如:
const dbFilePath = './path/to/your.db'; // 确保路径正确
3. 处理 .db
文件
在代码中,确保您正确加载和处理 .db
文件。例如,使用 fetch
来获取文件内容:
javascriptCopy Code
const response = await fetch(dbFilePath);
// 转换成buffer
const data = await response.arrayBuffer();
const db = new SQL.Database(new Uint8Array(data)); // 从文件加载数据库
完结
sqlite确实好用,如无必要,勿增实体
相关文章:
前端项目接入sqlite轻量级数据库sql.js指南
前端项目接入sqlite轻量级数据库sql.js指南 引言 sql.js 是一个强大的JavaScript库,它使得SQLite数据库能够在网页浏览器中运行。这个开源项目提供了一种方式,让开发者可以在前端环境中实现轻量级的数据库操作,无需依赖服务器端数据存储&…...
模拟退火算法(Simulated Annealing)详细解读
模拟退火算法(Simulated Annealing) 是一种随机优化算法,受到物理学中金属退火过程的启发。它用于寻找全局最优解,特别适合解决组合优化问题。模拟退火算法通过模拟物质在加热和冷却过程中粒子位置的变化,逐渐寻找系统…...

(二十一)、Docker 部署 Minikube 使用可视化管理工具 Kuboard
文章目录 1、介绍docker 运行 minikube 集群节点(kube-apiserver )无法被直接访问的问题Kuboard 需要访问到 k8s 集群的kube-apiserver 2、安装 Kuboard2.1、k8s 集群节点可以被外部直接访问的情况2.1.1、下载镜像2.1.2、运行 deployment.yml2.1.3、访问…...

代码编辑组件
代码编辑组件 文章说明核心代码运行演示源码下载 文章说明 拖了很久,总算是自己写了一个简单的代码编辑组件,虽然还有不少的bug,真的很难写,在写的过程中感觉自己的前端技术根本不够用,好像总是方案不够好;…...

裴蜀定理与欧几里得算法——蓝桥杯真题中的应用
目录 裴蜀定理(Bzouts Theorem)1、定义2、推论3、欧几里得算法4、多个整数的裴蜀定理扩展 真题挑战解题思路代码实现与详细注释代码解析 裴蜀定理(Bzout’s Theorem) 1、定义 对于任意两个整数 a 和 b ,如果它们的最…...

冯诺依曼架构及CPU相关概念
一. 操作系统的概念 1. 概念 操作系统(Operating System). 首先, 所有的计算机都是由软件和硬件构成的. 而操作系统就是许许多多软件中的一种软件, 操作系统可以看作是由两部分组成: 操作系统内核系统级应用程序. 2. 作用 (1) 管理硬件设备, 调度和协调各个硬件之间的工作.…...

智能管线巡检系统:强化巡检质量,确保安全高效运维
线路巡检质量的监控是确保线路安全、稳定运行的重要环节。为了有效监控巡检质量,采用管线巡检系统是一种高效、科学的手段。以下是对如何通过管线巡检系统实现线路巡检质量监控的详细分析: 一、巡检速度监控 管线巡检系统能够实时监控巡检人员的巡检速度…...

React写关键字高亮的三个方案
1.js正则replaceAlldangerouslySetInnerHTML{{ __html: xxx }}危险属性 步骤最简单,但是是危险属性,不推荐使用,项目中实在没有头绪,可以使用它应急 通过useMemo计算得到新的状态值,赋值给dangerouslySetInnerHTML属性的__html 关键代码: const [state1, setState1] useSt…...
重塑在线软件开发新纪元:集成高效安全特性,深度解析与评估会员与促销管理系统的系统架构设计
案例 阅读以下关于软件架构设计与评估的叙述,回答问题1和问题2。 【题目】 某电子商务公司拟升级其会员与促销管理系统,向用户提供个性化服务,提高用户的粘性。在项目立项之初,公司领导层一致认为本次升级的主要目标是提升会员管…...

多层感知机的从零实现与softmax的从零实现(真·0000零基础)
今天再读zh.d2l书(4.2. 多层感知机的从零开始实现 — 动手学深度学习 2.0.0 documentation), 看了关于多层感知机的从零实现与softmax的从零实现 目录 mlp从零实现, 点击“paddle”的代码 点击“torch”的代码 训练 参数解…...
【Rust练习】18.特征 Trait
练习题来自:https://practice-zh.course.rs/generics-traits/traits.html 1 // 完成两个 impl 语句块 // 不要修改 main 中的代码 trait Hello {fn say_hi(&self) -> String {String::from("hi")}fn say_something(&self) -> String; }str…...

【自动化测试之oracle数据库】MacOs如何安装oracle- client
操作系统为Mac OS,本地在pycharm上跑自动化脚本时,因为有操作oracle数据库的部分,所以需要安装oracle数据库的客户端,并install cx_oracle,本文主要介绍如何在macOS上完成安装,并在python自动化测试代码中配置…...
Spring MVC的MultipartFile
定义 MultipartFile接口是Spring MVC中用来处理上传文件的接口,它提供了访问上传文件内容、文件名称、文件大小等信息的方法。 源码: package org.springframework.web.multipart;import java.io.File; import java.io.IOException; import java.io.I…...
●Leetcode| 242.有效的字母异位词 ● 349. 两个数组的交集 ● 202. 快乐数● 1. 两数之和
242,该题目中数组范围比较短,可以数组使用并不会占太多的空间,利用数组的映射,查找到自己所需要的字符 class Solution { public:bool isAnagram(string s, string t) {int record[26] {0};for(int i0;i<s.size();i){record[s[i] - a];/…...
关于算法的时间复杂度和空间复杂度的分析
由于最近开始准备蓝桥杯(python组),开始对编程基础进行一些复习,当我发现蓝桥对大多数题目程序运行时间及大小有要求时,我知道我不得不考虑性能问题,而不是能跑就行🤓 写下这篇文章希望对其他同志有帮助吧 什么是算法…...

深入浅出 C++ STL:解锁高效编程的秘密武器
引言 C 标准模板库(STL)是现代 C 的核心部分之一,为开发者提供了丰富的预定义数据结构和算法,极大地提升了编程效率和代码的可读性。理解和掌握 STL 对于 C 开发者来说至关重要。以下是对 STL 的详细介绍,涵盖其基础知…...
2024年1024程序人生总结
2024-1024 0.大环境0.1.经济0.2.战争 1.我的程序人生1.1.游戏 2.节日祝福 0.大环境 今年的1024最大的感触就是没有节日氛围,往年公司还会准备节日礼物,今年没有,由此可见大环境有多么糟糕。 除此之外,就是到公司应聘的程序员越来…...

【p2p、分布式,区块链笔记 分布式容错算法】: 拜占庭将军问题+实用拜占庭容错算法PBFT
papercodehttps://pmg.csail.mit.edu/papers/osdi99.pdfhttps://github.com/luckydonald/pbft 其他相关实现:This is an implementation of the Pracltical Byzantine Fault Tolerance protocol using PythonAn implementation of the PBFT consensus algorithm us…...

鸿蒙NEXT开发-应用数据持久化之用户首选项(基于最新api12稳定版)
注意:博主有个鸿蒙专栏,里面从上到下有关于鸿蒙next的教学文档,大家感兴趣可以学习下 如果大家觉得博主文章写的好的话,可以点下关注,博主会一直更新鸿蒙next相关知识 专栏地址: https://blog.csdn.net/qq_56760790/…...

人工智能_神经网络103_感知机_感知机工作原理_感知机具备学习能力_在学习过程中自我调整权重_优化效果_多元线性回归_逻辑回归---人工智能工作笔记0228
由于之前一直对神经网络不是特别清楚,尤其是对神经网络中的一些具体的概念,包括循环,神经网络卷积神经网络以及他们具体的作用,都是应用于什么方向不是特别清楚,所以现在我们来做教程来具体明确一下。 当然在机器学习之后还有深度学习,然后在深度学习中对各种神经网络的…...
vue3 字体颜色设置的多种方式
在Vue 3中设置字体颜色可以通过多种方式实现,这取决于你是想在组件内部直接设置,还是在CSS/SCSS/LESS等样式文件中定义。以下是几种常见的方法: 1. 内联样式 你可以直接在模板中使用style绑定来设置字体颜色。 <template><div :s…...

MODBUS TCP转CANopen 技术赋能高效协同作业
在现代工业自动化领域,MODBUS TCP和CANopen两种通讯协议因其稳定性和高效性被广泛应用于各种设备和系统中。而随着科技的不断进步,这两种通讯协议也正在被逐步融合,形成了一种新型的通讯方式——开疆智能MODBUS TCP转CANopen网关KJ-TCPC-CANP…...
Qt Http Server模块功能及架构
Qt Http Server 是 Qt 6.0 中引入的一个新模块,它提供了一个轻量级的 HTTP 服务器实现,主要用于构建基于 HTTP 的应用程序和服务。 功能介绍: 主要功能 HTTP服务器功能: 支持 HTTP/1.1 协议 简单的请求/响应处理模型 支持 GET…...

第一篇:Agent2Agent (A2A) 协议——协作式人工智能的黎明
AI 领域的快速发展正在催生一个新时代,智能代理(agents)不再是孤立的个体,而是能够像一个数字团队一样协作。然而,当前 AI 生态系统的碎片化阻碍了这一愿景的实现,导致了“AI 巴别塔问题”——不同代理之间…...
VTK如何让部分单位不可见
最近遇到一个需求,需要让一个vtkDataSet中的部分单元不可见,查阅了一些资料大概有以下几种方式 1.通过颜色映射表来进行,是最正规的做法 vtkNew<vtkLookupTable> lut; //值为0不显示,主要是最后一个参数,透明度…...

2025盘古石杯决赛【手机取证】
前言 第三届盘古石杯国际电子数据取证大赛决赛 最后一题没有解出来,实在找不到,希望有大佬教一下我。 还有就会议时间,我感觉不是图片时间,因为在电脑看到是其他时间用老会议系统开的会。 手机取证 1、分析鸿蒙手机检材&#x…...
OpenLayers 分屏对比(地图联动)
注:当前使用的是 ol 5.3.0 版本,天地图使用的key请到天地图官网申请,并替换为自己的key 地图分屏对比在WebGIS开发中是很常见的功能,和卷帘图层不一样的是,分屏对比是在各个地图中添加相同或者不同的图层进行对比查看。…...

Mac下Android Studio扫描根目录卡死问题记录
环境信息 操作系统: macOS 15.5 (Apple M2芯片)Android Studio版本: Meerkat Feature Drop | 2024.3.2 Patch 1 (Build #AI-243.26053.27.2432.13536105, 2025年5月22日构建) 问题现象 在项目开发过程中,提示一个依赖外部头文件的cpp源文件需要同步,点…...
Android第十三次面试总结(四大 组件基础)
Activity生命周期和四大启动模式详解 一、Activity 生命周期 Activity 的生命周期由一系列回调方法组成,用于管理其创建、可见性、焦点和销毁过程。以下是核心方法及其调用时机: onCreate() 调用时机:Activity 首次创建时调用。…...
iOS性能调优实战:借助克魔(KeyMob)与常用工具深度洞察App瓶颈
在日常iOS开发过程中,性能问题往往是最令人头疼的一类Bug。尤其是在App上线前的压测阶段或是处理用户反馈的高发期,开发者往往需要面对卡顿、崩溃、能耗异常、日志混乱等一系列问题。这些问题表面上看似偶发,但背后往往隐藏着系统资源调度不当…...