关系型数据库数据库前端【免费下载链接】lovefieldLovefield is a relational database for web apps. Written in JavaScript, works cross-browser. Provides SQL-like APIs that are fast, safe, and easy to use.项目地址https://gitcode.com/gh_mirrors/lov/lovefield点击查看免费下载Lovefield 是一个用纯 JavaScript 编写、运行于浏览器端的关系型数据库为 Web 应用提供 SQL 风格的查询 API。本指南以仓库根目录的 README.md 为主线完整覆盖其定位、3 分钟快速上手、Schema 建模、增删改查、数据存储后端与开发者环境搭建并结合仓库内规格文档docs/spec_index.md与核心源码如 lib/schema/builder.js、lib/enums.js展开原理级讲解。读完本文你将能够独立完成一个 Lovefield 应用的建表、写入、查询与部署并理解其与 IndexedDB、WebSQL、Firebase 等底层存储的关系。Lovefield 是什么Lovefield 是一个纯 JavaScript 编写的关系型数据库relational database不是 IndexedDB 的简单封装而是自带完整关系查询引擎的独立库。它提供 SQL-like类 SQL语法可在多种浏览器中运行当前仓库明确支持 Chrome 37、Firefox 31、IE 11、Edge 以及 Safari 10见 README.md 与 FAQ 中对 Safari 版本的说明。它的核心设计目标详见 docs/spec/00_intro.md包括数据集定位面向数据量小于 2GB当前上限但仍需要结构化查询引擎的应用场景功能范围提供 SQL-03 标准的一个实用子集覆盖 WebSQL 支持的大部分使用场景零副作用不应因引入该库产生任何全局副作用API 全部集中在lf命名空间下避免污染全局跨浏览器与低端设备兼容 Chrome、Firefox、IE、Safari并可在低 CPU、低内存设备如 HP Chromebook 11 级别上运行多种集成方式可作为普通库通过script引入可作为 npm/bower 组件依赖也可配合 Closure Compiler 高级优化、Chrome Apps v2仅需 storage 访问权限、以及 jQuery、AngularJS、Polymer 等主流框架使用。Lovefield 并不接受原始 SQL 语句而是采用builder pattern建造者模式API来构建查询——这是它与传统关系数据库最大的使用差异也是快速上手时需要最先适应的习惯。三分钟快速上手最小可运行示例仓库在 demos/todo/README.md 中给出了一个完整的、可复制运行的最小示例。这个示例演示了 Lovefield 使用闭环定义 Schema → 连接数据库 → 创建行 → 写入 → 查询 → 消费结果。完整 HTML 如下!doctype html html head meta charsetutf-8 / titleMinimal example of using Lovefield/title script srcbower_components/lovefield/dist/lovefield.min.js/script /head body script var schemaBuilder lf.schema.create(todo, 1); schemaBuilder.createTable(Item). addColumn(id, lf.Type.INTEGER). addColumn(description, lf.Type.STRING). addColumn(deadline, lf.Type.DATE_TIME). addColumn(done, lf.Type.BOOLEAN). addPrimaryKey([id]). addIndex(idxDeadline, [deadline], false, lf.Order.DESC); var todoDb; var item; schemaBuilder.connect().then(function(db) { todoDb db; item db.getSchema().table(Item); var row item.createRow({ id: 1, description: Get a cup of coffee, deadline: new Date(), done: false }); return db.insertOrReplace().into(item).values([row]).exec(); }).then(function() { return todoDb.select().from(item).where(item.done.eq(false)).exec(); }).then(function(results) { results.forEach(function(row) { console.log(row[description], before, row[deadline]); }); }); /script /body /html这段代码对应下列 SQL 语义lf.schema.create(todo, 1)—— 等价于CREATE DATABASE IF NOT EXISTS todoDDL 不会立即执行Lovefield 先通过 builder 组装 Schema之后才打开或创建数据库实例createTable(Item)及后续链式调用 —— 等价于CREATE TABLE Item (id INTEGER, description STRING, deadline DATE_TIME, done BOOLEAN, PRIMARY KEY (id))加上ALTER TABLE Item ADD INDEX idxDeadline(Item.deadline DESC)insertOrReplace().into(item).values([row]).exec()—— 等价于INSERT OR REPLACE INTO Item VALUES rowselect().from(item).where(item.done.eq(false)).exec()—— 等价于SELECT * FROM Item WHERE Item.done false。逐行解读关键 APIlf.schema.create(name, version)创建 Schema 建造器。name为数据库名version必须为大于 0 的整数Lovefield 依赖版本号判断数据库是否需要升级数据迁移机制见 docs/spec/03_life_of_db.md。schemaBuilder.createTable(...)链返回TableBuilder实例其所有成员函数都返回自身以支持链式调用源码见 lib/schema/table_builder.js。schemaBuilder.connect()终结 Schema 构建并连接数据库实例。若数据库是全新的Lovefield 会按 Schema 创建它若已存在则按数据库名定位并连接。连接建立后Schema 不可再修改——lf.schema.Builder是有状态对象building/finalized 两种状态finalized 之后不再接受任何调用。db.getSchema().table(Item)获取表的 Schema 表示。所有 Schema 相关 API 都是同步的。item.createRow({...})创建行。Lovefield不接受普通 JavaScript 对象作为行必须通过表的createRow()生成这是为了将用户载荷安全转换为 Lovefield 内部格式lf.Row见 lib/row.js。exec()真正执行查询返回 Promise。connect()与全部查询 API 都是基于 Promise 的异步API避免长耗时查询阻塞主线程。本地运行步骤示例应用源码位于 demos/todo在该目录下执行npm install -g gulp # 安装 gulp若尚未安装 npm install -g bower # 安装 bower若尚未安装 npm install . # 拉取 package.json 中的依赖 bower install # 拉取 bower.json 中的依赖 gulp debug # 启动本地 Web 服务器然后访问http://localhost:8000/todo.html即可看到效果。对应的依赖清单与构建脚本见 demos/todo/package.json、demos/todo/bower.json 与 demos/todo/gulpfile.js。如何获取 Lovefieldnpm、Bower 与复制部署除直接从仓库dist目录下载外Lovefield 支持两大包管理器npm info lovefield bower info lovefield将lovefield加入依赖后执行npm update或bower update即可自动拉取指定版本。仓库根目录 package.json 显示当前版本为2.1.12main字段指向dist/lovefield.min.js构建产物许可为 Apache-2.0运行时依赖仅js-yaml与nopt供 SPAC 命令行工具使用并内置lovefield-spac二进制命令。除此之外Lovefield 还支持复制部署直接把压缩后的 JS 文件复制进项目即可使用无需了解内部实现——这是 docs/spec/00_intro.md 中明确列出的需求之一。Schema 定义数据类型、约束与索引Schema 是关系型数据库的结构。一个 Schema 包含名称与版本号程序来源、名称、版本号三者共同唯一标识持久化存储上的一个数据库实例详见 docs/spec/01_schema.md。命名规则所有命名必须通过以下正则检查否则抛出异常/^[A-Za-z_][A-Za-z0-9_]*$/即首字符为字母或下划线后续为字母、数字或下划线。支持的数据类型lf.TypeLovefield 定义了 7 种列类型枚举定义见 lib/enums.js各类型默认值来自lf.type.DEFAULT_VALUES与可空性如下表类型默认值默认是否可空说明lf.Type.ARRAY_BUFFERnull是JavaScriptArrayBuffer对象lf.Type.BOOLEANfalse否JavaScriptbooleanlf.Type.DATE_TIMEDate(0)否JavaScriptDate内部会转换为整数时间戳lf.Type.INTEGER0否32 位整数lf.Type.NUMBER0否JavaScriptnumberlf.Type.STRING否JavaScriptstringlf.Type.OBJECTnull是JavaScriptObject原样存储需要特别注意两点ARRAY_BUFFER与OBJECT两种类型默认即可空即使不调用addNullable()其余类型默认不可空必须显式调用addNullable()才能允许空值——这与传统 SQL 引擎的默认行为相反是 Lovefield 的显著差异。类型使用限制Lovefield 内部仅接受字符串或数字作为索引键。ARRAY_BUFFER与OBJECT列不可建索引、不可参与任何约束ARRAY_BUFFER列不可用于WHERE子句OBJECT列只能配合isNull/isNotNull谓词使用否则会抛出lf.Exception。当下列类型被用作索引/主键/唯一约束时会发生内部隐式转换lf.Type.BOOLEAN→ 转换为lf.Type.STRINGlf.Type.DATE_TIME→ 转换为lf.Type.NUMBERlf.Type.INTEGER→ 转换为lf.Type.NUMBER约束ConstraintsLovefield 支持四种约束主键、外键、唯一、可空/非空。主键每张表仅允许一个主键通过addPrimaryKey([id])添加源码 lib/schema/table_builder.js。与 SQL 一致主键隐含唯一且非空。Lovefield 支持自增主键必须是整数列、默认升序值由 Lovefield 从 1 开始自动分配。外键通过addForeignKey()添加。主键/外键约束违反会导致事务被拒绝与 SQL 行为一致当外键的opt_cascade为true时查询引擎会执行必要的级联删除与级联更新。完整规则与测试覆盖见 docs/spec/08_referential_integrity.md 与 tests/proc/end_to_end_foreign_key_test.js。唯一约束通过addUnique()添加。唯一约束会隐式创建索引跨列唯一约束表示这些列的值组合必须唯一。可空通过addNullable()显式声明。索引IndicesLovefield不使用底层存储如 IndexedDB提供的索引而是实现自己的索引。从源码结构看默认索引结构为 B 树实现见 lib/index/btree.js。索引特性包括通过addIndex(name, columns, isUnique, order)添加支持单列与跨列索引只有非空且可索引的列才能建索引类型限制见上文与多数 SQL 引擎不同Lovefield 限制索引列的值一律不能为 null由于唯一约束会隐式建索引创建作用域相同的索引会抛出异常不支持自定义索引即基于函数转换的索引如邮箱反转文本原因是 Chrome Apps v2 环境下无法持久化并 eval JavaScript 函数用户应在自己的代码中完成转换后存储转换结果默认情况下索引在加载时于内存中构建不持久化仅当调用persistentIndex()时才将索引持久化到数据存储。相关测试见 tests/smoke/persistent_index_test.js。静态 Schema 与 SPAC除动态lf.schema.create()方式外Lovefield 还支持静态 Schema 构建将数据库 Schema 写入 YAML 文件通过 SPACSchema Parser And Code-generator见 spac/spac.js 与命令行工具 spac/lovefield-spac生成 JavaScript 源码再与核心库一起经 Closure Compiler 编译打包。这种方式更适合全部代码参与 Closure 高级优化的场景属于进阶用法详见 docs/spec/07_spac.md。数据操作Promise 链驱动的异步 CRUDLovefield 的 API 风格docs/spec/00_intro.md有一条清晰的分界线所有 DDL数据定义语言API 都是同步的所有 DML数据操纵语言API 都是异步的、基于 Promise 的。因此快速上手示例中大量使用Promise 链then()依次衔接Lovefield 保证前一个.then()中exec()的写入已在隐式事务中提交后才进入下一个.then()。写入insert 与 insertOrReplace// INSERT OR REPLACE INTO Item VALUES row; return db.insertOrReplace().into(item).values([row]).exec();insertOrReplace()对应INSERT OR REPLACE语义不带OrReplace的insert()则对应普通INSERT。数据必须先用item.createRow({...})生成行对象exec()返回的 Promise 在事务提交后 resolve。相关 builder 实现见 lib/query/insert_builder.js上下文对象见 lib/query/insert_context.js。查询select / where / 谓词// SELECT * FROM Item WHERE Item.done false; return todoDb.select().from(item).where(item.done.eq(false)).exec();select()返回 Promiseresolve 为普通 JavaScript 对象数组而非lf.Row实例lf.Row只是内部存储抽象见 lib/row.js。没有匹配行时数组为空可用列名直接解引用字段row[description]。谓词体系包括eq、neq、lt、lte、gt、gte、in、between、isNull/isNotNull、match等并可组合成 AND/OR 复合谓词实现见 lib/pred 目录如 lib/pred/value_predicate.js、lib/pred/combined_predicate.js。删除与更新分别由delete()、update()builder 提供lib/query/delete_builder.js、lib/query/update_builder.js。行与持久化细节存储的基本单位是行每行拥有在整个数据库实例内唯一的行 id因此单实例可容纳的理论行数上限为Number.MAX_SAFE_INTEGER。Lovefield 不负责配额管理存储配额可能涉及用户交互授权需要应用自行处理。查询引擎、逻辑/物理计划、索引扫描等执行细节可进一步阅读 docs/spec/04_query.md 与设计文档 docs/dd/04_query_engine.md。数据存储后端IndexedDB、Memory、Firebase 与 WebSQLLovefield 使用现有存储技术持久化数据当前支持四种数据存储见 docs/spec/02_data_store.md存储类型持久性状态说明lf.schema.DataStoreType.INDEXED_DB是浏览器内已发布基于 IndexedDB跨会话持久化默认后端lf.schema.DataStoreType.MEMORY否已发布仅当前会话有效的易失存储lf.schema.DataStoreType.FIREBASE是云端已发布基于 Firebase数据持久化在云端lf.schema.DataStoreType.WEB_SQL是浏览器内已废弃仅用于遗留 Safari对应后端实现位于 lib/backstore 目录如 lib/backstore/indexed_db.js、lib/backstore/memory.js、lib/backstore/firebase.js、lib/backstore/web_sql.js。几个值得注意的实践要点Firebase 存储的数据实际存放在 Firebase 服务器云端无网络连接时无法取回Lovefield 假定调用方提供已认证、且具备足够读写权限的 Firebase 实例WebSQL 已废弃该后端是为 Safari 10 之前的遗留环境创建的Safari 10 起完全受支持官方建议尽快迁离 WebSQL它不久将被移除LocalStorage 存储目前仅用于测试目的lib/backstore/local_storage.js除非有足够需求否则不会公开数据在底层存储中的组织方式以性能最优为目标Lovefield不保证原始数据可直接检视——尤其在启用实验性 Bundle Mode见 docs/spec/99_postfix.md时在 Safari/Firefox 的隐私浏览模式下存储可能不可用Safari 不支持隐私模式下的任何存储此时可考虑改用 Memory 存储。Lovefield 与这些底层技术的关系定位FAQIndexedDB、WebSQL、Firebase 只是持久化数据存储关系查询能力由 Lovefield 自带引擎提供这是它区别于 IndexedDB/Firebase两者不提供关系查询与 WebSQL已废弃且无法跨浏览器工作的核心差异。WebSQL 还被用作纯数据存储但 Lovefield 的索引与查询执行不使用 WebSQL。查询执行原理内建关系查询引擎Lovefield 内建了与 SQLite、MySQL 等类似的关系查询引擎区别在于它不接受原始 SQL而是通过 builder API 构建查询并在浏览器内部执行。从源码结构lib/proc 目录可以梳理出执行链路查询先生成逻辑查询计划lib/proc/logical_plan_factory.js、lib/proc/logical_plan_generator.js再经逻辑计划重写器lib/proc/logical_plan_rewriter.js应用多个优化 pass如隐式连接 pass、下推选择 pass、索引范围扫描 pass、排序走索引 pass 等见 lib/proc/and_predicate_pass.js、lib/proc/index_range_scan_pass.js 等随后转换为物理查询计划lib/proc/physical_plan_factory.js并由执行器逐步骤执行表扫描、索引范围扫描、连接、聚合、排序、投影等 step 文件均在 lib/proc 中。完整的生命周期图与各 pass 的详细设计见设计文档 docs/dd/04_query_engine.md。由于这一切发生在浏览器内长查询会消耗 CPU 与 I/O 资源这正是全部查询 API 采用异步 Promise 设计的原因。从 README 出发的文档地图仓库根 README.md 集中给出了全部官方文档入口整理如下均为仓库根相对路径快速上手3 分钟最小示例与本地运行步骤即本文第二、三节内容FAQ生产可用性、框架互操作、性能、查询执行原理、与 IndexedDB/WebSQL/Firebase 的关系等高频问题解答规格说明书以章节组织的权威规范涵盖 00 引言目标与假设、01 Schema、02 数据存储、03 数据库生命周期含初始化与升级迁移、04 查询、05 事务、06 库设施、07 SPAC、08 引用完整性 与 未来特性开发者环境搭建编译、测试与贡献指南设计文档正在进行中的内部设计文档00 引言 至 06 索引是深入理解查询引擎与索引实现的第一手材料。此外仓库还提供多套可直接运行的完整示例可作为进阶学习素材待办事项 demos/todo、电影数据库 demos/moviedb、Scrum 看板 demos/scrum、奥运会奖牌榜 demos/olympia_db含 Angular 与 Polymer 版本、TypeScript 版本 demos/todo_typescript 以及 Browserify 版本 demos/todo_browserify还有一份股票分析器的分步教程 codelabs/stock_analyzer。开发者环境编译、测试与贡献Lovefield 的工程体系围绕 Closure 工具链构建docs/dev_setup.md前置要求可用的 Java、git 与 Node.js版本建议见根目录 package.jsonengines要求node 12.16.3。Windows 用户需注意命令提示符的命令行长度限制会导致 Closure 编译器失败需要借助 TCC/LE 等工具安装依赖npm updatenpm 为依赖管理器Closure 编译器由 npm 自动拉取构建以 gulp 为构建管理器执行gulp查看全部支持的命令Closure 编译器负责校验、压缩与混淆代码本地测试手动安装 Selenium WebDriver 后运行gulp test --targettests --browserbrowser适合调试与快速迭代Sauce Labs 云端测试设置SAUCE_USERNAME、SAUCE_ACCESS_KEY、SELENIUM_BROWSER环境变量后运行gulp test --targettests可依次覆盖 chrome、firefox、ie、safari贡献流程提交前需通过gulp build --targetlib --modeopt、gulp build --targettests、gulp lint、gulp test --targetspac以及跨浏览器测试代码风格遵循 Google JavaScript Style Guide具体规则见 CONTRIBUTING.md。SPAC 的解析与代码生成测试见 spac/parser_test.js 与 spac/codegen_test.js。需要说明的是本文所有命令与配置均以当前仓库实际内容为准例如dist/构建产物、示例目录结构等请以仓库 checkout 后的实际文件为准。常见问题精编以下是 docs/FAQ.md 中与日常选型、使用直接相关的要点生产质量如何FAQ 声明其生产可用并提及 Inbox by GMail 与 Google Play Movies TV 曾重度依赖它执行复杂客户端结构化数据查询。此为文档陈述的事实实际效果请以目标平台自测为准。能否与 Angular/Bootstrap/Cordova/D3 等配合可以。Lovefield 从一开始就按与现有 JS 库/框架协作而设计。性能如何FAQ 指向性能基准与 dashboard见 perf 目录与 tests/perf并强调结果因平台与浏览器而异最佳验证方式是在目标平台亲自运行基准。为什么不用原始 SQL因为 Lovefield 采用 builder-pattern API 构建查询查询在浏览器内执行。与 IndexedDB/Firebase 的差异Lovefield 提供它们所没有的关系查询能力。与 WebSQL 的差异WebSQL 已废弃且无法跨浏览器运行Lovefield 可跨浏览器运行。Safari 支持范围仅支持 Safari 10 及更高版本。隐私浏览模式Safari 隐私模式不支持任何存储可改用 Memory 存储Firefox 存在相关已知问题。使用限制与边界基于规格文档与源码使用 Lovefield 前应明确以下边界面向小于 2GB 的数据集提供的是 SQL-03 的子集而非完整 SQL不接收原始 SQL 字符串全部通过 builder API 表达不支持自定义索引与基于函数的列转换索引索引列值不允许为 nullARRAY_BUFFER/OBJECT列不可索引、不可搜索后者仅支持 null 谓词除ARRAY_BUFFER/OBJECT外所有列默认 NOT NULL与多数 SQL 引擎默认行为相反数据在底层存储中的原始格式不保证可检视WebSQL 后端已废弃Safari 仅支持 10。理解这些边界后Lovefield 最适合的场景是需要在浏览器端对中等规模结构化数据执行关系查询、且希望获得跨浏览器一致行为的 Web 应用。从 docs/dd_index.md 与 docs/spec_index.md 继续深入即可完整掌握其查询引擎、事务与索引的内部机制。赞分享关系型数据库数据库前端【免费下载链接】lovefieldLovefield is a relational database for web apps. Written in JavaScript, works cross-browser. Provides SQL-like APIs that are fast, safe, and easy to use.项目地址https://gitcode.com/gh_mirrors/lov/lovefield点击查看免费下载相关推荐IoT-For-Beginners 实战使用 Wio Terminal 通过 MQTT 发布 DHT11 温度遥测数据以支撑 GDD 计算IoT For Beginners 实战使用 Wio Terminal 通过 MQTT 发布 DHT11 温度遥测数据以支撑 GDD 计算 本指南是 IoT关系型数据库数据库前端Lovefield完整指南如何在浏览器中构建强大的关系型数据库Lovefield完整指南如何在浏览器中构建强大的关系型数据库 Lovefield是一个纯JavaScript编写的关系型数据库专为Web应用设计。它提供S关系型数据库数据库前端Lovefield 查询系统详解从 SQL Builder 到参数化查询与数据观察的完整实践指南Lovefield 查询系统详解从 SQL Builder 到参数化查询与数据观察的完整实践指南 导读 本文围绕 Lovefield 官方规范文档 docs/关系型数据库数据库前端上一篇【亲测免费】 Android BluetoothLeGatt 项目常见问题解决方案下一篇开源项目【DrawerArrowDrawable】指南及问题解决创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考