
EventSourcingDB 1.3.0 发布,性能与稳定性提升并引入 v2 API
来源标题:EventSourcingDB 1.3.0 Is Available
EventSourcingDB 1.3.0 发布,写入和 EventQL 查询速度大幅提升,读取也更快,每个请求都有时间上限,并包含 60 多项修复。新版本引入 v2 API,服务器接受请求后在响应体中报告结果并为每个错误分配独立代码;v1 API 支持至 2027 年 1 月 31 日。文档已迁移至 eventfoundation.io。
以下正文由 AI 翻译自 Hacker News(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
EventSourcingDB 1.3.0 已发布,它比以往任何版本都更快、更稳定。写入和 EventQL 查询的速度显著提升,读取也更快了,每个请求都有时间上限,并且包含六十多项修复。除此之外,它还带来了一个新的 API,该 API 会在响应体中报告其接受的每个请求的结果,并为每个错误指定专属的错误码。
本文介绍有哪些变化,以及升级时需要注意什么。v1 API 的支持将持续到 2027 年 1 月 31 日,后续版本会将其移除,因此你可以按自己的节奏迁移到新版本。从今天起,EventSourcingDB 的文档位于 eventfoundation.io;所有旧链接都会指向那里。
新的 v2 API 与 v1 API 并行运行,共用同一份数据。其核心理念很简单:一旦服务器接受了请求,请求的结果就体现在响应体中。当请求通过身份验证、请求体符合其路由所期望的结构,并且未超出限制时,该请求才算被接受。不满足的前置条件、未知的事件类型、处于只读模式的数据库——所有这些都会以客户端可读取的响应形式返回,而不是客户端必须自行解读的状态码。
每个错误都带有一个错误码,该错误码是指向专属页面的链接,页面解释了错误发生的原因以及如何修复。你可以在 Errors 下找到全部错误。流式响应在结束时(例如读取事件)会以一个显式的结束项关闭,这样客户端就能区分完整响应和被截断的响应。当流处于等待状态时,服务器会通过它发送心跳,以防止代理在此期间关闭连接。
v2 API 还带来了递归前置条件:isSubjectPristine、isSubjectPopulated 和 isSubjectOnEventId 现在可以作用于某个 subject 及其下所有子 subject。当决策取决于整棵子树而非单个 subject 时,这非常有用。
全部八个客户端 SDK 的当前版本都同时支持两种 API,并在服务器提供 v2 API 时优先使用它。因此,除了更新 SDK 之外,你无需修改代码——前提是数据库前面的代理允许通过 HTTP 方法 QUERY,v2 API 使用该方法进行读取。如果你直接调用 HTTP API,Migrating to v2 会逐个路由说明有哪些变化。
导出和导入让将事件迁移到新数据库变得更加容易。两者都按每行一个普通 CloudEvent 的方式工作,包括其 ID 和时间,因此导出的内容可以直接导入,无需任何转换。由于导入会自行计算哈希,你也可以导出一段历史记录,从中移除个人数据,然后导入结果,而无需手动计算任何哈希。
增量备份只包含自上次备份以来写入的事件。恢复时需要先使用完整备份,再依次应用其增量备份,这使得大型数据库的定期备份保持较小。恢复本身也显著加快,因为它现在会批量写入事件。
无论是单个客户端还是多个客户端同时写入,写入速度都显著提升,并且不再随着存储增长而变慢。运行 EventQL 查询也显著加快,尤其是读取大量事件、分组、排序或连接多个数据源的查询,读取事件同样如此。索引占用的文件大幅减少,因此在大型数据库中读取某个 subject 的事件变得更快,而验证存储的完整性会报告发现的每一处不一致(最多一百处),而不再只报告第一处。
1.3 中的许多其他工作在你需要之前是看不见的。每个请求、每个响应以及每个空闲连接都有时间上限,因此缓慢或卡住的客户端不再能永久占用资源。EventQL 查询对嵌套深度和内存占用都有限制,从而防止单个查询导致栈溢出或随意占用内存。
服务器以恒定时间比较 API token,并拒绝以可能被猜到的 token 启动。如果写入存储失败(例如磁盘已满),它会切换到只读模式直到重启,继续提供读取服务,通过健康端点报告此状态,并在日志中指明原因。Limits 列出了各项限制。
还有一些新增功能旨在帮助在生产环境中运行 EventSourcingDB。速率限制默认启用,并随机器规模扩展,因此发送过多请求的单个客户端无法压垮数据库。v2 API 的健康端点支持 OpenMetrics,这意味着你可以直接用 Prometheus 及类似工具抓取它,并且它会报告更多进程信息,例如内存和文件描述符;Logging and Monitoring 列出了它报告的内容。
如果你想确保只写入已知的事件类型,新标志 --require-event-schemas 会拒绝写入和恢复类型没有注册 schema 的事件。该标志默认关闭。此外,/.well-known/api-catalog 处的 API 目录会将工具指向两个 API 的 OpenAPI 文档。
此版本在升级时需要一些谨慎。请先阅读 Upgrading EventSourcingDB;以下是最重要的几点:
升级指南和变更日志列出了其他所有需要注意的事项,例如对事件来源和事件 schema 的更严格规则。
在关键之处更快,在出错之处更稳健,并在你熟悉的 API 之外提供一个新 API:这就是 1.3。如果你已经在运行 EventSourcingDB,升级指南可以安全地引导你完成升级。
如果你还没有尝试过 EventSourcingDB——这个为事件溯源而构建的数据库,现在是个好时机。Installing EventSourcingDB 为你提供二进制文件和 Docker 镜像,Quickstart 则带你从启动服务器到在几分钟内写入并读取第一个事件。我们很乐意听到你用它构建了什么。
native web 的 CTO 兼创始人。www.thenativeweb.io
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。