seata参数配置 1.4.2版本

查看1.0.0版本
查看0.9.0.1之前版本

变更记录

  1. 20200716(1.3.0):
  2. 1.增加了store.redis相关配置
  3. 2.增加了nacos注册中心配置group项,ServerClient端的值需一致
  4. 20200421(1.2.0):
  5. 1.增加registry.nacos.application属性,默认seata-serverServerClient端的值需一致
  6. 20200220(1.1.0):
  7. 1.file.confregistry.conf两个配置文件中的格式统一转换为驼峰格式.
  8. 2.统一所有配置文件的默认值(file.confregistry.confseata-spring-boot-starter)
  9. 3.优化seata-spring-boot-starter中对于事务分组和TC集群的配置
  10. 4.移除client.support.spring.datasource.autoproxy,增加@EnableAutoDataSourceProxy
  11. 注解用于开启数据源自动代理,同时可选择代理实现方式(具体请查阅附录5)
  12. 20191221:
  13. 1.增加seata.enabledclient.report.success.enable
  14. transport.enable-client-batch-send-requestclient.log.exceptionRate

关注属性(详细描述见全属性)

server端client端
registry.typeregistry.type
config.typeconfig.type
#store.mode=db需要以下配置service.vgroupMapping.my_test_tx_group
store.db.driverClassNameservice.default.grouplist
store.db.urlservice.disableGlobalTransaction
store.db.user
store.db.password
#store.mode=redis 需要以下配置
store.redis.host
store.redis.port
store.redis.database
store.redis.password

全属性

公共部分

keydescremark
transport.serializationclient和server通信编解码方式seata(ByteBuf)、protobuf、kryo、hession、fst,默认seata
transport.compressorclient和server通信数据压缩方式none、gzip,默认none
transport.heartbeatclient和server通信心跳检测开关默认true开启
registry.type注册中心类型默认file,支持file 、nacos 、eureka、redis、zk、consul、etcd3、sofa、custom
config.type配置中心类型默认file,支持file、nacos 、apollo、zk、consul、etcd3、custom

server端

keydescremark
server.undo.logSaveDaysundo保留天数默认7天,log_status=1(附录3)和未正常清理的undo
server.undo.logDeletePeriodundo清理线程间隔时间默认86400000,单位毫秒
server.maxCommitRetryTimeout二阶段提交重试超时时长单位ms,s,m,h,d,对应毫秒,秒,分,小时,天,默认毫秒。默认值-1表示无限重试。公式: timeout>=now-globalTransactionBeginTime,true表示超时则不再重试(注: 达到超时时间后将不会做任何重试,有数据不一致风险,除非业务自行可校准数据,否者慎用)
server.maxRollbackRetryTimeout二阶段回滚重试超时时长同commit
server.recovery.committingRetryPeriod二阶段提交未完成状态全局事务重试提交线程间隔时间默认1000,单位毫秒
server.recovery.asynCommittingRetryPeriod二阶段异步提交状态重试提交线程间隔时间默认1000,单位毫秒
server.recovery.rollbackingRetryPeriod二阶段回滚状态重试回滚线程间隔时间默认1000,单位毫秒
server.recovery.timeoutRetryPeriod超时状态检测重试线程间隔时间默认1000,单位毫秒,检测出超时将全局事务置入回滚会话管理器
store.mode事务会话信息存储方式file本地文件(不支持HA),db数据库|redis(支持HA)
store.file.dirfile模式文件存储文件夹名默认sessionStore
store.db.datasourcedb模式数据源类型dbcp、druid、hikari;无默认值,store.mode=db时必须指定。
store.db.dbTypedb模式数据库类型mysql、oracle、db2、sqlserver、sybaee、h2、sqlite、access、postgresql、oceanbase;无默认值,store.mode=db时必须指定。
store.db.driverClassNamedb模式数据库驱动store.mode=db时必须指定
store.db.urldb模式数据库urlstore.mode=db时必须指定,在使用mysql作为数据源时,建议在连接参数中加上rewriteBatchedStatements=true(详细原因请阅读附录7)
store.db.userdb模式数据库账户store.mode=db时必须指定
store.db.passworddb模式数据库账户密码store.mode=db时必须指定
store.db.minConndb模式数据库初始连接数默认1
store.db.maxConndb模式数据库最大连接数默认20
store.db.maxWaitdb模式获取连接时最大等待时间默认5000,单位毫秒
store.db.globalTabledb模式全局事务表名默认global_table
store.db.branchTabledb模式分支事务表名默认branch_table
store.db.lockTabledb模式全局锁表名默认lock_table
store.db.queryLimitdb模式查询全局事务一次的最大条数默认100
store.redis.hostredis模式ip默认127.0.0.1
store.redis.portredis模式端口默认6379
store.redis.maxConnredis模式最大连接数默认10
store.redis.minConnredis模式最小连接数默认1
store.redis.databaseredis模式默认库默认0
store.redis.passwordredis模式密码(无可不填)默认null
store.redis.queryLimitredis模式一次查询最大条数默认100
metrics.enabled是否启用Metrics默认false关闭,在False状态下,所有与Metrics相关的组件将不会被初始化,使得性能损耗最低
metrics.registryType指标注册器类型Metrics使用的指标注册器类型,默认为内置的compact(简易)实现,这个实现中的Meter仅使用有限内存计数,性能高足够满足大多数场景;目前只能设置一个指标注册器实现
metrics.exporterList指标结果Measurement数据输出器列表默认prometheus,多个输出器使用英文逗号分割,例如”prometheus,jmx”,目前仅实现了对接prometheus的输出器
metrics.exporterPrometheusPortprometheus输出器Client端口号默认9898

