更新日期：2024年09月11日
参数名
说明
charset
数据采用byte 读取后采用该编码方式转为string 数据
type
标识数据库类型，目前支持GBASE8T、ORACLE、GBASE8TADV
（DDL版本）
、
ORACLE12C
（支持同步指定PDB下的某个schema
增量数据）MYSQL、GBASE8S（gbasedbt 版本）
startLSN
为读取数据初始lsn 号
isUseMinerCach
e
只针对oracle 源，是否使用挖掘缓存，默认false，解决
大事务问题
packetMaxSize
只针对oracle 源需要拆包的事务，拆包后每个包最大的数
据量，默认值5242880 （5m）
cacheMaxSize
只针对oracle 源，缓存在内存的数据大小，超过该值的事
务将会被落地，默认值104857600（100m）
transMaxCount
事务最大数
maxRecordsPerR
ead
从CDC 接口为每次读取的最大记录数，cdc 使用,可不用修
改
maxSizeOfPerRe
cord
为每条记录
（1 行）
数据的数据量最大值，
内部解析数据用，
一般不用修改
（单位：
字节，
配置文件中默认为1024 字节）
timeOut
为读取数据的超时时间，单位为秒,（8t cdc 需要用到，读
cdc 的超时时间）
GBase RTSync 同步工具手册
- 74 -
南大通用数据技术股份有限公司
参数名
说明
driver
为数据库对应的jdbc 驱动的Driver 名称
url
为连接该数据库的url，请注意填写正确的IP 地址、端口
号、数据库用户名和密码
user
为数据库用户：
针对全量同步：该用户需要有对dbName 指定库表的查询权
限；
针对增量同步：该用户需要有查询CDC 权限（GBase 8t）或
者使用logminer 的权限（Oracle）
该用户的支持情况说明：
1、源为GBase8t/8s，仅支持以该配置用户为owner 的表的
同步
2、源为oracle，对于11g 版本，支持该配置为非catalog
用户的同步，如DBA 用户
password
User 用户数据库密码
catalog
针对oracle为schema信息，
针对其他数据库为用户数据库，
即同步数据的来源库，
ORacle 源库时catalog 名必须大写。
timestampWithF
raction
读取timestamp 类型数据是否需要包含毫秒部分
Parallel
可以使用多并发进行挖掘，一般设置为1-6，默认值为1，
仅为oracle 和mysql 源库时可以。
directQuery
当源数据库为oracle 时，
是否在查询logminer 时直接查询
视图。
当值为true 时，
直接查询v$logmnr_contents 视图，
不创建临时表；值为false 时，创建临时表。
GBase RTSync 同步工具手册
南大通用数据技术股份有限公司
- 75 -
参数名
说明
maxMinerQueueS
ize
最大的挖掘队列大小。默认值为10
isOverDelayTim
eThresholdExit
当延迟时间超过阈值时，是否退出同步工具，false 为不退
出，true 为退出同步。默认值为false
allowPrimaryKe
yNull
JSON 只支持targetdb 是8a 的情况，
使用JSON 格式发送数
据时，是否允许主键值为null。当值为false 时，如果数
据的主键值为null 则记录日志并丢弃该数据；值为true
时，将该数据发送到消息队列中。默认值为false
delayTimeThres
hold
数据解析延迟阈值，
如果
（当前系统时间-数据的提交时间）
>
阈值，
则记录日志或者退出同步。
当值为0 时，
不比较阈值，
单位为分钟，默认值为0
isSetFullrowlo
gging
判断是否在重连时调用set_fullrowlogging 函数。默认值
为true，仅源库为GBase8t、GBase8s 生效
oracleScnStep
步长大小，
主要用于读取oracle logminer 信息时指定末端
scn 号大小，防止数据过大等待时间过长
mysqlSlaveId
默认为空，
即有程序自动生成，
如果设置数值，
需要确保不
与master 和其他slave 的id 重复
filter
用户过滤，仅当源库为GBase8t 时支持
filter="user@exclude:511" --过滤user 用户的操作，
511
可以通过su - user 切换到user 用户下，然后执行执行id
查看，例如：
[informix@gc10604 ~]$ id
uid=511(informix) gid=511(informix)
GBase RTSync 同步工具手册
- 76 -
南大通用数据技术股份有限公司
参数名
说明
groups=511(informix)
fetchsize
设置jdbc 批次返回数据量到结果集的大小（数据条数，
RTSync 默认是500 条），防止内存溢出，目前仅oracle 有
效，其他数据库不起作用
pdburl
为连接pdb url 地址，源库为oracle12c 及以上版本时，同
步pdb 下的schema 数据时需要配置
pdbuser
源库为oracle12c 及以上版本时，同步pdb 下的schema 数
据时需要配置
pdbpassword
源库为oracle12c 及以上版本时，同步pdb 下的schema 数
据时需要配置
pdbcatalog
源库为oracle12c 及以上版本时，同步pdb 下的schema 数
据时需要配置
isUseFullColum
nForUpdate
默认为true，全列配置更新；false 为只更新update 前后
值发生变化的列
operationType
同步数据的类型，支持配置为ddl（仅同步ddl 数据）,dml
（仅同步dml 数据）
,ddl_dml
（ddl 和dml 的变更都同步）
,
默认为dml，仅在GBase8t 源时有效
dyntal
operationType=”ddl_dml”的情况下，可以配置此参数。
true 代表将自动将ddl 中创建的新表加入到同步列表中；
false，表示将忽略该表后续的dml 数据
longTxMaxWaitT
ime
oracle 源，长时间未提交事务最大等待时间，默认值为
3600，单位秒
longTxCheckInt
oracle 源，
长时间未提交事务检查间隔时间，
默认值为600，
GBase RTSync 同步工具手册
南大通用数据技术股份有限公司
- 77 -
参数名
说明
ervalTime
单位秒
ignoreDeletedA
rchivelog
oracle19c 源，
是否忽略已删除的归档日志，
默认值为false
下面是kafka 源需要配置的参数
bootstrapServe
rs
获取数据的KAFKA 的IP 地址和端口，形式如：
下面几个部分显示多个客户机/服务器连接的正确的 sqlhosts 条目。可以假定已正确准备
了网络配置文件 hosts 和 services（即使没有明确提到这些文件）。包括以下示例：
• 使用网络连接
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 60 -
• 使用多种连接类型
• 访问多个数据库服务器
共享内存和本地回送连接的示例可以在共享内存和本地回送连接的说明中找到。
网络连接
下图显示的配置中，客户机应用程序位于主机 river 上，而数据库服务器位于主机 valley
上。
图: 网络客户机/服务器配置示例
在这两台计算机上定义了 valley_ds 数据库服务器的 sqlhosts 条目。
两个计算机在同一个 TCP/IP 网络上，但是主机 river 对于其网络编程接口使用套接字，
而主机 valley 对于其网络编程接口使用 TLI。nettype 字段必须反映 sqlhosts 所在计算
机使用的网络编程接口类型。在此示例中，主机 river 上 valley_ds 数据库服务器的
nettype 字段是 onsoctcp，而主机 valley 上 valley_ds 数据库服务器的 nettype 字段是
ontlitcp。
多种连接类型
数据库服务器的单个实例可以提供多种类型的连接。下图说明了此类配置。数据库服务器
位于主机 river 上。由于共享内存速度快，所以客户机 A 通过共享内存连接连接到数据
库服务器。客户机 B 必须使用网络连接，因为客户机和服务器在不同的计算机上。
当您希望数据库服务器接受多种类型的连接时，您必须进行下列操作：
• 在 onconfig 文件中添加 DBSERVERNAME 和 DBSERVERALIASES 条目。
• 针对每个数据库服务器/连接类型对，添加 sqlhosts 条目。
对于下图中的配置，数据库服务器有两个数据库服务器名称：river_net 和 river_shm。
onconfig 文件包含以下条目：
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 61 -
DBSERVERNAME river_net
DBSERVERALIASES river_shm
图: 使用多种连接类型的 UNIX™ 客户机/服务器配置的示例
客户机应用程序使用的数据库服务器名称可用于确定使用的连接类型。客户机 A 使用以
下语句连接到数据库服务器：
CONNECT TO '@river_shm'
在 sqlhosts 文件中，与名称 river_shm 关联的 nettype 指定共享内存连接，因此该连
接是共享内存连接。
客户机 B 可使用以下语句连接到数据库服务器：
CONNECT TO '@river_net'
在 sqlhosts 文件中，与 river_net 相关联的 nettype 值指定网络 (TCP/IP) 连接，因
此客户机 B 使用网络连接。
访问多个数据库服务器
下图显示了主机 river 上两个数据库服务器的配置。当一台计算机上有多个数据库服务
器处于活动状态时，称为多处驻留。
图: UNIX™ 上的多个数据库服务器
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 62 -
对于前面示例中的配置，您必须准备两个 onconfig 文件，一个用于数据库服务器 A，另
一个用于数据库服务器 B。sqlhosts 文件包含这两个数据库服务器的连接信息。
数据库服务器 A 的 onconfig 文件包含以下行：
DBSERVERNAME riverA_shm
数据库服务器 B 的 onconfig 文件包含以下行：
DBSERVERNAME riverB_soc