🔥A cross-language distributed transaction manager. Support xa, tcc, saga, transactional messages. 跨语言分布式事务管理器
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
yedf2 daa20fd976 dashboard changed to admin 4 years ago
.github/workflows goreleaser => v1.7.0 4 years ago
admin dashboard changed to admin 4 years ago
charts fix helm deployment mount configMap name 4 years ago
dashboard dashboard change to admin 4 years ago
dtmcli feat: DBConf增加DB配置 4 years ago
dtmgrpc rename Ctx => Context 4 years ago
dtmsvr embed init ok 4 years ago
dtmutil fix lint: Json => JSON 4 years ago
helper update readme 4 years ago
qs qs simplified 4 years ago
sqls update url length in sql 4 years ago
test embed init ok 4 years ago
.gitignore spring clould merged from dtf 4 years ago
.golangci.yml test lint fixed 4 years ago
LICENSE update readme 4 years ago
README.md update readme 4 years ago
conf.sample.yml update sample yml 4 years ago
go.mod update gozero driver 4 years ago
go.sum update gozero driver 4 years ago
main.go dashboard change to admin 4 years ago

README.md

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

简体中文 | English

跨语言分布式事务管理器

DTM是一款变革性的分布式事务框架,提供了傻瓜式的使用方式,极大的降低了分布式事务的使用门槛,改变了“能不用分布式事务就不用”的行业现状,优雅的解决了服务间的数据一致性问题。

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

Tencent 腾讯

Bytedance 字节

Ivydad 常青藤爸爸

更多

特性

  • 支持多种语言:支持Go、Java、PHP、C#、Python、Nodejs 各种语言的SDK
  • 支持多种事务模式:SAGA、TCC、XA、二阶段消息(本地消息表,事务消息)
  • 支持多种数据库事务:Mysql、Redis、MongoDB、Postgres、TDSQL等
  • 支持多种存储引擎:Mysql(常用)、Redis(高性能)、MongoDB(规划中)
  • 支持多种微服务架构:go-zero、go-kratos/kratos、polarismesh/polaris
  • 支持高可用,易水平扩展

应用场景:

DTM 可以应用于大量的场景下的数据一致性问题,以下是几个常见场景

与Seata对比

特性 DTM SEATA 备注
支持语言 Go、c#、Java、python、php... Java dtm可轻松接入一门新语言
异常处理 子事务屏障自动处理 手动处理 dtm解决了幂等、悬挂、空补偿
SAGA事务 极简易用 复杂状态机
二阶段消息 最简消息最终一致性架构
TCC事务
XA事务
AT事务 建议使用XA AT与XA类似,但有脏回滚
单服务多数据源

从上面对比的各项特性来看,dtm在具备很多优势。详细的对比可以点击特性中的链接,跳到相关文档

性能测试报告

教程与文档

各语言客户端及示例

快速开始

如果您不是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+"/TransOutCom"
    Add(qsBusi+"/TransOut", qsBusi+"/TransOutCom", req).
    // 添加一个TransIn的子事务,正向操作为url: qsBusi+"/TransIn", 补偿操作为url: qsBusi+"/TransInCom"
    Add(qsBusi+"/TransIn", qsBusi+"/TransInCom", 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

联系我们

微信交流群

如果您希望更快的获得反馈,或者更多的了解其他用户在使用过程中的各种反馈,欢迎加入我们的微信交流群

请加作者的微信 yedf2008 好友或者扫码加好友,备注 dtm 按照指引进群

yedf2008

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