数据库NoSQL嵌入式数据库实时数据库【免费下载链接】rxdbThe local-first database that runs on every JS runtime and replicates with your existing backend - no vendor, no lock-in - https://rxdb.info/项目地址https://gitcode.com/gh_mirrors/rx/rxdb点击查看免费下载NeDBNode Embedded Database曾是 Node.js、Electron 与浏览器应用中最流行的嵌入式文档数据库之一但它的代码自 2016 年起便再无实质更新。本文以 RxDB 为对象系统对比 NeDB 的缺陷与 RxDB 的对应能力给出从 NeDB 迁移到 RxDB 的完整步骤、可运行的代码示例含响应式查询订阅并基于当前仓库源码解析 RxDB 的存储、多标签页同步与复制引擎的底层实现。读完本文你将掌握把既有 NeDB 数据迁移到 RxDB 的完整实战方案。NeDB 简史为什么它曾如此流行NeDB 由 Louis Chatriot 于 2013 年前后创建其核心卖点是提供一套类 MongoDB 的 API却无需部署任何服务端进程。一个 NeDB 数据库就是磁盘上的一个文件库内部把每次操作以追加行的方式写入文件并在后台执行压缩compaction重写整个文件。正是这种设计让它被广泛用于Node.js 脚本与小型服务端需要本地存储又不想搭建 MongoDBElectron / nw.js 桌面应用在会话之间持久化用户数据浏览器应用通过存储适配器把数据写入 IndexedDB 或 localStorage。它的查询语言完全镜像 MongoDB开发者可以用$gt、$in、$regex等操作符查询文档、在字段上建索引、投影结果。然而该库最后一次代码变更停留在 2016 年 5 月2021 年 README 中加入了 not maintained anymore 说明此后仅剩 README 层面的零星修改。社区 fork 如seald-io/nedb虽然延续了生命周期但继承了同一套单文件架构既没有复制replication也没有响应式查询。什么是 RxDBRxDB 是一款响应式、NoSQL、offline-first 的 JavaScript 数据库。它运行在浏览器、Node.js、Electron、React Native 以及任何其他 JavaScript 运行时中。其核心设计理念与 NeDB 用户熟悉的嵌入式、文档型模型一脉相承可替换的存储层文档通过可插拔的 storage 插件保存在本地可观察的查询查询返回 Observable数据每次变化都会自动发出新结果开放的复制协议通过 Sync Engine 让客户端与任意后端保持同步。RxDB 将近十年的持续开发中持续发布版本、安全修复与新特性它把本地数据库当作首要数据源primary source of truth这与今天团队构建 local-first 应用 的方式高度吻合。NeDB 的六大致命短板NeDB 对玩具级用例仍然够用但生产级应用几乎必然撞上以下硬性限制1. 近十年无人维护仓库自 2016 年起没有代码更新报告的 issue 长期挂起依赖漏洞无人修补代码库早于现代 Node.js 的许多特性如 worker threads、async iterators。2. 单文件持久化存在损坏风险NeDB 以追加行写入操作压缩时重写整个文件。压缩中途崩溃会让数据库进入损坏状态且除手动检查文件外没有任何内建恢复机制。数据集变大后启动也会变慢因为 NeDB 会把整个文件重新加载进内存。3. 没有复制能力NeDB 没有任何同步层。两台设备之间、桌面客户端与服务端之间、两个浏览器标签页之间共享数据都需要开发者自行构建、测试并长期维护一套自定义方案。4. 没有可观察查询查询只返回 Promise 或回调。要让 UI 与数据保持同步应用必须在每次写入后手动重新执行查询。这种写读耦合在稍有规模的 UI 中很快就会成为 bug 温床。5. 没有多标签页协调在两个浏览器标签页中打开同一个 NeDB 数据库彼此之间没有任何共享状态概念。一个标签页的写入对另一个不可见除非标签页自己通过BroadcastChannel等原语通信。6. 没有 Schema 校验NeDB 完全无 schema。每个文档可以是任意形状初期看似灵活但字段随时间漂移后立刻转化为运行时错误。它也没有迁移系统数据形状变更只能由应用自行处理。RxDB 如何逐一解决这些问题RxDB 保留 NeDB 用户喜欢的文档型模型同时补齐 NeDB 缺失的全部能力持续维护定期发布版本包含安全与功能更新Schema 校验每个 collection 由基于 JSON Schema 的 RxSchema 定义支持版本化与迁移MongoDB 风格查询RxQuery API 支持 NeDB 用户熟悉的全部操作符包括$gt、$in、$regex、$elemMatch以及排序、skip/limit可观察查询查询暴露 RxJS Observable结果变化时 UI 自动更新详见 Reactivity多标签页支持一个标签页的写入通过BroadcastChannel流式同步到其他标签页底层由冲突安全的存储处理保障复制能力Sync Engine 可对接任意 HTTP、GraphQL、CouchDB、WebRTC 或自定义后端持久化存储RxDB 内置久经考验的存储适配器——Node.js 与 Electron 上可用 SQLite 或文件系统浏览器中可用 IndexedDB、OPFS、Dexie 或 SQLite-WASM。代码示例从 NeDB 到 RxDB一个典型的 NeDB 工作流长这样const Datastore require(nedb); const db new Datastore({ filename: tasks.db, autoload: true }); db.insert({ _id: t1, title: Write report, done: false }, (err, doc) { // ... }); db.find({ done: false }).sort({ title: 1 }).exec((err, docs) { // ... });同样的工作流在 RxDB 中是这样import { createRxDatabase } from rxdb/plugins/core; import { getRxStorageLocalstorage } from rxdb/plugins/storage-localstorage; const db await createRxDatabase({ name: tasks, storage: getRxStorageLocalstorage() }); await db.addCollections({ tasks: { schema: { title: task schema, version: 0, primaryKey: id, type: object, properties: { id: { type: string, maxLength: 100 }, title: { type: string }, done: { type: boolean } }, required: [id, title, done] } } }); await db.tasks.insert({ id: t1, title: Write report, done: false }); const openTasks await db.tasks .find({ selector: { done: false }, sort: [{ title: asc }] }) .exec();查询语法与 MongoDB 保持接近因此大多数 NeDB selector 可以原样平移。完整的操作符清单见 RxQuery 文档。从源码看存储与写入路径上面代码中的getRxStorageLocalstorage来自 src/plugins/storage-localstorage/index.ts它接受可选的LocalstorageStorageSettings配置并返回RxStorageLocalstorage实例在创建 storage 实例时会调用ensureRxStorageInstanceParamsAreCorrect校验参数src/rx-storage-helper.ts并将实例级 options 与全局 settings 合并src/plugins/storage-localstorage/index.ts。insert方法内部实际委托给bulkInsertsrc/rx-collection.ts后者批量写入并返回{ success, error }结构——这正是后续迁移脚本复用同一写入通道的依据无论是单条insert还是大批量bulkInsert都走同一条经过校验与冲突处理的存储路径。代码示例订阅查询结果下面这段是 NeDB 完全没有对应物的能力。在 RxDB 中只要匹配的文档发生变化结果列表就会自动更新db.tasks .find({ selector: { done: false } }) .$.subscribe(tasks { renderTaskList(tasks); }); // 在应用的其他位置插入新任务 await db.tasks.insert({ id: t2, title: Send invoice, done: false }); // 上面的订阅者会立即收到更新后的数组。从源码看$可观察对象的实现RxQuery的$getter 定义在 src/rx-query.ts它基于collection.eventBulks$的变更事件流构造 Observable任何写入事件都会触发查询结果重算并推送新数组。这种写读解耦模式消除了每次写入后手动重跑查询的样板代码让 UI 始终与数据库状态保持一致。多标签页与跨进程同步的底层机制NeDB 场景下标签页之间无法感知彼此的写入RxDB 则在存储层解决了这个问题。src/rx-storage-multiinstance.ts 的注释明确指出当同一个持久化 RxStorage 被多个 JavaScript 进程使用时changestream()的事件流必须广播给同一databaseName collectionName的其他RxStorageInstance。实现上 RxDB 复用broadcast-channel库且每个RxDatabase只创建一个可复用的BroadcastChannel——这样也能在 leader election 插件中共享同一通道。这一设计把广播逻辑下沉到存储层而非 RxDB 核心好处是广播可以在 WebWorker 内完成而不占用主线程同时便于把不同存储叠加组合例如 memory 插件。复制给迁移后的数据加上同步能力如果旧系统曾通过自定义机制同步数据迁移时可直接替换为官方复制协议。replicateRxCollection定义于 src/plugins/replication/index.ts其核心参数包括参数含义默认值replicationIdentifier复制的唯一标识须在多个端点上保持一致必填collection要复制的 RxCollection必填deletedField文档中标记删除状态的字段名_deletedpull/push拉取与推送的处理器函数至少提供一个可选live是否为持续运行的实时复制trueretryTime失败后的重试间隔毫秒5000waitForLeadership是否等待成为 leader 后才开始复制trueautoStart创建后是否自动启动truetoggleOnDocumentVisible页面隐藏时暂停、可见时恢复复制true源码中src/plugins/replication/index.ts对pull与push都为空的情况会直接抛出UT3错误因为既没有拉取也没有推送的复制毫无意义toggleOnDocumentVisible开启时只有被选举为 leader 的标签页在页面不可见时仍继续复制其余标签页会暂停src/plugins/replication/index.ts。完整方案参见 Sync Engine。迁移步骤把 NeDB 数据搬到 RxDB绝大多数 NeDB 项目可以按以下几步完成迁移为每个 NeDB datastore 定义 schema。抽样检查既有文档以推导字段类型与必填属性。schema 是 RxCollection 的强制要求并解锁校验与迁移能力。选择存储。Node.js 或 Electron 上使用 SQLite 等持久化存储参见 Node.js Database 与 Electron Database浏览器中以 IndexedDB 或 OPFS 为默认选择。导入数据。用旧库读取现有 NeDB 文件把每个文档规范化以匹配新 schema然后对对应 collection 调用bulkInsert。NeDB 以_id作为主键而 RxDB 允许你任选字段因此通常需要一次小规模的字段重命名。翻译查询。大多数 selector 无需修改即可移植把回调 API 换成 async/await把手动重跑换成.$Observable 以获得响应式更新。按需添加复制。如果旧系统通过自定义机制同步数据用官方 RxDB 复制 替换它。一份在首次启动时只运行一次的迁移脚本通常就足够了。导入成功验证后即可删除遗留的 NeDB 文件。迁移中的批量写入细节第 3 步提到的bulkInsert是迁移脚本的关键入口。src/rx-collection.ts 中bulkInsert返回{ success, error }结构便于按主键定位失败文档同文件还提供了bulkUpsertsrc/rx-collection.ts其语义是以相同主键覆盖既有文档内部仍复用bulkInsert的写入通道src/rx-collection.ts。当 NeDB 文件中存在与目标主键冲突的文档时bulkUpsert是比bulkInsert更稳妥的选择。注意 RxDB 要求主键字段为字符串且在 schema 中声明maxLength如示例中的maxLength: 100迁移脚本需确保_id重命名后符合这一约束。对比总览特性NeDBRxDB维护状态2016 年后无代码变更README 标记不再维护活跃定期发布查询语言MongoDB 风格MongoDB 风格RxQuerySchema 校验无基于 JSON SchemaRxSchema可观察查询无有通过 RxJSReactivity多标签页支持无有复制无内建Sync Engine浏览器存储IndexedDB 适配器IndexedDB、OPFS、Dexie、SQLite-WASMNode.js 存储单文件追加日志SQLite、文件系统、内存Node.js DatabaseElectron 存储单文件追加日志持久化存储Electron Database迁移手动内建 schema 迁移TypeScript 支持社区类型定义一等公民加密无可选插件压缩无可选插件常见问题NeDB 还在维护吗不。原 NeDB 仓库自 2016 年起再无提交并已归档issue 长期无人处理依赖安全公告也没有回应。社区 fork 确实存在但没有一个能提供 RxDB 这类活跃项目所能提供的长期支持。我能在 RxDB 中继续使用 MongoDB 风格查询吗可以。RxDB 查询使用与 MongoDB、NeDB 相同的 selector 格式包括$gt、$lt、$in、$nin、$regex、$elemMatch等操作符以及sort、skip、limit。完整清单见 RxQuery 文档。RxDB 在 Electron 中安全可用吗可以。RxDB 为 Electron 提供官方指南与存储选项包括把数据存到本地文件系统的 SQLite 存储。 Electron Database 页面覆盖主进程与渲染进程两侧的配置以及多窗口场景。如何把数据从 NeDB 迁移到 RxDB用旧库读取现有 NeDB 文件定义与文档匹配的 RxDB schema然后对新的 collection 调用bulkInsert。复制数据时把_id重命名为你选定的主键。验证导入结果后即可删除旧的 NeDB 文件。结语RxDB 为 NeDB 用户提供了一个持续维护、文档型、拥有相同 MongoDB 风格查询语言的数据库并补齐了现代应用必需的能力schema、可观察查询、多标签页协调与 复制。从 Quickstart 入手为你的运行时选择一款合适的存储再写一段简短的一次性迁移脚本即可完成 collection 迁移。更多资源Local-First 未来Offline-First 指南RxDB Sync Engine赞分享数据库NoSQL嵌入式数据库实时数据库【免费下载链接】rxdbThe local-first database that runs on every JS runtime and replicates with your existing backend - no vendor, no lock-in - https://rxdb.info/项目地址https://gitcode.com/gh_mirrors/rx/rxdb点击查看免费下载相关推荐RxDB 作为 Hoodie 的替代方案离线优先 JavaScript 应用的现代迁移路径RxDB 作为 Hoodie 的替代方案离线优先 JavaScript 应用的现代迁移路径 导读 本文面向仍在使用 Hoodie以及直接使用 PouchD数据库NoSQL嵌入式数据库实时数据库Go ORM新纪元gorp库让数据库操作效率提升300%的终极指南 Go ORM新纪元gorp库让数据库操作效率提升300%的终极指南 gorp是Go语言生态中一款强大的关系型持久化库它通过自动化数据绑定和SQL生成后端so-vits-svc API开发手册如何快速构建自己的歌声转换服务so vits svc API开发手册如何快速构建自己的歌声转换服务 so vits svc是一个基于vits与softvc的歌声音色转换模型通过其API接人工智能语音音频深度学习创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考