README-cn.md

简体中文 | English

跨语言分布式事务管理器

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

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

Tencent 腾讯

Bytedance 字节

Ivydad 常青藤爸爸

更多

如果贵公司也已使用 dtm，欢迎在 登记地址 登记，仅仅为了推广，不做其它用途。

特性

• 支持多种语言：支持Go、Java、PHP、C#、Python、Nodejs 各种语言的SDK
• 支持多种事务模式：SAGA、TCC、XA
• 支持消息最终一致性：二阶段消息，比本地消息表更优雅的方案
• 未支持 AT 事务模式，建议使用XA，详情参见XA vs AT
• 支持多种数据库事务：Mysql、Redis、MongoDB、Postgres、TDSQL等
• 支持多种存储引擎：Mysql（常用）、Redis（高性能）、MongoDB（规划中）
• 支持多种微服务架构：go-zero、go-kratos/kratos、polarismesh/polaris
• 支持高可用，易水平扩展

应用场景：

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

• 缓存管理：彻底保证缓存最终一致及强一致
• 秒杀扣库存：极端情况下，也能保证Redis中精准的库存，和最终创建的订单完全一致，无需手动调整
• 非单体的订单系统： 大幅简化架构
• 事件发布/订阅：更好的发件箱模式

性能测试报告

教程与文档

各语言客户端及示例

快速开始

如果您不是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, shortuuid.New()).
    // 添加一个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的补偿操作被执行，保证了最终的余额和转账前是一样的。

更多示例

关于更多quick start的例子，可以参考 dtm-labs/quick-start-sample

上述示例主要演示了分布式事务的流程，更多的内容，包括如何与实际的数据库对接，如何做补偿，如何做回滚等实际的例子，请参考dtm-labs/dtm-examples

联系我们

微信交流群

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

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

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