client端

keydescremark
seata.enabled是否开启spring-boot自动装配true、false,(SSBS)专有配置,默认true(附录4)
seata.enableAutoDataSourceProxy=true是否开启数据源自动代理true、false,seata-spring-boot-starter(SSBS)专有配置,SSBS默认会开启数据源自动代理,可通过该配置项关闭.
seata.useJdkProxy=false是否使用JDK代理作为数据源自动代理的实现方式true、false,(SSBS)专有配置,默认false,采用CGLIB作为数据源自动代理的实现方式
transport.enableClientBatchSendRequest客户端事务消息请求是否批量合并发送默认true,false单条发送
client.log.exceptionRate日志异常输出概率默认100,目前用于undo回滚失败时异常堆栈输出,百分之一的概率输出,回滚失败基本是脏数据,无需输出堆栈占用硬盘空间
service.vgroupMapping.my_test_tx_group事务群组(附录1)my_test_tx_group为分组,配置项值为TC集群名
service.default.grouplistTC服务列表(附录2)仅注册中心为file时使用
service.disableGlobalTransaction全局事务开关默认false。false为开启,true为关闭
client.tm.degradeCheck降级开关默认false。业务侧根据连续错误数自动降级不走seata事务(详细介绍请阅读附录6)
client.tm.degradeCheckAllowTimes升降级达标阈值默认10
client.tm.degradeCheckPeriod服务自检周期默认2000,单位ms.每2秒进行一次服务自检,来决定
client.rm.reportSuccessEnable是否上报一阶段成功true、false,从1.1.0版本开始,默认false.true用于保持分支事务生命周期记录完整,false可提高不少性能
client.rm.asyncCommitBufferLimit异步提交缓存队列长度默认10000。 二阶段提交成功,RM异步清理undo队列
client.rm.lock.retryInterval校验或占用全局锁重试间隔默认10,单位毫秒
client.rm.lock.retryTimes校验或占用全局锁重试次数默认30
client.rm.lock.retryPolicyBranchRollbackOnConflict分支事务与其它全局回滚事务冲突时锁策略默认true,优先释放本地锁让回滚成功
client.rm.reportRetryCount一阶段结果上报TC重试次数默认5次
client.rm.tableMetaCheckEnable自动刷新缓存中的表结构默认false
client.tm.commitRetryCount一阶段全局提交结果上报TC重试次数默认1次,建议大于1
client.tm.rollbackRetryCount一阶段全局回滚结果上报TC重试次数默认1次,建议大于1
client.undo.dataValidation二阶段回滚镜像校验默认true开启,false关闭
client.undo.logSerializationundo序列化方式默认jackson
client.undo.logTable自定义undo表名默认undo_log
client.undo.onlyCareUpdateColumns只生成被更新列的镜像默认true
client.rm.sqlParserTypesql解析类型默认druid,可选antlr

