Streamstone

Streamstone

为Azure表存储提供事件溯源和ACID功能

Streamstone是一个轻量级库,用于在Azure表存储上构建事件溯源应用。它提供简洁的API,支持ACID事务、并发控制和重复事件检测。兼容.NET Standard 2.0和.NET Framework 4.6,支持多租户设计和分片。Streamstone为开发者提供工具,以在云存储上实现事件驱动系统,无需额外服务器。

Streamstone事件溯源Azure表存储ACID并发控制Github开源项目
<p align="center"> <img src="https://yellow-cdn.veclightyear.com/2b54e442/5d04cbbb-1b93-4253-84d0-e573b2c8ced1.png?raw=true" alt="Streamstone的标志"/> </p>

Streamstone是一个小型的嵌入式库,旨在基于Azure表存储构建可扩展的事件溯源应用程序。它具有简单的函数式风格API,深受Greg Young的事件存储的启发。

特性

  • 完全符合ACID
  • 支持乐观并发控制
  • 重复事件检测(基于身份)
  • 自动续传写入和读取(超过WATS限制)
  • 可查询的自定义流和事件属性
  • 同步(内联)投影和快照
  • 支持内联投影的变更跟踪
  • 适合多租户设计
  • 分片支持(一致性哈希)
  • 兼容.NET Standard 2.0和.NET Framework 4.6

通过NuGet安装 NuGet

要通过NuGet安装Streamstone,请在NuGet包管理器控制台中运行以下命令:

PM> Install-Package Streamstone

从源代码构建 构建状态

要在Windows上构建Streamstone二进制文件,你需要安装Visual Studio 17 Update 3或更高版本以及.NET Core SDK 2.0或更高版本。要在Linux上构建二进制文件,请使用dotnet cli工具(即dotnet build)。

运行单元测试

Windows/Linux/MacOs

使用Azurite npm包来运行测试和示例应用,以模拟表存储服务。

警告:Azurite不能完全模拟Azure表存储功能,因此某些测试可能会失败。

注意:或者,你可以通过将存储帐户连接字符串设置为Streamstone-Test-Storage用户级环境变量来针对真实的Azure运行。

设计

Streamstone只是Windows Azure表存储之上的一个薄层(库,而非服务器)。它实现了处理事件流的底层机制,所有繁重的工作都由底层提供程序完成。

API是无状态的,所有暴露的对象在完全构造后都是不可变的。Streamstone不规定负载序列化协议,因此你可以自由选择任何你想要的协议。

乐观并发控制通过始终在每次写入时包含流头实体来实现,这使得在没有最新Etag的情况下无法向流追加内容。重复事件检测是通过自动为每个事件创建附加实体来完成的,其RowKey值设置为源事件的唯一标识符(一致的二级索引)。

架构

<a href="https://yellow-cdn.veclightyear.com/2b54e442/e90ce7da-9fc7-4b57-bbb6-5acf39167b4f.png" target="_blank" title="点击查看全尺寸"><img src="https://yellow-cdn.veclightyear.com/2b54e442/e90ce7da-9fc7-4b57-bbb6-5acf39167b4f.png" alt="架构" style="max-width:100%;"/></a>


<a href="https://yellow-cdn.veclightyear.com/2b54e442/24e495a4-0177-4dbe-8330-2fd642bb362d.png" target="_blank" title="点击查看全尺寸"><img src="https://yellow-cdn.veclightyear.com/2b54e442/24e495a4-0177-4dbe-8330-2fd642bb362d.png" alt="虚拟分区的架构" style="max-width:100%;"/></a>

使用

基础
应用
演示
  • 使用Streamstone的Greg Young经典CQRS演示 [仓库]
  • 在有状态应用中使用Streamstone。Project Orleans的事件溯源actors [查看]

限制

