go-zero学习 第六章 分布式事务dtm_gozero分布式事务

1 参考文档

  1. Go开源说第十七期 分布式事务DTM
  2. DTM开源项目文档:官方文档
  3. 分布式事务解决方案:7种常见解决方案汇总
  • msg:二阶段消息,适合不需要回滚的全局事务。
  • saga:适合需要支持回滚的全局事务。
  • tcc:适合一致性要求较高的全局事务。
  • xa:适合性能要求不高,没有行锁争抢的全局事务。

2 官方示例

参考:https://github.com/dtm-labs/dtm/blob/main/helper/README-cn.md

以下步骤均是按参考实操的。

  1. 运行dtm服务器(可以观察事务执行情况)

运行示例前,必须首先运行dtm服务器。

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

  1. 启动并运行一个saga示例

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

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

  1. dtmcli-go-sample 中的具体代码
package main

import (
	"fmt"
	"log"
	"time"

	"github.com/dtm-labs/dtmcli"
	"github.com/gin-gonic/gin"
)

// 事务参与者的服务地址
const qsBusiAPI = "/api/busi\_start"
const qsBusiPort = 8082

var qsBusi = fmt.Sprintf("http://localhost:%d%s", qsBusiPort, qsBusiAPI)

func main() {
	QsStartSvr()
	\_ = QsFireRequest()
	select {}
}

// QsStartSvr quick start: start server
func QsStartSvr() {
	app := gin.New()
	qsAddRoute(app)
	log.Printf("quick start examples listening at %d", qsBusiPort)
	go func() {
		\_ = app.Run(fmt.Sprintf(":%d", qsBusiPort))
	}()
	time.Sleep(100 \* time.Millisecond)
}

func qsAddRoute(app \*gin.Engine) {
	app.POST(qsBusiAPI+"/TransIn", func(c \*gin.Context) {
		log.Printf("TransIn")
		c.JSON(200, "")
		// c.JSON(409, "") // Status 409 for Failure. Won't be retried
	})
	app.POST(qsBusiAPI+"/TransInCompensate", func(c \*gin.Context) {
		log.Printf("TransInCompensate")
		c.JSON(200, "")
	})
	app.POST(qsBusiAPI+"/TransOut", func(c \*gin.Context) {
		log.Printf("TransOut")
		c.JSON(200, "")
	})
	app.POST(qsBusiAPI+"/TransOutCompensate", func(c \*gin.Context) {
		log.Printf("TransOutCompensate")
		c.JSON(200, "")
	})
}

const dtmServer = "http://localhost:36789/api/dtmsvr"

// QsFireRequest quick start: fire request
func QsFireRequest() string {
	req := &gin.H{"amount": 30} // 微服务的载荷
	// DtmServer为DTM服务的地址
	saga := dtmcli.NewSaga(dtmServer, dtmcli.MustGenGid(dtmServer)).
		// 添加一个TransOut的子事务,正向操作为url: qsBusi+"/TransOut", 逆向操作为url: qsBusi+"/TransOutCompensate"
		Add(qsBusi+"/TransOut", qsBusi+"/TransOutCompensate", req).
		// 添加一个TransIn的子事务,正向操作为url: qsBusi+"/TransOut", 逆向操作为url: qsBusi+"/TransInCompensate"
		Add(qsBusi+"/TransIn", qsBusi+"/TransInCompensate", req)
	// 提交saga事务,dtm会完成所有的子事务/回滚所有的子事务
	err := saga.Submit()

	if err != nil {
		panic(err)
	}
	log.Printf("transaction: %s submitted", saga.Gid)
	return saga.Gid
}

  1. 失败情况
    在实际的业务中,子事务可能出现失败,例如转入的子账号被冻结导致转账失败。我们对业务代码进行修改,让TransIn的正向操作失败,然后看看结果:
	app.POST(qsBusiAPI+"/TransIn", func(c \*gin.Context) {
		logger.Infof("TransIn")
		c.JSON(409, "") // Status 409 表示失败,不再重试,直接回滚
	})

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

3 go-zero使用dtm参考代码

3.1 go-zero支持dtm 代码操作步骤

参考:go-zero支持dtm:官方讲解+代码

注意:这里只是从调用方角度展示了如何使用dtm的代码,而关于被调用方的代码缺失,需要结合3.2 gozerodtm 代码操作步骤

  1. 启动Etcd,查看所有key命令:etcdctl.exe get --prefix ""
  2. dtm clone下来
  3. 找到dtm项目根文件夹下的conf.sample.yml,复制一份名称改为conf.yml
  4. conf.yml中的下面这段注释放开:
MicroService: # gRPC/HTTP based microservice config
   Driver: 'dtm-driver-gozero' # name of the driver to handle register/discover
   Target: 'etcd://localhost:2379/dtmservice' # register dtm server to this url
   EndPoint: 'localhost:36790'

  • MicroService:这个不要动,这个代表要对把dtm注册到那个微服务服务集群里面去,使微服务集群内部服务可以通过grpc直接跟dtm交互
  • Driver'dtm-driver-gozero', 使用go-zero的注册服务发现驱动,支持go-zero
  • Target: 'etcd://localhost:2379/dtmservice'将当前dtmserver直接注册到微服务所在的etcd集群中,如果go-zero作为微服务使用的话,就可以直接通过etcd拿到dtmserver grpc链接,直接就可以跟dtm server交互了。
  • EndPoint: 'localhost:36790' , 代表的是dtmserver的连接地址+端口 , 集群中的微服务可以直接通过etcd获得此地址跟dtm交互了,如果你自己去改了dtm源码grpc端口,记得这里要改下端口。
  1. 启动dtm
# 前提:配置好conf.yml
go run main.go -c conf.yml

如果是用Goland启动,则需要将 -c conf.yml作为参数填写到Program arguments中。

  1. 运行一个go-zero的服务
git clone https://github.com/dtm-labs/dtmdriver-clients && cd dtmdriver-clients
cd gozero/trans && go run trans.go

  1. 发起一个go-zero使用dtm的事务
# 在dtmdriver-clients的目录下
cd gozero/app && go run main.go

  1. trans的日志中看到记录信息,就是事务正常完成了
2023/07/24 21:45:47 transfer out 30 cents from 1
2023/07/24 21:45:47 transfer in 30 cents to 2   
2023/07/24 21:45:47 transfer out 30 cents from 1
2023/07/24 21:45:47 transfer out 30 cents from 1

※3.2 gozerodtm 代码操作步骤

参考:gozerodtm:Mikaelemmmm代码

项目介绍:

  • order-apihttp服务入口。
  • order-srv是订单的rpc服务,与dtm-gozero-order数据库中order表交互。
  • stock-srv是库存的rpc服务,与dtm-gozero-stock数据库中stock表交互。

整体流程:
http调用order-api中立即下单接口,然后order-api立即下单接口会去调用order-srv创建订单并且调用stock-srv扣减库存,因为order-srvstock-srv是2个独立grpc服务,所以使用dtm来做分布式事务协调。

前5步与3.1完全一致。

  1. 创建数据库表
    在项目的datasql目录下分别有:order-srv服务的dtm-gozero-order.sqlstock-srv服务的dtm-gozero-stock.sql,在数据库按照创建两个数据库并执行相关sql
  2. 修改数据库连接配置
    分别修改 order-srvstock-srv服务的yaml中的数据库连接配置。
  3. 修改启动类读取配置文件的路径
    分别修改order-apiorder-srvstock-srv中读取yaml配置的路径。
  4. 启动服务
    依次启动order-srvstock-srvorder-api服务
  5. 请求测试
    使用POSTMAN测试:
    请求地址:http://localhost:8889/order/quickCreate
    请求方式:POST
    数据格式:JSON
    请求数据:{"userId":2,"goodsId":1,"num":20}
  6. 测试结果
    HTTP请求响应成功,状态是200,但是查看DTM服务发现,操作失败,且数据库中数据未改变。
    原因排查:
    依次查看order-apiorder-srvstock-srv服务后,发现在order-srv服务有报错,主要报错信息:
{"level":"error","ts":"2023-07-25T14:08:24.891+0800","caller":"dtmimp/utils.go:207","msg":"used: 0 ms exec error: Error 1146: Table 'dtm\_barrier.barrier' doesn't exist for insert i
gnore into dtm_barrier.barrier(trans_type, gid, branch_id, op, barrier_id, reason) values(?,?,?,?,?,?)

推断是缺少dtm_barrier数据库以及barrier数据表。

  1. 创建dtm_barrier数据库以及barrier数据表
/\*
 Navicat Premium Data Transfer

 Source Server : 本机
 Source Server Type : MySQL
 Source Server Version : 50737
 Source Host : 127.0.0.1:3357
 Source Schema : dtm\_barrier

 Target Server Type : MySQL
 Target Server Version : 50737
 File Encoding : 65001

 Date: 25/07/2023 14:06:43
\*/

SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;

-- ----------------------------
-- Table structure for barrier
-- ----------------------------
DROP TABLE IF EXISTS `barrier`;
CREATE TABLE `barrier`  (
  `id` bigint(20) NOT NULL AUTO\_INCREMENT COMMENT 'ID',
  `trans\_type` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL,
  `gid` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL,
  `branch\_id` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL,
  `op` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL,
  `barrier\_id` bigint(20) NULL DEFAULT NULL,
  `reason` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL,
  `create\_time` datetime(0) NULL DEFAULT CURRENT\_TIMESTAMP(0) ON UPDATE CURRENT\_TIMESTAMP(0),
  PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO\_INCREMENT = 1 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci COMMENT = 'dtm子屏障数据表' ROW_FORMAT = DYNAMIC;

SET FOREIGN_KEY_CHECKS = 1;

  1. 重新请求测试
    HTTP请求响应成功,状态是200,DTM服务中状态显示操作成功,且数据库中数据改变。

4 注意事项

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值