本文汇总了 KDTS 迁移工具的常见问题及解决方法，包括启动时的 Java 堆内存溢出（可通过调整启动脚本内存配置或清理缓存解决）、Windows 下闪退（需检查 JDK 版本、运行权限及端口占用等）、数据迁移中的文件签名不被认可（修改配置文件参数）、模式创建语法错误（移除数据库配置中的特定关键字）等问题。同时涵盖对象名称大小写转换、GIS 非法数据处理、默认值与类型映射错误的解决办法，以及性能优化方向和 WEB 版本默认密码等实用信息，为 KDTS 用户提供全面的故障排查参考。
前言
中电科金仓（北京）科技股份有限公司（以下简称“电科金仓”）成立于1999年，是成立最早的拥有自主知识产权的国产数据库企业，也是中国电子科技集团（CETC）成员企业。电科金仓以“提供卓越的数据库产品助力企业级应用高质量发展”为使命，致力于“成为世界卓越的数据库产品与服务提供商”。
电科金仓自成立起始终坚持自主创新，专注数据库领域二十余载，具备出色的数据库产品研发及服务能力，核心产品金仓数据库管理系统KingbaseES（简称“KES”）是面向全行业、全客户关键应用的企业级大型通用数据库。KES产品V9版本已通过国家权威机构认证，产品核心源代码自主率达到100%。2018年，电科金仓申报的“数据库管理系统核心技术的创新与金仓数据库产业化”项目荣获国家科学技术进步二等奖。金仓数据库管理系统KES于2022年入选国务院国资委发布的十项国有企业数字技术典型成果，彰显数据库领域国家队硬实力。继2023年金仓数据库管理系统V8通过第一批《安全可靠测评》后，2024年金仓数据库管理系统V9、金仓分布式HTAP数据库软件集群V3再度入围，至此电科金仓共计2款产品3个版本通过《安全可靠测评》*。
🥇 点击进入金仓数据库专栏，本专栏聚焦金仓数据库（KingbaseES）这一国产企业级融合数据库，为开发者及技术决策者提供从基础操作到架构设计的系统化学习路径。从多语法兼容（Oracle/MySQL/PostgreSQL）、多模数据存储（关系 / 文档 / 时序 / GIS）等功能展开讲解！
迁移程序启动报错：java.lang.OutOfMemoryError: Java heap space
解决方法：
- 修改启动脚本（bin/startup.bat或bin/startup.sh）中JAVA_MEMORY大小
- 如果内存有限，可以尝试执行以下方法：
- linux环境，如果缓存占用了大量内存空间，可以清理缓存，命令如下：
sync&&echo3>/proc/sys/vm/drop_caches2. <font style="color:rgb(28, 30, 33);">降低KDTS的线程数，以及队列长度，尤其是队列长度大于300的，均可以调整为300,，参考《使用指南》。此配置会降低迁移效率，减少内存溢出的可能性。</font>Windows 下启动迁移工具闪退
解决方法：
- 检查 JDK 目录下是否正确放置 JDK ，需要对应平台的jdk11版本；
- 使用管理员身份运行迁移工具；
- 将KDTS工具放到根目录下，防止目录过深导致启动异常，重启KDTS工具；
- 查看是否有端口占用，如有占用，可修改conf/application.properties下的http.port和server.port，并更换页面访问端口；
- 查看kdts根目录下是否已经存在PID，如果存在，且无法访问页面，需要删除此文件后重启KDTS。
数据迁移报错：文件签名不被认可
解决方法：修改配置文件(conf/application.properties)中的是否使用遗留二进制拷贝签名为 false (如果原来值为 false，则调整为true)
迁移时创建模式报错：syntax error at or near “AUTHORIZATION”
解决方法:检查数据库配置文件（data/kingbase.conf）中是否将 authorization 添加到 exclude_reserved_words 中，如果添加了，移除即可。
源端全大写对象名称迁移后变成全小写
此问题是因为KES无论是否大小写敏感都会将全大写的对象名称转换成全小写，此问题是KES的机制导致。
gis迁移报错：geometry requires more points
gis如数据如下图：
此gis数据中标识一条线，但只有一个点无法构成线，所以此数据为非法数据。非法数据无法保存到KES的gis数据中。 解决办法：修改源端此类错误数据，或者过滤数据，过滤掉该行的主键。
修改默认值映射
web版本，在安装目录下/conf/mapping_rule/default_value/下，根据源端目标端类型，选择对应的json文件配置，如果没有，可以cp一个json文件，名字改为对应的类型
json文件配置说明:
以常见的bit 类型default 值报错为例，原始表的default值为0或1，迁移到kes中会报错
错误: 字段 “XXXX” 类型是 bit, 但默认表达式类型是 integer
这种情况需要将default 0或1修改映射为’0’或’1’，json文件中的配置如下
类型映射错误
当存在源端类型迁移到目标库后类型不正确，且在KDTS迁移报告中显示的ddl也是不正确是，证明类型映射有问题，可以通过修改类型映射的方式进行修改，修改方式如下：
页面直接增加或修改相应的类型映射，如下图：
如果在配置类型映射时，未在下拉菜单中找到，可以直接数据类型名称，输入后店家下面的名称，或按回车进行确认，如下图：
性能优化
在定位到性能优化点之后，可以采取以下措施进行性能调优：
- 数据库参数优化
针对不同应用场景，调节相关内核参数以实现优化。例如：对于频繁访问大量数据的情况，建议增大shared_buffers参数值；在涉及临时文件写入的操作中，可适当调大work_mem参数。
上述内存相关参数见配置管理手册的资源消耗章节。
- SQL优化
可以考虑创建合适的索引、使用分区、通过HINT控制优化器使用最优的执行计划、使用并行等方式。
- 操作系统优化
考虑磁盘调度策略的优化、预读的优化以及启动磁盘写缓存策略等方式。
- 应用优化
考虑改写SQL语句、使用PBE缓存执行计划、错峰执行等情况。
- 硬件优化
扩展CPU、内存、存储、网络等硬件能力。
- 架构优化
使用缓存、读写分离、分库分表等架构来进行优化。
KDTS WEB版本默认密码
由于用户侧提出的安全考虑，增加了默认密码复杂度， 默认用户为：kingbase 默认密码为：Kb_DI@2019
登录后可自行修改密码，修改方式如下：
联系博主
xcLeigh 博主，全栈领域优质创作者，博客专家，目前，活跃在CSDN、微信公众号、小红书、知乎、掘金、快手、思否、微博、51CTO、B站、腾讯云开发者社区、阿里云开发者社区等平台，全网拥有几十万的粉丝，全网统一IP为xcLeigh。希望通过我的分享，让大家能在喜悦的情况下收获到有用的知识。主要分享编程、开发工具、算法、技术学习心得等内容。很多读者评价他的文章简洁易懂，尤其对于一些复杂的技术话题，他能通过通俗的语言来解释，帮助初学者更好地理解。博客通常也会涉及一些实践经验，项目分享以及解决实际开发中遇到的问题。如果你是开发领域的初学者，或者在学习一些新的编程语言或框架，关注他的文章对你有很大帮助。
亲爱的朋友，无论前路如何漫长与崎岖，都请怀揣梦想的火种，因为在生活的广袤星空中，总有一颗属于你的璀璨星辰在熠熠生辉，静候你抵达。
愿你在这纷繁世间，能时常收获微小而确定的幸福，如春日微风轻拂面庞，所有的疲惫与烦恼都能被温柔以待，内心永远充盈着安宁与慰藉。
至此，文章已至尾声，而您的故事仍在续写，不知您对文中所叙有何独特见解？期待您在心中与我对话，开启思想的新交流。
💞 关注博主 🌀 带你实现畅游前后端！
🥇 从零到一学习Python 🌀 带你玩转Python技术流！
🏆 人工智能学习合集 🌀 搭配实例教程与实战案例，帮你构建完整 AI 知识体系
💦注：本文撰写于CSDN平台,作者：xcLeigh（所有权归作者所有），https://xcleigh.blog.csdn.net/，如果相关下载没有跳转，请查看这个地址，相关链接没有跳转，皆是抄袭本文，转载请备注本文原地址。
📣 亲，码字不易，动动小手，欢迎点赞 ➕ 收藏，如 🈶 问题请留言（或者关注下方公众号，看见后第一时间回复，还有海量编程资料等你来领！），博主看见后一定及时给您答复 💌💌💌