简介瀚高数据库抽取工具面向需要将Oracle数据迁移或同步至瀚高HGDB数据库的DBA、数据工程师与迁移实施人员重点解决异构数据库间数据类型差异、Oracle特性兼容以及迁移过程安全可控等问题。压缩包共660个文件、约55.29MB以dll动态库、jar包、properties配置、exe可执行程序为主并附带大量时区数据、字体与策略文件整体构成一套可直接部署运行的抽取与同步环境。资源围绕数据抽取、转换、加载ETL流程展开兼顾Oracle的PL/SQL存储过程、触发器与索引等复杂对象处理并提供实时或定期同步能力便于在主备或分布式场景中保持数据一致。工具依赖JRE7运行版本信息显示其针对Oracle 10g Release 3做过测试优化对较旧版本亦有较好支持。目前已有778人学习下载适合需要落地Oracle到瀚高迁移方案、参考工具结构与配置思路的技术人员。1. 从 Oracle 到瀚高一次数据抽取工具的环境落地记录上周帮一个做数据迁移的团队收拾环境目标很明确把一套 Oracle 里的业务数据抽出来落到瀚高数据库HGDB里做验证。工具本身不复杂难的是环境——Oracle 客户端版本、字符集、驱动路径、HGDB 的兼容模式任何一处对不上抽取脚本要么连不上源库要么写不进目标库报错还都是那种一句话看不出所以然的。这类活我做过不少翻车的点高度集中不是工具装不上而是装上了跑不通。这篇记录按我实际动手的顺序写从版本怎么选、依赖怎么装到参数怎么配、跑完怎么验证中间夹着几条踩过的坑。适合正在做 Oracle 到 HGDB 迁移、需要把抽取链路先跑通的人新手照着走能出结果熟手可以重点看版本取舍和排错那几段。2. 装之前先把环境盘清楚版本、字符集与依赖2.1 三个版本维度先定死再动手抽取工具能不能跑通八成取决于装之前有没有把版本对齐。我一般从三个维度先定死源端 Oracle 的版本、目标端 HGDB 的版本、以及抽取工具自身依赖的驱动版本。这三者不是随便挑最新的就行得看兼容矩阵。源端 Oracle 这边常见的是 11g、12c、19c 三个档。11g 的老库还大量存在但它的客户端在较新的操作系统上装起来费劲尤其是缺少老版本依赖库的时候。12c 和 19c 相对好办客户端安装包完整驱动也稳定。我的建议是源端是什么版本客户端就装同大版本的别跨大版本硬凑。跨版本连接不是绝对不行但字符集转换和某些数据类型的读取容易出玄学问题排查起来很耗时间。目标端 HGDB 要看它当前的兼容模式。瀚高数据库有面向 Oracle 的兼容配置开启后对 Oracle 的语法、数据类型、函数支持更贴近抽取工具写入时的类型映射会顺很多。这个模式在初始化集群或建库时就要确认事后改代价不小。装工具之前先连上目标库执行一句查询确认版本和兼容参数比装完再回头查省事得多。工具自身的驱动依赖核心是 JDBC 驱动。Oracle 侧用 ojdbc 系列HGDB 侧用它自带的 JDBC 驱动。两个驱动的版本都要和各自数据库大版本匹配混用会出现连接建立成功但查询报类型错误的情况。组件推荐版本档说明Oracle 客户端与源库同大版本11g/12c/19c 各自对应避免跨大版本Oracle JDBCojdbc8 及以上对应 JDK 8 环境老库可用 ojdbc6HGDB当前稳定版确认已开启 Oracle 兼容配置HGDB JDBC随数据库版本配套不要拿旧驱动连新库JDK8 或 11与驱动、工具的运行要求对齐2.2 操作系统层面的依赖别等报错才补抽取工具多数是 Java 体系运行环境先要有 JDK。JDK 8 兼容性最好老驱动基本都认JDK 11 也能跑但个别老版本驱动会有模块化相关的告警。装 JDK 时注意两件事一是JAVA_HOME要指到 JDK 根目录而不是 bin 目录二是 PATH 里 java 的优先级要确认机器上装了多个 JDK 时最容易在这里翻车。Oracle 客户端安装会依赖一些系统库常见的是 libaio 这类异步 IO 库。缺了它客户端装完看着正常一连接就报加载库失败。装之前先查一遍# 检查 libaio 是否已安装以常见的 RPM 系为例 rpm -qa | grep libaio # 若缺失则安装 yum install -y libaio这段命令的逻辑很简单先确认系统里有没有 libaio没有就补上。参数上没什么可调的注意包名在不同发行版里可能带版本后缀用grep libaio模糊匹配更稳。Debian 系对应的是libaio1命令换成dpkg -l | grep libaio和apt install libaio1。字符集是另一个容易被忽略的点。源库的字符集、客户端NLS_LANG的设置、目标库的字符集三者不一致时中文数据抽出来可能是乱码也可能是问号。我一般会在客户端环境变量里显式设置NLS_LANG格式是「语言_地区.字符集」比如AMERICAN_AMERICA.AL32UTF8。设成和源库一致能减少一层转换风险。# 写入当前用户的 shell 配置显式指定客户端字符集 export NLS_LANGAMERICAN_AMERICA.AL32UTF8 export ORACLE_HOME/opt/oracle/client export PATH$ORACLE_HOME/bin:$PATH export LD_LIBRARY_PATH$ORACLE_HOME/lib:$LD_LIBRARY_PATH这里四个变量各有分工NLS_LANG管字符集ORACLE_HOME是客户端安装根目录PATH让 sqlplus 等命令能直接调用LD_LIBRARY_PATH保证运行时能找到客户端的动态库。最后这个变量漏了典型现象是命令能执行但报找不到共享库。写完记得source一下当前 shell 配置或者重新登录生效。2.3 网络与端口先通再装装之前花两分钟测一下连通性比装完排查省半小时。源端 Oracle 监听端口默认 1521目标端 HGDB 默认端口按实际部署确认。用 telnet 或 nc 测一下# 测试源库和目标库端口连通性 nc -zv 源库地址 1521 nc -zv 目标库地址 目标端口-z表示只探测不发送数据-v输出详细结果。通了会显示 succeeded不通就是超时或拒绝。超时多半是网络策略问题拒绝则是服务没起或端口不对。这一步看着基础但抽取工具报「连接失败」时一半以上的根因在这里先排除掉能省很多事。3. 安装与配置客户端、驱动、连接串逐个落地3.1 Oracle 客户端安装静默模式更可控图形化安装在小机器上经常卡住我习惯用静默安装。先把安装包解压准备好响应文件然后一条命令跑完。响应文件里关键就几项安装路径、安装类型Instant Client 或完整客户端、以及是否安装 JDBC 相关组件。# 解压客户端安装包 unzip instantclient-basic-linux.x64-19.x.zip -d /opt/oracle/ # 静默安装完整客户端示意响应文件路径按实际调整 ./runInstaller -silent -responseFile /tmp/client_install.rsp -waitforcompletion第一行解压的是 Instant Client适合只需要连接能力的场景体积小、免安装解压后配好环境变量就能用。第二行是完整客户端的静默安装-silent关闭图形界面-responseFile指定预置的应答文件-waitforcompletion让命令阻塞到安装结束方便脚本化。如果只是抽取数据、不需要 sqlplus 之外的 Oracle 工具Instant Client 其实够用还少一堆依赖。装完验证客户端是否可用# 用 sqlplus 连一下源库确认客户端工作正常 sqlplus 用户名/密码//源库地址:1521/服务名能进到 SQL 提示符就说明客户端、网络、账号三样都通了。这一步单独验证是为了把「客户端问题」和「抽取工具问题」隔离开后面工具报错时就不用再怀疑底层。3.2 JDBC 驱动放置与类路径配置抽取工具读驱动靠类路径。Oracle 的 ojdbc jar 和 HGDB 的 JDBC jar 都要放到工具能加载的位置。常见做法是放在工具目录下的 lib 文件夹或者通过启动参数显式指定。# 把两个驱动放到工具的 lib 目录 cp ojdbc8.jar /opt/extract-tool/lib/ cp hgdb-jdbc.jar /opt/extract-tool/lib/ # 启动时显式指定类路径若工具不自带加载逻辑 java -cp /opt/extract-tool/lib/*:/opt/extract-tool/extract-tool.jar 主类名-cp里的*是通配符表示加载该目录下所有 jar省得一个个列。注意通配符在引号内由 Java 自己展开不要写成 shell 展开的形式。两个驱动版本前面说过要和数据库匹配这里再强调一次ojdbc 版本过低连 19c 可能报协议不兼容HGDB 驱动用错版本则可能在建连接时就失败。3.3 连接串与抽取参数按目标库特性调连接串分源端和目标端两套。源端 Oracle 用标准 JDBC 格式目标端 HGDB 的连接串格式接近 PostgreSQL 风格具体以驱动文档为准。抽取工具一般把连接信息放在配置文件里我习惯把两套连接分开写避免混在一起改错。# 源端 Oracle 连接配置 source.urljdbc:oracle:thin://源库地址:1521/服务名 source.user抽取账号 source.password密码 # 目标端 HGDB 连接配置 target.urljdbc:hgdb://目标库地址:端口/库名 target.user写入账号 target.password密码 # 抽取行为参数 extract.batchSize1000 extract.fetchSize500 extract.commitInterval5000batchSize控制每批写入目标库的记录数太大容易撑爆内存太小则事务提交频繁、速度上不去1000 是个稳妥起点。fetchSize是每次从源库游标取回的行数源库数据量大时适当调大能减少往返但别超过客户端内存承受范围。commitInterval是提交间隔按条数或毫秒计取决于工具实现设小了慢、设大了回滚代价高。这几个参数没有万能值先按默认跑通再根据数据量调。目标端写入前确认表结构已经建好或者工具支持自动建表。自动建表时类型映射是关键Oracle 的NUMBER、VARCHAR2、DATE到 HGDB 的对应类型在兼容模式下映射更顺但NUMBER不带精度的情况要留意可能被映射成高精度数值类型影响后续查询性能。提示抽取账号在源端只需要读权限目标端只需要目标表的写权限别图省事用高权限账号出问题时影响面太大。4. 避坑与排查五条踩过的真实记录4.1 连接成功但查询报「无效的列类型」现象工具能连上源库执行简单查询也正常但一抽具体表就报无效的列类型指向某个字段。原因Oracle 的某些数据类型比如带时区的 TIMESTAMP、某些精度的 NUMBER在旧版 JDBC 驱动里映射不完整驱动版本和数据库版本不匹配时尤其明显。解决换用与源库大版本匹配的驱动ojdbc8 对应 12c 及以上老库用 ojdbc6。换完清掉工具缓存重新加载。如果还不行在抽取配置里对该字段做显式类型转换绕开驱动的默认映射。4.2 中文数据抽过去变成问号现象源库里的中文抽到 HGDB 后显示为问号或乱码英文数字正常。原因字符集链路某一环没对齐。常见的是客户端NLS_LANG没设或者设的字符集和源库不一致数据在客户端这一层就被转坏了。解决先查源库字符集再把NLS_LANG设成一致的值重启工具进程让环境变量生效。目标库字符集也要确认支持中文建库时选 UTF8 系列最稳。三处对齐后重新抽一遍验证。4.3 大批量抽取跑到一半内存溢出现象小表抽取正常大表跑到一定条数后进程挂掉日志里是内存溢出。原因fetchSize和batchSize设得过大或者工具默认把结果集全量加载到内存。解决把fetchSize降到几百的量级batchSize控制在千条以内确认工具是流式读取而不是全量加载。JVM 启动参数里适当调大堆内存但这是辅助手段根子还在读取模式上。4.4 目标库写入报主键冲突现象第一次抽取正常重跑或补抽时报主键冲突。原因抽取工具默认是插入模式重跑时没有做去重或覆盖处理。解决确认工具是否支持 upsert 或先清后插模式。支持的话开启对应开关不支持就在抽取前按条件清理目标表或者用临时表加合并的方式落地。这个坑在增量抽取场景里特别常见第一次跑通不代表链路稳。4.5 环境变量改了但工具读不到现象命令行里echo $NLS_LANG有值工具跑起来还是按默认字符集处理。原因工具以服务方式启动或者通过其他用户、其他 shell 启动没继承当前会话的环境变量。解决把环境变量写进工具启动脚本里或者写进对应用户的 profile 文件确保启动进程能读到。以服务方式运行的工具要在服务配置里显式声明环境变量别指望登录 shell 的配置自动带过去。5. 装完怎么验证三层校验把链路跑实工具装完、配置写完别急着上全量数据。我一般分三层验证每层过了再进下一层出问题能立刻定位在哪一环。第一层连通性验证。源端和目标端各跑一次连接测试确认账号、密码、网络、驱动四样都对。这一步用工具自带的测试连接功能或者直接用前面说的 sqlplus 和 JDBC 小脚本各测一次。两层都通说明底层没问题。第二层小样本抽取验证。挑一张字段类型齐全的小表几十条数据完整走一遍抽取流程。重点看三件事条数对不对、中文有没有乱码、日期和数值类型有没有精度丢失。这一步是类型映射的试金石NUMBER精度、DATE时区、VARCHAR2长度这些容易出问题的地方都会暴露。-- 源端和目标端各执行一次比对条数与关键字段 SELECT COUNT(*) FROM 目标表; SELECT 主键, 关键字段 FROM 目标表 ORDER BY 主键 LIMIT 10;条数比对用COUNT(*)字段比对抽前十条看实际值。两边结果一致说明映射和字符集都对了。不一致就回到对应章节查配置别急着扩大范围。第三层边界数据验证。专门造几条边界数据超长字符串、空值、极值数值、特殊字符。这些数据在真实业务里一定有提前验证比上线后救火强。空值要确认目标端是 NULL 而不是空字符串或零特殊字符要确认没被转义坏。校验层验证内容通过标准连通性源端、目标端连接两端均能建立连接并执行查询小样本条数、中文、类型精度条数一致无乱码精度无丢失边界数据空值、超长、特殊字符空值为 NULL字符完整无截断三层都过完再按业务表分批扩大抽取范围每批抽完做一次条数核对。全量跑之前把抽取脚本和配置备份一份出问题能快速回退。从那以后我每次搭这类抽取环境都强制自己先走一遍这三层校验哪怕时间紧也不跳。跳过小样本直接上全量翻车后回头定位的成本远高于这十几分钟。希望这套流程能帮到你少走几个我踩过的坑。本文还有配套的精品资源点击获取
企业数字化 ERP 产品动态
相关推荐
基于CMDB的资产配置管理系统:从Excel台账到自动化运维 简介:基于CMDB的资产配置管理系统是一套面向企业IT运维与配置管理场景的完整Web项目源码包,适合需要快速搭建资产配置管理平台的中高级开发人员与运维人员。压缩包共613个文件,约7.33MB,以232个js、133个vue、39个css等前端源码为… · 2026/11/16 11:24:06
拼多多客服机器人实战:轻量级订单自动应答系统 简介:这是一套面向拼多多商家的智能客服机器人落地实现方案,解决大促期间人工客服响应不及时、重复咨询处理效率低等实际问题,适用于具备基础Windows部署能力的电商运营与技术运维人员。资源共18个文件,含4个核心DLL插件ÿ… · 2026/11/15 7:09:14
SSM在线投票系统本地部署避坑指南 简介:本资源是一套完整的Java毕业设计级在线投票系统源码,面向计算机专业本科生及Java初学者,解决课程设计、毕设选题与SSM框架实战训练需求。系统采用SSM(SpringSpringMVCMyBatis)架构,涵盖前后端完整功能… · 2026/11/3 12:05:21
京津冀电工证办理保姆级教程:从报名到取证全流程避坑指南 京津冀电工证办理保姆级教程:从报名到取证全流程避坑指南 你是不是也遇到过这样的情况:想考个电工证,但不知道去哪报名,怕被中介坑?别急,这篇保姆级教程就是为你准备的。从报名到取证,我们一步一个脚印,帮你把流程捋清楚,避免走弯路。… · 2026/11/16 11:24:07
南宁考电工证的地点良心建议:学历不高怕报不上名怎么破? 南宁考电工证的地点良心建议:学历不高怕报不上名怎么破? 你是不是也这样,想考个电工证,但又担心学历不够,报名会被拒?其实 南宁考电工证的地点 并不难找,关键是要选对地方,掌握正确的报名流程。今天这些建议,都是从业多年老手掏心窝子的… · 2026/11/16 11:24:07
丹东电工证审证多久拿证?转岗电工必看的5大实操问题 丹东电工证审证多久拿证?转岗电工必看的5大实操问题 你是不是正在找工作,却因为没电工证卡在门外?别急,电工证不是遥不可及,关键是你得知道怎么拿。丹东电工证审证流程并不复杂,但很多人因为不了解最新政策,耽误了拿证时间。这篇文章就从实操角度出发… · 2026/11/16 11:24:07
小网特种作业操作证有效期多久 电子证书怎么查最靠谱 小网特种作业操作证有效期多久 电子证书怎么查最靠谱 你是不是也遇到过这种情况: 不知道去哪报名怕被中介坑 ,一搜“小网特种作业操作证”,信息五花八门,真假难辨?今天我就用一个真实案例,带你一步步了解【小网特种作业操作证】的有效期、考试内容、… · 2026/11/16 11:24:07
清远学习电工证良心建议:工地太忙根本没时间复习考试怎么办 清远学习电工证良心建议:工地太忙根本没时间复习考试怎么办 工地太忙根本没时间复习考试,这几乎是每个想考【清远学习电工证】的电工都遇到的痛点。特别是你已经在一线干活,每天十几个小时泡在工地上,哪还有精力去背题、刷题?但现实是,… · 2026/11/16 11:24:06
电工证公司还是个人怎么考多少钱 电工证公司还是个人怎么考多少钱 怕考不过白交培训费?别慌,这篇给你讲透电工证到底该找公司还是个人,多少钱能拿下,还有避坑干货和真实案例。 电工证公司还是个人怎么考多少钱 1. 电工证公司还是个人报考有什么区别? 公司报考… · 2026/11/16 11:23:06
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/16 3:21:55
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/16 3:01:18
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/16 8:30:17
电工证培训的通知在哪考?别再被中介骗了 电工证培训的通知在哪考?别再被中介骗了 你是不是还在为 电工证培训的通知在哪考 发愁?网上搜了一堆信息,结果要么是挂羊头卖狗肉的培训机构,要么就是打着“包过”旗号的骗子?别急,今天我来给你讲讲, 电工证培训的通知… · 2026/11/16 0:00:34
电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享 电工证去哪个部门考核值不值得考 信阳转岗人真实经历分享 怕考不过白交培训费?你不是一个人,信阳的李师傅去年刚转岗做电工,就因为没搞清楚电工证去哪个部门考核,差点交了8000块的培训费。别急,下面这份实操考试全攻略,告诉你电工证到底值不值得考… · 2026/11/16 0:00:34
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/15 1:51:20
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/15 4:02:19
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/15 3:02:05