虽然Streamstone允许你向Stream.Write传递任意数量的事件,但Azure表存储施加的最大批处理大小限制为100个实体,因此:

  • 每99个事件(100 - 1个头实体)将自动刷新批处理
  • 每49个设置了id的事件(100/2 - 1个头实体)将自动刷新批处理
  • 当尝试写入一个事件,其包含的内容超过最大批处理大小限制时,你将收到InvalidOperationException
  • 未考虑事件负载的实际字节大小,因此下面列出的所有限制仍然适用

Azure表存储API的其他限制:

  • 批处理的最大大小为4MB
  • 实体的最大大小为1MB
  • 属性的最大大小为64Kb
  • 属性名称的最大长度为255个字符
  • 一个实体最多可以有255个自定义属性

MSDN上的WATS限制

社区

Gitter

许可证

MIT许可证

编辑推荐精选

扣子-AI办公

扣子-AI办公

职场AI,就用扣子

AI办公助手,复杂任务高效处理。办公效率低?扣子空间AI助手支持播客生成、PPT制作、网页开发及报告写作,覆盖科研、商业、舆情等领域的专家Agent 7x24小时响应,生活工作无缝切换,提升50%效率!

堆友

堆友

多风格AI绘画神器

堆友平台由阿里巴巴设计团队创建,作为一款AI驱动的设计工具,专为设计师提供一站式增长服务。功能覆盖海量3D素材、AI绘画、实时渲染以及专业抠图,显著提升设计品质和效率。平台不仅提供工具,还是一个促进创意交流和个人发展的空间,界面友好,适合所有级别的设计师和创意工作者。

图像生成AI工具AI反应堆AI工具箱AI绘画GOAI艺术字堆友相机AI图像热门
码上飞

码上飞

零代码AI应用开发平台

零代码AI应用开发平台,用户只需一句话简单描述需求,AI能自动生成小程序、APP或H5网页应用,无需编写代码。

Vora

Vora

免费创建高清无水印Sora视频

Vora是一个免费创建高清无水印Sora视频的AI工具

Refly.AI

Refly.AI

最适合小白的AI自动化工作流平台

无需编码,轻松生成可复用、可变现的AI自动化工作流

酷表ChatExcel

酷表ChatExcel

大模型驱动的Excel数据处理工具

基于大模型交互的表格处理系统,允许用户通过对话方式完成数据整理和可视化分析。系统采用机器学习算法解析用户指令,自动执行排序、公式计算和数据透视等操作,支持多种文件格式导入导出。数据处理响应速度保持在0.8秒以内,支持超过100万行数据的即时分析。

AI工具酷表ChatExcelAI智能客服AI营销产品使用教程
TRAE编程

TRAE编程

AI辅助编程,代码自动修复

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
AIWritePaper论文写作

AIWritePaper论文写作

AI论文写作指导平台

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

AI辅助写作AI工具AI论文工具论文写作智能生成大纲数据安全AI助手热门
博��思AIPPT

博思AIPPT

AI一键生成PPT,就用博思AIPPT!

博思AIPPT,新一代的AI生成PPT平台,支持智能生成PPT、AI美化PPT、文本&链接生成PPT、导入Word/PDF/Markdown文档生成PPT等,内置海量精美PPT模板,涵盖商务、教育、科技等不同风格,同时针对每个页面提供多种版式,一键自适应切换,完美适配各种办公场景。

AI办公办公工具AI工具博思AIPPTAI生成PPT智能排版海量精品模板AI创作热门
潮际好麦

潮际好麦

AI赋能电商视觉革命,一站式智能商拍平台

潮际好麦深耕服装行业,是国内AI试衣效果最好的软件。使用先进AIGC能力为电商卖家批量提供优质的、低成本的商拍图。合作品牌有Shein、Lazada、安踏、百丽等65个国内外头部品牌,以及国内10万+淘宝、天猫、京东等主流平台的品牌商家,为卖家节省将近85%的出图成本,提升约3倍出图效率,让品牌能够快速上架。

下拉加载更多