Skip to content

Latest commit

 

History

History
150 lines (110 loc) · 8.33 KB

README-cn.md

File metadata and controls

150 lines (110 loc) · 8.33 KB
Raw

license Build Status codecov Go Report Card Go Reference Mentioned in Awesome Go

English Docs

跨语言分布式事务管理器

DTM是一款变革性的分布式事务框架，提供了傻瓜式的使用方式，极大的降低了分布式事务的使用门槛，改变了“能不用分布式事务就不用”的行业现状。 dtm 的应用范围非常广，可以应用于以下常见的领域：

他优雅的解决了幂等、空补偿、悬挂等分布式事务难题，提供跨语言，跨存储引擎组合事务的强大功能：

谁在使用DTM(仅列出部分)

Tencent 腾讯

Ivydad 常青藤爸爸

Eglass 视咖镜小二

极欧科技

亮点

  • 极易接入
    • 零配置启动服务，提供非常简单的HTTP接口，极大降低上手分布式事务的难度，新手也能快速接入
  • 跨语言
    • 可适合多语言栈的公司使用。方便go、python、php、nodejs、ruby、c# 各类语言使用。
  • 使用简单
    • 开发者不再担心悬挂、空补偿、幂等各类问题，首创子事务屏障技术代为处理
  • 易部署、易扩展
    • 依赖mysql|redis，部署简单，易集群化，易水平扩展
  • 多种分布式事务协议支持
    • TCC、SAGA、XA、二阶段消息，一站式解决所有分布式事务问题

与其他框架对比

非Java语言类的，暂未看到除dtm之外的成熟框架，因此这里将DTM和Java中最成熟的Seata对比：

特性 DTM SEATA 备注
支持语言 Go、c#、Java、python、php... Java dtm可轻松接入一门新语言
存储引擎 支持数据库、Redis、Mongo等 数据库
异常处理 子事务屏障自动处理 手动处理 dtm解决了幂等、悬挂、空补偿
SAGA事务 极简易用 复杂状态机
二阶段消息 ✓ ✗ 最简消息最终一致性架构
TCC事务 ✓ ✓
XA事务 ✓ ✓
AT事务 建议使用XA ✓ AT与XA类似，但有脏回滚
单服务多数据源 ✓ ✗
通信协议 HTTP、gRPC、go-zero dubbo等协议 dtm对云原生更加友好
star数量 github stars github stars dtm从20210604发布0.1，发展快

从上面对比的特性来看，dtm在许多方面都具备很大的优势。如果考虑多语言支持、多存储引擎支持，那么dtm毫无疑问是您的首选

详细的对比可以点击特性中的链接，跳到相关文档

性能测试报告

教程与文档

各语言客户端及示例

微服务框架支持

  • go-zero：一开源就非常火爆的微服务框架，首家接入dtm的微服务框架。感谢go-zero作者kevwan的大力支持
  • polaris: 腾讯开源的注册发现组件，以及在其上构建的微服务框架。感谢腾讯同学ychensha的PR
  • 其他：看用户需求量，择机接入，参见微服务支持

快速开始

如果您不是Go语言，可以跳转各语言客户端及示例，里面有相关的快速开始示例

运行dtm

git clone https://github.com/dtm-labs/dtm && cd dtm
go run main.go

启动并运行一个saga示例

下面运行一个类似跨行转账的示例，包括两个事务分支：资金转出（TransOut)、资金转入（TransIn)。DTM保证TransIn和TransOut要么全部成功，要么全部回滚，保证最终金额的正确性。

git clone https://github.com/dtm-labs/dtmcli-go-sample && cd dtmcli-go-sample
go run main.go

接入详解

接入代码

  // 具体业务微服务地址
  const qsBusi = "http://localhost:8081/api/busi_saga"
  req := &gin.H{"amount": 30} // 微服务的载荷
  // DtmServer为DTM服务的地址，是一个url
  DtmServer := "http://localhost:36789/api/dtmsvr"
  saga := dtmcli.NewSaga(DtmServer, dtmcli.MustGenGid(DtmServer)).
    // 添加一个TransOut的子事务，正向操作为url: qsBusi+"/TransOut"， 补偿操作为url: qsBusi+"/TransOutCompensate"
    Add(qsBusi+"/TransOut", qsBusi+"/TransOutCompensate", req).
    // 添加一个TransIn的子事务，正向操作为url: qsBusi+"/TransIn"， 补偿操作为url: qsBusi+"/TransInCompensate"
    Add(qsBusi+"/TransIn", qsBusi+"/TransInCompensate", req)
  // 提交saga事务，dtm会完成所有的子事务/回滚所有的子事务
  err := saga.Submit()

成功运行后，可以看到TransOut、TransIn依次被调用，完成了整个分布式事务

时序图

上述saga分布式事务的时序图如下：

失败情况

在实际的业务中，子事务可能出现失败，例如转入的子账号被冻结导致转账失败。我们对业务代码进行修改，让TransIn的正向操作失败，然后看看结果

	app.POST(qsBusiAPI+"/TransIn", func(c *gin.Context) {
		logger.Infof("TransIn")
		c.JSON(409, "") // Status 409 表示失败，不再重试，直接回滚
	})

再运行这个例子，整个事务最终失败，时序图如下：

在转入操作失败的情况下，TransIn和TransOut的补偿操作被执行，保证了最终的余额和转账前是一样的。

更多示例

参考dtm-labs/dtm-examples

联系我们

公众号

dtm官方公众号：分布式事务，大量干货分享，以及dtm的最新消息

交流群

请加 yedf2008 好友或者扫码加好友，验证回复 dtm 按照指引进群

yedf2008

github

作者github: https://github.com/yedf2

欢迎使用dtm，或者通过dtm学习实践分布式事务相关知识，欢迎star支持我们