从Oracle迁移到TDSQL如何做兼容性评估？这份指南帮你轻松搞定

一、为什么要做兼容性评估？  

近年来，在国产化替代政策的推动下，越来越多的企业开始探索将Oracle等国外数据库替换为国产分布式数据库。腾讯云TDSQL凭借其高兼容性、金融级高可用和弹性扩展能力，成为热门选择。

但迁移前，如何快速评估现有系统与TDSQL的兼容性？需要改动多少代码？迁移后的稳定性如何？这些问题直接关系迁移成本与风险。  

TDSQL迁移工具（TMT）应运而生！它支持自动化扫描Oracle数据库对象及SQL语法，识别潜在兼容性问题，并生成可视化报告，为迁移提供可靠依据。  

兼容性评估的核心价值：

1、提前识别95%以上的语法差异

2、量化迁移工作量，预估改造成本

二、TMT工具的核心功能  

TMT评估方式：  

1、通过连接源端获取元数据评估，程序通过Oracle和TDSQL语法树差异，得到对象兼容分析结果。

2、扫描应用程序的配置文件或SQL文件、表。

TMT评估特点：

1、不依赖目标库是否存在，内置语法规则。

2、评估使用语法树解析，可以根据目标库不同版本进行评估，评估结果真实、可靠。

无论哪种方式，均无需提前创建目标库，工具自动生成评估报告。

工具亮点：

✅ 零侵入性：无需在目标库提前建表，直接连接Oracle即可评估

✅ 灵活输入：支持数据库直连、SQL文件扫描、MyBatis配置文件解析

✅ 版本覆盖：目标端适配TDSQL-PG和TDSQL-MySQL两大引擎

三、如何使用TMT工具？  

1. 环境准备  

运行环境：JDK 1.8及以上版本。  

账号权限：需在Oracle数据库中创建一个评估账号，并授权以下权限：  

2. 配置文件修改  

打开`init.json`文件，重点修改以下参数；

完成后，工具会生成一个包含HTML报告的ZIP文件，用户可直观查看兼容性结果。  

四、评估报告示例  

报告将清晰展示以下内容：  

• 兼容性统计：兼容对象比例、需修改的SQL语句数量。  
  

• 问题详情：不兼容的语法（如Oracle特有函数、保留关键字冲突）、SQL解析失败原因。  

五、常见问题与解决  

问题一：评估结果为0

检查几个地方：

1、确认是否配置了评估用户。参数：usersEvaluationList

2、检查是否使用了中文的引号“”，要改成英文的""

3、dbName 对应要写oracle上的 service name

问题二、java.sql.SQLSyntaxErrorException: ORA-00942: 表或视图不存在

确认账号权限是否正确授权。

对应进行授权：

#授予权限

grant connect to 评估用户;

grant select any dictionary to 评估用户;

grant select_catalog_role to 评估用户;

grant execute on dbms_metadata to 评估用户;

问题三：SQL解析失败

检查SQL语法是否符合规范（如缺少AND连接条件、字段未用逗号分隔）。

问题四：路径报错（Windows环境下执行）

使用反斜杠`\`或双引号包裹路径，例如：`"C:\\tmt\\config"`

六、如何获取TMT工具？  

点击「阅读全文」下载最新版本：TDSQL迁移工具TMT

七、总结  

通过TMT工具，企业可快速识别Oracle到TDSQL的迁移难点，降低改造成本。

建议在正式迁移前，优先完成兼容性评估，并根据报告制定适配计划。