写点什么

Seata 搭建与分布式事务入门

用户头像
码农参上
关注
发布于: 1 小时前

在单体架构下,我们大多使用的是单体数据库,通过数据库的 ACID 特性支持,实现了本地事务。但是在微服务架构下复杂的业务关系中,分布式事务是不可避免的问题之一。Seata 是 Spring Cloud Alibaba 分布式事务解决方案中间件,解决了微服务场景下面临的分布式事务问题。本文介绍如何通过搭建 Seata 环境,并通过其 AT 模式,实现分布式事务。


本文中使用的环境版本:


nacos-server-1.3.1seata-server-1.4.0spring-cloud Hoxton.SR3spring-cloud-alibaba 2.2.1.RELEASE

1、Seata 服务安装包下载

下载 seata-server-1.4.0:https://github.com/seata/seata/releases/tag/v1.4.0同时下载 seata-server-0.0.9,需要其中的配置文件和脚本:https://github.com/seata/seata/releases/tag/v0.9.0

2、Seata 服务配置

在 conf 目录下,先把配置文件备份后再进行更改


  • 修改 file.conf,mode 选择数据库模式,并配置数据库连接信息


  ## store mode: file、db、redis  mode = "db"  ## database store property  db {    ## the implement of javax.sql.DataSource, such as DruidDataSource(druid)/BasicDataSource(dbcp)/HikariDataSource(hikari) etc.    datasource = "druid"    ## mysql/oracle/postgresql/h2/oceanbase etc.    dbType = "mysql"    driverClassName = "com.mysql.jdbc.Driver"    url = "jdbc:mysql://127.0.0.1:3306/seata"    user = "hydra"    password = "123456"    minConn = 5    maxConn = 100    globalTable = "global_table"    branchTable = "branch_table"    lockTable = "lock_table"    queryLimit = 100    maxWait = 5000  }
