GTS云服务下线迁移方案

迁移方案

由于GTS可支持多类型数据库、分库分表和跨服务的分布式事务解决方案，请根据下述几种场景选择对应的迁移方案。

• 分库分表事务

PolarDB-X (DRDS) 5.2及以下版本与GTS产品集成用于解决分库分表事务问题。升级PolarDB-X(DRDS) 版本至5.3及以上版本或PolarDB-X 2.0版本，可消除对GTS服务的依赖。

按照如下方法，判断 PolarDB-X(DRDS)是否开启了GTS云服务，若未开启GTS云服务请忽略升级操作。

连接DRDS-Server，GTS按照库粒度开启，在对应数据库中执行以下SQL。

set autocomit=false;
select last_txc_xid();
commit;
set autocomit=tue;

若执行select last_txc_xid();返回信息中包含8091，则可以判定已使用GTS来解决PolarDB-X (DRDS)分库分表事务。

若在业务中还涉及到跨服务的分布式事务，请参考下一节中的处理方案。

• 跨服务事务

如何判断业务侧是否使用了GTS跨服务事务场景？

1. 搜索@TxcTransaction注解。在业务代码侧全文搜索该注解，若存在，说明业务中使用到了GTS；若不存在，继续第2步。

2. 搜索TxcDataSourceAPI。在业务代码侧全文搜索是否有引用该类，若存在，说明业务中使用到了GTS；若不存在，继续第3步。

3. 搜索txc-client依赖。根据业务侧所使用的不同依赖包管理工具Maven或Gradle，在pom.xml或build.gradle搜索com.taobao.txc:txc-client包依赖。若存在，说明业务中使用到了GTS；若不存在，说明未使用GTS服务。

针对此场景的GTS使用，推荐迁移至开源Seata，仅需要少量的代码改造成本。

Seata于2019年1月正式开源，提供了涵盖多种事务模式的一站式分布式事务解决方案，符合未来技术演进的方向。

目前 Seata 提供了丰富 RPC框架和数据库支持。

RPC框架：Alibaba Dubbo、Apache Dubbo、Apache bRPC、Spring Cloud、gRPC、EDAS HSF、Motan、sofa-RPC、http-jakarta。

数据库：MySQL、PostgreSQL、Oracle、阿里云RDS 、SQLServer、TiDB for MySQL、Oceanbase for MySQL、PolarDB-X 2.0（开发中）。

若已使用GTS云服务，但RPC框架和数据库不在上述列表中，请工单咨询。

由于目前开源Seata尚未提供对GTS完全的支持，因此业务侧需要参考下文完成GTS到开源Seata的开发适配。

依赖迁移

迁移前GTS依赖如下所示。

       <dependency>
            <groupId>com.taobao.txc</groupId>
            <artifactId>txc-client</artifactId>
            <version>${gts.sdk.version}</version>
        </dependency>
        <dependency>
            <groupId>com.taobao.txc</groupId>
            <artifactId>txc-client-springcloud</artifactId>
            <version>${gts.sdk.version}</version>
        </dependency>

迁移后Seata依赖如下所示。

        <dependency>
            <groupId>io.seata</groupId>
            <artifactId>seata-spring-boot-starter</artifactId>
            <version>${seata.version}</version>
        </dependency>

配置迁移

迁移前GTS配置如下。

spring.cloud.txc.txcAppName=sc_demo_business

# - txcServerGroup: spring.cloud.txc.txcServerGroup事务分组。
# txc_test_public.1129361738553704.QD 是公网测试的专用事务分组。
# 在阿里云环境运行时，请使用自己在官网开通的事务分组（GTS实例）。
spring.cloud.txc.txcServerGroup=default

# - mode: spring.cloud.txc.mode工作模式。
# AT=1，MT=2，不配置，则默认为1。
# spring.cloud.txc.mode=1

# - url: spring.cloud.txc.url服务发现地址。
# 本地公网测试的服务发现地址，配置如下。
# 在阿里云环境运行时，有默认地址，请删除该配置。
# spring.cloud.txc.url=https://test-cs-gts.aliyuncs.com

# 下面两个配置对应TxcTransactionScaner的accessKey/secretKey两个属性。
# 在阿里云环境运行时，请配置拥有spring.cloud.txc.txcServerGroup指定的事务分组（GTS实例）运行权限的用户的AK/SK。
# 本地公网测试不需要该配置。
#spring.cloud.txc.accessKey=xxxxxxxxx's AK
#spring.cloud.txc.secretKey=xxxxxxxxx's SK

迁移后Seata配置如下所示。

请根据实际业务需要搭建Seata需要的注册配置中心，目前Seata支持主流的注册配置中心如Nacos、Eureka、Zookeeper等，推荐使用开源 Nacos 或 MSE Nacos云产品。以下配置以Nacos为例。

seata.application-id=sc_demo_business
seata.tx-service-group=default
seata.registry.type=nacos
seata.registry.nacos.server-addr=localhost:8848
seata.registry.nacos.group=SEATA_GROUP
seata.config.type=nacos
seata.config.nacos.server-addr=localhost:8848
seata.config.nacos.group=SEATA_GROUP

API迁移

此部分将适配如何改造业务中使用的GTS API 到 Seata API。一般来说业务使用GTS API 只需要一行注解即可，但对于复杂和更精细的事务场景GTS也提供了底层API。

常用API映射如下表所示。

GTS中存在AT和TCC事务模式，可根据下述方法迁移至Seata的AT和TCC事务模式。

AT事务模式

AT模式是通过代理数据源来完成JDBC的增强，如下表所示。

GTS使用代理数据源需要业务手动组装，方法如下所示。

@Bean
    @ConfigurationProperties(prefix = "spring.datasource")
    public DruidDataSource dataSource() {
        DruidDataSource druidDataSource = new DruidDataSource();
        return druidDataSource;
    }

    @Bean("dataSourceProxy")
    public TxcDataSource dataSourceProxy(DruidDataSource dataSource) {
        return new TxcDataSource(dataSource);
    }

切换到Seata后，具体会分为3种用法，3种用法任选其一即可。

• 仅依赖seata-all，将上述代码中的TxcDataSource替换为DatasourceProxy。

• 仅依赖seata-all，去掉dataSourceProxy的bean逻辑，加入@EnableAutoDataSourceProxy注解。

• 依赖seata-spring-boot-starter，去掉dataSourceProxy的bean逻辑， seata-spring-boot-starter会将Datasource接口自动代理为DatasourceProxy，无需额外处理。

TCC事务模式

TCC模式仅支持注解方式使用，API映射关系如下表所示。