首先,我们需要知道我们要使用哪个版本的seata,这就要查看spring-cloud-alibaba版本说明,找到我们对应的seata。
spring-cloud-alibaba版本说明: 地址链接
seata下载地址:https://github.com/apache/incubator-seata/releases
找到我们想要安装版本的seata,下载对应的压缩包,然后进行解压
我下载的是seata1.5.2版本
Seata Server 目录中包含以下子目录:
配置事务存储模式
默认情况下,seata使用的是file模式进行数据持久化,如果我们想使用数据库进行数据存储,那么需要修改我们的store.mode参数
conf目录下application.example.yml为配置模板文件,application.yml是实际配置文件
将seata.store.mode修改成db,如何添加上db的相关配置
seata:
config:
# support: nacos, consul, apollo, zk, etcd3
type: file
registry:
# support: nacos, eureka, redis, zk, consul, etcd3, sofa
type: file
store:
# support: file 、 db 、 redis
mode: db
db:
datasource: druid
db-type: mysql
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://127.0.0.1:3306/seata?rewriteBatchedStatements=true
user: mysql
password: mysql
min-conn: 5
max-conn: 100
global-table: global_table
branch-table: branch_table
lock-table: lock_table
distributed-lock-table: distributed_lock
query-limit: 100
max-wait: 5000
导入数据表
配置了mysql数据库,那么就要在mysql数据库上建立对应的seata数据库,并导入seata准备的数据表。
sql脚本在\script\server\db下,根据我们的数据库选择对应的sql脚本,因为我是mysql数据库,所以使用mysql.sql脚本
脚本内容如下:
-- -------------------------------- The script used when storeMode is 'db' --------------------------------
-- the table to store GlobalSession data
CREATE TABLE IF NOT EXISTS `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_status_gmt_modified` (`status` , `gmt_modified`),
KEY `idx_transaction_id` (`transaction_id`)
) ENGINE = InnoDB
DEFAULT CHARSET = utf8mb4;
-- the table to store BranchSession data
CREATE TABLE IF NOT EXISTS `branch_table`
(
`branch_id` BIGINT NOT NULL,
`xid` VARCHAR(128) NOT NULL,
`transaction_id` BIGINT,
`resource_group_id` VARCHAR(32),
`resource_id` VARCHAR(256),
`branch_type` VARCHAR(8),
`status` TINYINT,
`client_id` VARCHAR(64),
`application_data` VARCHAR(2000),
`gmt_create` DATETIME(6),
`gmt_modified` DATETIME(6),
PRIMARY KEY (`branch_id`),
KEY `idx_xid` (`xid`)
) ENGINE = InnoDB
DEFAULT CHARSET = utf8mb4;
-- the table to store lock data
CREATE TABLE IF NOT EXISTS `lock_table`
(
`row_key` VARCHAR(128) NOT NULL,
`xid` VARCHAR(128),
`transaction_id` BIGINT,
`branch_id` BIGINT NOT NULL,
`resource_id` VARCHAR(256),
`table_name` VARCHAR(32),
`pk` VARCHAR(36),
`status` TINYINT NOT NULL DEFAULT '0' COMMENT '0:locked ,1:rollbacking',
`gmt_create` DATETIME,
`gmt_modified` DATETIME,
PRIMARY KEY (`row_key`),
KEY `idx_status` (`status`),
KEY `idx_branch_id` (`branch_id`),
KEY `idx_xid_and_branch_id` (`xid` , `branch_id`)
) ENGINE = InnoDB
DEFAULT CHARSET = utf8mb4;
CREATE TABLE IF NOT EXISTS `distributed_lock`
(
`lock_key` CHAR(20) NOT NULL,
`lock_value` VARCHAR(20) NOT NULL,
`expire` BIGINT,
primary key (`lock_key`)
) ENGINE = InnoDB
DEFAULT CHARSET = utf8mb4;
INSERT INTO `distributed_lock` (lock_key, lock_value, expire) VALUES ('AsyncCommitting', ' ', 0);
INSERT INTO `distributed_lock` (lock_key, lock_value, expire) VALUES ('RetryCommitting', ' ', 0);
INSERT INTO `distributed_lock` (lock_key, lock_value, expire) VALUES ('RetryRollbacking', ' ', 0);
INSERT INTO `distributed_lock` (lock_key, lock_value, expire) VALUES ('TxTimeoutCheck', ' ', 0);
主要是生成四个表,下面我介绍下这四个表
xid:全局事务 ID。
transaction_id:全局事务的事务 ID。
status:全局事务的状态,包括:Begin(开始)、Committing(提交中)、Rollbacking(回滚中)、TimeoutRollbacking(超时回滚中)和 TimeoutRollbackRetrying(超时回滚重试中)。
application_id:应用程序 ID。
transaction_service_group:事务组名称。
transaction_name:事务名称。
timeout:事务超时时间。
begin_time:事务开始时间。
application_data:应用程序自定义数据。
gmt_create::创建时间。
gmt_modified: 修改时间。
xid:全局事务 ID。
transaction_id:分支事务的事务 ID。
resource_group_id:资源组 ID。
resource_id:资源 ID。
branch_type:分支事务类型,包括:AT(原子性事务)和 TCC(柔性事务)。
status:分支事务的状态,包括:Registered(已注册)、Committing(提交中)、Aborting(中止中)和 RollbackRetryFailed(回滚失败)。
client_id:客户端ID。
application_data:应用程序数据。
gmt_create:分支事务创建时间。
gmt_modified:分支事务最后修改时间。
row_key: 锁定的数据行键值。
xid: 全局事务ID。
transaction_id: 分支事务ID。
branch_id: 分支事务标识。
resource_id: 数据库资源标识符。
table_name: 被锁定的实际业务表名。
pk: 主键列及其对应的值。
status:锁状态
gmt_create: 创建时间。
gmt_modified: 修改时间。
lock_key: 锁的键,用于标识唯一资源。
lock_value: 锁的值,可以是任何用于区分不同锁持有者的标记。
expire: 锁的有效期或过期时间。
配置配置中心和注册中心
通过模板配置其实可以看到seata支持很多注册中心的配置使用。
下面是模板配置,我们只需要修改type为我们想要的类型,如何添加对应的配置即可
seata:
config:
# support: nacos 、 consul 、 apollo 、 zk 、 etcd3
type: file
nacos:
server-addr: 127.0.0.1:8848
namespace:
group: SEATA_GROUP
username:
password:
##if use MSE Nacos with auth, mutex with username/password attribute
#access-key: ""
#secret-key: ""
data-id: seataServer.properties
consul:
server-addr: 127.0.0.1:8500
acl-token:
key: seata.properties
apollo:
appId: seata-server
apollo-meta: http://192.168.1.204:8801
apollo-config-service: http://192.168.1.204:8080
namespace: application
apollo-access-key-secret:
cluster: seata
zk:
server-addr: 127.0.0.1:2181
session-timeout: 6000
connect-timeout: 2000
username:
password:
node-path: /seata/seata.properties
etcd3:
server-addr: http://localhost:2379
key: seata.properties
registry:
# support: nacos 、 eureka 、 redis 、 zk 、 consul 、 etcd3 、 sofa
type: file
preferred-networks: 30.240.*
nacos:
application: seata-server
server-addr: 127.0.0.1:8848
group: SEATA_GROUP
namespace:
cluster: default
username:
password:
##if use MSE Nacos with auth, mutex with username/password attribute
#access-key: ""
#secret-key: ""
eureka:
service-url: http://localhost:8761/eureka
application: default
weight: 1
redis:
server-addr: localhost:6379
db: 0
password:
cluster: default
timeout: 0
zk:
cluster: default
server-addr: 127.0.0.1:2181
session-timeout: 6000
connect-timeout: 2000
username: ""
password: ""
consul:
cluster: default
server-addr: 127.0.0.1:8500
acl-token:
etcd3:
cluster: default
server-addr: http://localhost:2379
我使用的是nacos,下面是我的配置部分
seata:
config:
# support: nacos, consul, apollo, zk, etcd3
type: nacos
nacos:
server-addr: 127.0.0.1:8848
namespace:
group: SEATA_GROUP
username:
password:
data-id: seataServer.properties
registry:
# support: nacos, eureka, redis, zk, consul, etcd3, sofa
type: nacos
preferred-networks: 30.240.*
nacos:
application: seata-server
server-addr: 127.0.0.1:8848
group: SEATA_GROUP
namespace:
cluster: default
username:
password:
然后我们去nacos创建 seataServer.properties ,注意 namespace 、 group 、data-id 和上述 application.yml 配置中心的配置 保持一致,内容参照 详细配置链接 中配置按需配即可
详细配置模板:https://gitee.com/seata-io/seata/blob/v1.5.1/script/config-center/config.txt
我主要配置了以下三个属性
#配置事务分组
service.vgroupMapping.default_tx_group=default
service.enableDegrade=false
service.disableGlobalTransaction=false
解释:
service.vgroupMapping.default_tx_group=default
vgroupMapping 用于映射事务分组(Transaction Group)到 Seata Server 集群中的某个服务组。
default_tx_group 是你在应用中定义的一个事务分组名称,它将与 Seata Server 中的服务组 default 进行关联。这意味着当应用中指定这个事务分组时,会连接到名为 default 的 Seata Server 组。
service.enableDegrade=false
enableDegrade 参数用于设置是否开启降级模式。
当设置为 false 时,表示不启用降级模式。在分布式事务处理过程中,如果 Seata Server 不可用或出现故障,系统不会自动切换到非事务或者本地事务的方式执行,而是保持原有的事务行为。
service.disableGlobalTransaction=false
disableGlobalTransaction 参数用来控制全局事务功能的开关。
当设置为 false 时,Seata 全局事务功能是开启状态,也就是说,在你的应用中使用 Seata 时可以正常进行分布式事务管理。
事务分组如何找到后端Seata集群?
应用程序(客户端)会通过用户配置的配置中心去寻找service.vgroupMapping .[事务分组配置项],取得配置项的值就是TC集群的名称。若应用程序是SpringBoot则通过seata.service.vgroup-mapping.事务分组名=集群名称 配置
拿到集群名称程序通过一定的前后缀+集群名称去构造服务名,各配置中心的服务名实现不同(前提是Seata-Server已经完成服务注册,且Seata-Server向注册中心报告cluster名与应用程序(客户端)配置的集群名称一致)
拿到服务名去相应的注册中心去拉取相应服务名的服务列表,获得后端真实的TC服务列表(即Seata-Server集群节点列表)
因为我们配置的注册中心为Nacos,所以需要先启动Nacos后然后启动seate服务,执行bin目录下的seata-server脚本即可启动
访问管理页面
http://ip:7091/
用户名密码就是 application.yml中配置的: seata/seata (可以配置修改)