参数同步到配置中心使用demo

Nacos

shell:

  1. sh ${SEATAPATH}/script/config-center/nacos/nacos-config.sh -h localhost -p 8848 -g SEATA_GROUP -t 5a3c7d6c-f497-4d68-a71a-2e5e3340b3ca

参数说明:

-h: host,默认值 localhost

-p: port,默认值 8848

-g: 配置分组,默认值为 ‘SEATA_GROUP’

-t: 租户信息,对应 Nacos 的命名空间ID字段, 默认值为空 ‘’

Apollo

  1. sh ${SEATAPATH}/script/config-center/apollo/apollo-config.sh -h localhost -p 8070 -e DEV -a seata-server -c default -n application -d apollo -r apollo -t 3aa026fc8435d0fc4505b345b8fa4578fb646a2c

参数说明:

-h: host,默认值 localhost

-p: port,默认值 8070

-e: 所管理的配置环境,默认值 DEV

-a: Namespace 所属的 AppId,默认值 seata-server

-c: 所管理的配置集群名, 一般情况下传入 default 即可。如果是特殊集群,传入相应集群的名称即可,默认值 default

-n: 所管理的 Namespace 的名称,如果是非 properties 格式,需要加上后缀名,如 sample.yml,默认值 application

-d: item 的创建人,格式为域账号,也就是 sso 系统的 User ID

-r: 发布人,域账号,注意:如果 ApolloConfigDB.ServerConfig 中的 namespace.lock.switch 设置为 true 的话(默认是 false),那么该环境不允许发布人和编辑人为同一人。所以如果编辑人是 zhangsan,发布人就不能再是 zhangsan。

-t: Apollo 管理员在 http://{portal\_address}/open/manage.html 创建第三方应用,创建之前最好先查询此AppId是否已经创建。创建成功之后会生成一个 token

以上参数说明详情请看:

https://github.com/ctripcorp/apollo/wiki/Apollo开放平台

Consul

  1. sh ${SEATAPATH}/script/config-center/consul/consul-config.sh -h localhost -p 8500

参数说明:

-h: host,默认值 localhost

-p: port,默认值 8500

Etcd3

  1. sh ${SEATAPATH}/script/config-center/etcd3/etcd3-config.sh -h localhost -p 2379

参数说明:

-h: host,默认值 localhost

-p: port,默认值 2379

python:

  1. python ${SEATAPATH}/script/config-center/nacos/nacos-config.py localhost:8848

ZK

  1. sh ${SEATAPATH}/script/config-center/zk/zk-config.sh -h localhost -p 2181 -z "/Users/zhangchenghui/zookeeper-3.4.14"

参数说明:

-h: host,默认值 localhost

-p: port,默认值 2181

-z: zk所属路径

附录1:

  1. 事务分组说明。
  2. 1.事务分组是什么?
  3. 事务分组是seata的资源逻辑,类似于服务实例。在file.conf中的my_test_tx_group就是一个事务分组。
  4. 2.通过事务分组如何找到后端集群?
  5. 首先程序中配置了事务分组(GlobalTransactionScanner 构造方法的txServiceGroup参数),程序会通过用户配置的配置中心去寻找service.vgroupMapping
  6. .事务分组配置项,取得配置项的值就是TC集群的名称。拿到集群名称程序通过一定的前后缀+集群名称去构造服务名,各配置中心的服务名实现不同。拿到服务名去相应的注册中心去拉取相应服务名的服务列表,获得后端真实的TC服务列表。
  7. 3.为什么这么设计,不直接取服务名?
  8. 这里多了一层获取事务分组到映射集群的配置。这样设计后,事务分组可以作为资源的逻辑隔离单位,当发生故障时可以快速failover