复制代码


  • 修改 registry.conf,使用 nacos 作为注册和配置中心。可以在 nacos 中创建一个命名空间,把生成的命名空间的值拷过来


  registry {  # file 、nacos 、eureka、redis、zk、consul、etcd3、sofa  type = "nacos"      nacos {    application = "seata-server"    serverAddr = "127.0.0.1:8848"    group = "SEATA_GROUP"    namespace = "202274f4-218e-42bf-9251-e996df6340f8"    cluster = "default"    username = "nacos"    password = "nacos"  }      config {  # file、nacos 、apollo、zk、consul、etcd3  type = "nacos"
nacos { serverAddr = "127.0.0.1:8848" namespace = "202274f4-218e-42bf-9251-e996df6340f8" group = "SEATA_GROUP" username = "nacos" password = "nacos" }
复制代码
3、导入 Seate 参数配置到 nacos 配置中心

首先,把 seata-server-0.9 的 nacos-config.txt 和 nacos-config.sh 脚本拷贝到 1.4 版本的 seata/conf 下。我们需要把 nacos-config.txt 的参数通过脚本 nacos-config.sh 导入到 nacos 配置中心,之后微服务项目也从 nacos 配置中心读取配置。这样就不用像老版本那样,需要把两个配置文件拷到微服务项目的 resourcce 目录下了。


修改 nacos-config.txt,首先修改数据库配置:


store.mode=dbstore.db.url=jdbc:mysql://127.0.0.1:3306/seata?useUnicode=truestore.db.user=hydrastore.db.password=123456
复制代码


0.9 中的参数格式还是使用横线模式,在 1.4 中规范有所变动,需要把横线变成驼峰,启动需要改动的参数有:


store.db.db-type=mysqlstore.db.driver-class-name=com.mysql.jdbc.Driver
复制代码


需要改成驼峰:


store.db.dbType=mysqlstore.db.driverClassName=com.mysql.jdbc.Driver
复制代码


并且,如果使用的是 mysql8.0 以上的版本,需要改一下驱动的名称。


其他参数的具体意义可以查看官方文档: https://seata.io/zh-cn/docs/user/configurations.html,并按照上面的规则进行修改。额外需要注意参数的参数是: service.vgroup_mapping


service.vgroup_mapping.my_test_tx_group=default
复制代码


官方解释为事务群组,具体使用多少个事务群体没有明确指出。但通过查看文档和部分开源项目发现,大多都采用将 key 值设置为服务端的服务名,有多少个微服务就添加多少行。在接下来的 demo 中要使用两个微服务作为示例,因此添加:


service.vgroupMapping.order-service-group=defaultservice.vgroupMapping.stock-service-group=default
复制代码


使用 gitbash 运行 nacos-config.sh 脚本,参数是 nacos 的 ip:


sh nacos-config.sh 127.0.0.1
复制代码


这样执行完成后参数默认是存在 nacos config 的 public 命名空间下,可以在 nacos 创建一个 seata 的命名空间,把所有参数拷贝过去,方便进行区分。

4、建表

在 seata 数据库中新建表branch_table, global_table, lock_table,在业务数据库中新建表undo_log,用于回滚,这些脚本在 seata-server-0.9 中也可以直接找到。


-- the table to store GlobalSession datadrop table if exists `global_table`;create table `global_table` (  `xid` varchar(128)  not null,  `transaction_id` bigint,  `status` tinyint not null,  `application_id` varchar(32),  `transaction_service_group` varchar(32),  `transaction_name` varchar(128),  `timeout` int,  `begin_time` bigint,  `application_data` varchar(2000),  `gmt_create` datetime,  `gmt_modified` datetime,  primary key (`xid`),  key `idx_gmt_modified_status` (`gmt_modified`, `status`),  key `idx_transaction_id` (`transaction_id`)); -- the table to store BranchSession datadrop table if exists `branch_table`;create table `branch_table` (  `branch_id` bigint not null,  `xid` varchar(128) not null,  `transaction_id` bigint ,  `resource_group_id` varchar(32),  `resource_id` varchar(256) ,  `lock_key` varchar(128) ,  `branch_type` varchar(8) ,  `status` tinyint,  `client_id` varchar(64),  `application_data` varchar(2000),  `gmt_create` datetime,  `gmt_modified` datetime,  primary key (`branch_id`),  key `idx_xid` (`xid`)); -- the table to store lock datadrop table if exists `lock_table`;create table `lock_table` (  `row_key` varchar(128) not null,  `xid` varchar(96),  `transaction_id` long ,  `branch_id` long,  `resource_id` varchar(256) ,  `table_name` varchar(32) ,  `pk` varchar(36) ,  `gmt_create` datetime ,  `gmt_modified` datetime,  primary key(`row_key`)); -- the table to store seata xid data-- 0.7.0+ add context-- you must to init this sql for you business databese. the seata server not need it.-- 此脚本必须初始化在你当前的业务数据库中,用于AT 模式XID记录。与server端无关(注:业务数据库)-- 注意此处0.3.0+ 增加唯一索引 ux_undo_logdrop table `undo_log`;CREATE TABLE `undo_log` (  `id` bigint(20) NOT NULL AUTO_INCREMENT,  `branch_id` bigint(20) NOT NULL,  `xid` varchar(100) NOT NULL,  `context` varchar(128) NOT NULL,  `rollback_info` longblob NOT NULL,  `log_status` int(11) NOT NULL,  `log_created` datetime NOT NULL,  `log_modified` datetime NOT NULL,  `ext` varchar(100) DEFAULT NULL,  PRIMARY KEY (`id`),  UNIQUE KEY `ux_undo_log` (`xid`,`branch_id`)) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;
复制代码
5、启动

在启动 nacos-server 后,点击 seata/bin/seata-server.bat启动 seata。

6、微服务改造
  • 在微服务中引入 seata 的依赖:


<dependency>    <groupId>io.seata</groupId>    <artifactId>seata-spring-boot-starter</artifactId>    <version>1.3.0</version></dependency><dependency>    <groupId>com.alibaba.cloud</groupId>    <artifactId>spring-cloud-starter-alibaba-seata</artifactId>    <exclusions>        <exclusion>            <groupId>io.seata</groupId>            <artifactId>seata-spring-boot-starter</artifactId>        </exclusion>    </exclusions></dependency>
复制代码


如果微服务中使用的是 druid 连接池,可以把已有的 druid 依赖删除,在 seata-spring-boot-starter-1.3.0 中已经引入了 druid-1.1.12。


  • 修改每一个微服务 yml,主要是配置 nacos 和 seata,tx-service-group 就是 nacos-config.txt 中 service.vgroupMapping 的 key,我们这里使用微服务的名称加上 group 后缀


server:  port: 8763
spring: application: name: order-service cloud: nacos: server-addr: 127.0.0.1:8848 datasource: url: jdbc:mysql://localhost:3306/tenant?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC username: hydra password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver type: com.alibaba.druid.pool.DruidDataSource druid: initial-size: 8 min-idle: 1 max-active: 10 max-wait: 60000
seata: enabled: true application-id: ${spring.application.name} tx-service-group: ${spring.application.name}-group enable-auto-data-source-proxy: true config: type: nacos nacos: server-addr: 127.0.0.1:8848 namespace: 202274f4-218e-42bf-9251-e996df6340f8 group: SEATA_GROUP username: nacos password: nacos registry: type: nacos nacos: application: seata-server server-addr: 127.0.0.1:8848 namespace: 202274f4-218e-42bf-9251-e996df6340f8 group: SEATA_GROUP username: nacos password: nacos# service:# vgroupMapping:# order-service-group: default
mybatis-plus: mapper-locations: classpath:mapper/*Mapper.xml type-aliases-package: com.cn.nacos.consumer.entity
复制代码


  • 配置 seata 的数据库代理,在使用 mybatis-plus 时的配置方式如下:


@Configurationpublic class DataSourceProxyConfig {    @Bean    public SqlSessionFactory sqlSessionFactoryBean(DataSource dataSource) throws Exception {        // 订单服务中引入了mybatis-plus,所以要使用特殊的SqlSessionFactoryBean        MybatisSqlSessionFactoryBean sqlSessionFactoryBean = new MybatisSqlSessionFactoryBean();        // 代理数据源        sqlSessionFactoryBean.setDataSource(new DataSourceProxy(dataSource));        // 生成SqlSessionFactory        return sqlSessionFactoryBean.getObject();    }}
复制代码


  • 调用测试,OrderService 调用 StockService 为例,在被调用的 service 方法上加上@Transactional注解


StockService 提供接口:


@Servicepublic class StockService {    @Autowired    private StockMapper stockMapper;
@Transactional public String reduce(){ System.out.println("减库存");
Stock stock = stockMapper.selectOne(new LambdaQueryWrapper<Stock>().eq(Stock::getId, 1)); System.out.println(stock.toString());
stock.setQuantity(stock.getQuantity()-1); int result = stockMapper.updateById(stock); System.out.println("update result: "+result);
if (result==1){ throw new RuntimeException("异常测试,准备rollBack"); } return "stock reduce success"; }}
复制代码


OrderService 调用 StockService 的服务,使用了 FeignClient 调用 StockService,并在发起事务的方法上加上@GlobalTransactional注解:


@Servicepublic class OrderService {    @Autowired    private OrderMapper orderMapper;
@Autowired private StockClient stockClient;
@GlobalTransactional public String buy(){ Order order=new Order(); order.setId(1L).setMoney(20D); int result = orderMapper.insert(order);
if (result==1){ System.out.println("插入订单成功"); } return stockClient.reduce(); }}
复制代码


调用 OrderService 的接口,会在 StockService 中抛出异常,reduce 方法中的本地事务先执行回滚。再查看日志,在 order 表上执行了回滚操作:



在上面的日志中,打印出了全局事务的 xid、分支的 branchId、以及 seata 使用的模式,在使用 AT 模式的二阶段提交完成后,显示回滚状态为回滚完成。查看业务数据库的 und_log 表,已经插入了回滚记录:



这样,就以 Seata 中默认的 AT 模式实现了分布式事务。在该模式下,可以应对大多数的业务场景,并且基本可以做到无业务入侵,对于程序员来说,只需要添加注解,不需要做其他的业务功能改造,就可以以无感知的方式就可以实现分布式事务的解决。


如果文章对您有所帮助,欢迎关注公众号 码农参上

发布于: 1 小时前阅读数: 2
用户头像

码农参上

关注

公众号:码农参上 2021.03.30 加入

还未添加个人简介

评论

发布
暂无评论
Seata搭建与分布式事务入门