附录2:

  1. 关于grouplist问题说明下。
  2. 1. 什么时候会用到file.conf中的default.grouplist
  3. registry.type=file时会用到,其他时候不读。
  4. 2. default.grouplist的值列表是否可以配置多个?
  5. 可以配置多个,配置多个意味着集群,但当store.mode=file时,会报错。原因是在file存储模式下未提供本地文件的同步,所以需要使用store.mode=db,通过db来共享TC集群间数据
  6. 3. 是否推荐使用default.grouplist
  7. 不推荐,如问题1,当registry.type=file时会用到,也就是说这里用的不是真正的注册中心,不具体服务的健康检查机制当tc不可用时无法自动剔除列表,推荐使用nacos eurekarediszkconsuletcd3sofaregistry.type=fileconfig.type=file 设计的初衷是让用户再不依赖第三方注册中心或配置中心的前提下,通过直连的方式,快速验证seata服务。
  8. 4.seata-spring-boot-starter中的配置为什么是grouplist.default,也就是说和file.conf中的default.grouplist写法刚好颠倒了位置?
  9. 由于spring-boot本身配置文件语法的要求,这个地方需要将file.conf中的default.grouplist写成grouplist.default,效果是一样的.

附录3:

  1. log_status=1的是防御性的,是收到全局回滚请求,但是不确定某个事务分支的本地事务是否已经执行完成了,这时事先插入一条branchid相同的数据,插入的假数据成功了,本地事务继续执行就会报唯一索引冲突自动回滚。
  2. 假如插入不成功说明表里有数据这个本地事务已经执行完成了,那么取出这条undolog数据做反向回滚操作。

附录4:

  1. 是否开启spring-boot自动装配,如果开启,则会自动配置seataspring-boot的集成,包括数据源的自动代理以及GlobalTransactionScanner初始化。
  2. 注:1.0版本新特性,需依赖seata-spring-boot-starter

附录5:

  1. seata1.1.0版本新加入以下注解,用于开启数据源自动代理功能
  2. @EnableAutoDataSourceProxy
attributedescremark
useJdkProxy是否使用JDK代理作为数据源自动代理的实现方式false、true,默认false,采用CGLIB作为数据源自动代理的实现方式
  1. 1.对于使用seata-spring-boot-starter的方式,默认已开启数据源自动代理,如需关闭,请配置seata.enableAutoDataSourceProxy=false,该项配置默认为true
  2. 如需切换代理实现方式,请通过seata.useJdkProxy=false进行配置,默认为false,采用CGLIB作为数据源自动代理的实现方式。
  3. 2.对于使用seata-all的方式,请使用@EnableAutoDataSourceProxy来显式开启数据源自动代理功能。如有需要,可通过该注解的useJdkProxy属性进行代理实现方式
  4. 的切换。默认为false,采用CGLIB作为数据源自动代理的实现方式。

附录6:

  1. 关于服务自动降级策略的具体实现介绍:
  2. 首先通过读取client.tm.degradeCheck是否为true,决定是否开启自检线程.随后读取degradeCheckAllowTimesdegradeCheckPeriod,确认阈值与自检周期.
  3. 假设degradeCheckAllowTimes=10,degradeCheckPeriod=2000
  4. 那么每2秒钟会进行一个begin,commit的测试,如果失败,则记录连续失败数,如果成功则清空连续失败数.连续错误由用户接口及自检线程进行累计,直到连续失败次数达到用户的阈值,则关闭Seata分布式事务,避免用户自身业务长时间不可用.
  5. 反之,假如当前分布式事务关闭,那么自检线程继续按照2秒一次的自检,直到连续成功数达到用户设置的阈值,那么Seata分布式事务将恢复使用

附录7:

  1. store.mode=db,由于seata是通过jdbcexecuteBatch来批量插入全局锁的,根据MySQL官网的说明,连接参数中的rewriteBatchedStatementstrue时,在执行executeBatch,并且操作类型为insert时,jdbc驱动会把对应的SQL优化成`insert into () values (), ()`的形式来提升批量插入的性能。
  2. 根据实际的测试,该参数设置为true后,对应的批量插入性能为原来的10倍多,因此在数据源为MySQL时,建议把该参数设置为true