Oracle数据源
更新时间:2026-07-03
Oracle 数据源支持离线库表采集(Jdbc-Oracle)和实时库表采集(Oracle-CDC)两类 source 插件,可写入 Iceberg、Doris、结构化数据集等目标端(各目标端插件参数详见各自文档)。本文以 Iceberg 作为目标端示例。
Oracle 插件类型
| 插件 | plugin_name | _db_pluginId | 作业类型 | 说明 |
|---|---|---|---|---|
| Oracle 离线采集 | Jdbc |
Jdbc-Oracle |
batch |
JDBC 读取 Oracle 表,适用于离线全量/条件增量同步 |
| Oracle 准实时 CDC 采集 | Oracle-CDC |
Oracle-CDC |
streaming |
通过 Oracle redo log 实现全量+增量或仅增量同步 |
脚本 Demo 与参数说明
一、离线任务:Oracle → Iceberg
适用于离线全量同步或按条件增量同步(如按 UPDATED_AT 每日增量)。作业类型为 batch,source 使用 Jdbc-Oracle,sink 使用 Iceberg-batch。
JSON
1{
2 "_db_jobMeta": {
3 "name": "oracle_orders_to_iceberg_batch",
4 "description": "Oracle ORDERS 表离线同步到 Iceberg",
5 "parentFolderId": "project_91cc_799bd26eee94",
6 "type": "batch",
7 "mode": "script"
8 },
9 "env": {
10 "job.mode": "BATCH",
11 "parallelism": 1,
12 "checkpoint.interval": 30000
13 },
14 "source": [
15 {
16 "plugin_name": "Jdbc",
17 "_db_pluginId": "Jdbc-Oracle",
18 "plugin_output": "source_table",
19 "_db_connectionId": "oracle-conn-001",
20 "_db_sourceDatabase": "ORCL",
21 "_db_sourceTable": "ORDERS",
22 "_db_where": "UPDATED_AT >= ${logicTime(yyyy-MM-dd HH:mm:ss,-1d)}",
23 "partition_column": "ID",
24 "_db_sourceChange": {
25 "onDeleteColumn": "SKIP",
26 "onAddColumn": "SKIP",
27 "onDeleteSource": "PAUSE"
28 }
29 }
30 ],
31 "sink": [
32 {
33 "plugin_name": "Iceberg",
34 "_db_pluginId": "Iceberg-batch",
35 "plugin_input": "source_table",
36 "_db_sinkPath": "lake.default",
37 "_db_catalog": "lake",
38 "_db_schema": "default",
39 "iceberg.table.upsert-mode-enabled": false,
40 "data_save_mode": "APPEND_DATA",
41 "_db_isAutoCreated": true,
42 "_db_sinkTableType": "MANAGED",
43 "_db_sinkNameRule": "SAME",
44 "_db_comment": "订单表"
45 }
46 ]
47}
Reader 参数:Jdbc-Oracle
| 参数 | 描述 | 是否必选 | 默认值 |
|---|---|---|---|
plugin_name |
SeaTunnel 插件名,固定填 Jdbc |
是 | 无 |
_db_pluginId |
DataBuilder 侧插件 ID,固定填 Jdbc-Oracle |
是 | 无 |
plugin_output |
Source 输出流名称,需与 sink 的 plugin_input 保持一致 |
是 | 无 |
_db_connectionId |
Oracle 数据源连接 ID | 是 | 无 |
_db_sourceDatabase |
Oracle 数据库/SID 名称(如 ORCL) |
是 | 无 |
_db_sourceTable |
数据表名称(Oracle 通常大写) | 是 | 无 |
partition_column |
分片字段,用于多并发采集,建议使用主键或唯一键 | 否 | 无 |
_db_where |
数据过滤条件,不含 WHERE 关键字,支持时间宏如 ${logicTime(yyyy-MM-dd HH:mm:ss,-1d)} |
否 | 无 |
_db_sourceChange.onDeleteColumn |
源端表字段被删除时的策略:SKIP 忽略 / PAUSE 终止任务 |
否 | SKIP |
_db_sourceChange.onAddColumn |
源端表新增字段时的策略:SKIP 忽略 / PAUSE 终止任务 |
否 | SKIP |
_db_sourceChange.onDeleteSource |
源端表被删除时的策略,当前仅支持 PAUSE |
否 | PAUSE |
二、实时任务:Oracle-CDC → Iceberg
适用于 Oracle 变更数据准实时同步到 Iceberg 数据湖的场景。作业类型为 streaming,source 使用 Oracle-CDC,sink 使用 Iceberg-streaming。示例为仅增量模式,从当前时间点开始消费 redo log。
JSON
1{
2 "_db_jobMeta": {
3 "name": "oracle_orders_to_iceberg_streaming",
4 "description": "Oracle ORDERS 表 CDC 同步到 Iceberg",
5 "parentFolderId": "folder_af42_bccdb16a1d00",
6 "type": "streaming",
7 "mode": "script",
8 "syncMode": "INCREMENT"
9 },
10 "env": {
11 "job.mode": "STREAMING",
12 "parallelism": 1,
13 "_db_enableCheckpoint": false
14 },
15 "source": [
16 {
17 "plugin_name": "Oracle-CDC",
18 "_db_pluginId": "Oracle-CDC",
19 "plugin_output": "source_table",
20 "_db_connectionId": "oracle-cdc-conn-001",
21 "_db_sourceDatabase": "ORCL",
22 "_db_syncMode": "INCREMENT",
23 "_db_incrementPosition": {
24 "type": "CURRENT_TIME",
25 "position": ""
26 }
27 }
28 ],
29 "sink": [
30 {
31 "plugin_name": "Iceberg",
32 "_db_pluginId": "Iceberg-streaming",
33 "plugin_input": "source_table",
34 "_db_sinkPath": "lake.default",
35 "_db_catalog": "lake",
36 "_db_schema": "default",
37 "_db_sinkTableType": "MANAGED"
38 }
39 ],
40 "_db_tableConfigs": [
41 {
42 "tableIdentity": {
43 "sourceTable": "ORDERS",
44 "sinkTable": "ods_orders"
45 },
46 "source": {
47 "_db_sourceChange": {
48 "onDeleteColumn": "SKIP",
49 "onAddColumn": "SKIP",
50 "onDeleteSource": "PAUSE",
51 "onRenameColumn": "SKIP",
52 "onTruncateTable": "SKIP",
53 "onRenameTable": "SKIP",
54 "onChangeColumn": "SKIP",
55 "onChangeTableComment": "SKIP",
56 "onChangeColumnComment": "SKIP"
57 }
58 },
59 "sink": {
60 "_db_isAutoCreated": true,
61 "_db_sinkNameRule": "SAME",
62 "_db_dmlConfig": {
63 "insert": "INSERT",
64 "update": "UPDATE",
65 "delete": "DELETE",
66 "logicalDeleteTag": ""
67 }
68 }
69 }
70 ]
71}
Reader 参数:Oracle-CDC
source[0] 全局参数
| 参数 | 描述 | 是否必选 | 默认值 |
|---|---|---|---|
plugin_name |
SeaTunnel 插件名,固定填 Oracle-CDC |
是 | 无 |
_db_pluginId |
DataBuilder 侧插件 ID,固定填 Oracle-CDC |
是 | 无 |
plugin_output |
Source 输出流名称,需与 sink 的 plugin_input 保持一致 |
是 | 无 |
_db_connectionId |
Oracle CDC 数据源连接 ID | 是 | 无 |
_db_sourceDatabase |
Oracle 数据库/SID 名称 | 是 | 无 |
_db_syncMode |
同步类型:BASE_INCREMENT(全量+增量)/ INCREMENT(仅增量) |
否 | BASE_INCREMENT |
_db_incrementPosition.type |
增量起始类型,示例值 CURRENT_TIME |
否 | 无 |
_db_incrementPosition.position |
指定起始 redo log 时间位点,需确保对应 redo log 未被清理 | 否 | 无 |
表级 DDL 变更策略(写入 _db_tableConfigs[i].source._db_sourceChange)
| 参数 | 描述 | 可选值 | 默认值 |
|---|---|---|---|
onDeleteColumn |
源端表字段被删除时的策略 | SKIP / PAUSE |
PAUSE |
onAddColumn |
源端表新增字段时的策略 | SKIP / PAUSE |
SKIP |
onDeleteSource |
源端表被删除时的策略 | PAUSE |
PAUSE |
onRenameColumn |
源端表字段被重命名时的策略 | SKIP / PAUSE |
SKIP |
onTruncateTable |
源端执行 TRUNCATE TABLE 时的策略 |
SKIP / PAUSE |
SKIP |
onRenameTable |
源端表被重命名时的策略 | SKIP / PAUSE |
SKIP |
onChangeColumn |
源端字段类型变更时的策略 | SKIP / PAUSE / SYNC |
SKIP |
onChangeTableComment |
源端表描述变更时的策略 | SKIP / PAUSE / SYNC |
SKIP |
onChangeColumnComment |
源端字段描述变更时的策略 | SKIP / PAUSE / SYNC |
SKIP |
配置编写注意事项
- plugin_name 与 _db_pluginId 的区别:
plugin_name是引擎层的真实插件名,_db_pluginId是 DataBuilder 平台侧标识。Oracle 离线插件的plugin_name = Jdbc,_db_pluginId = Jdbc-Oracle;准实时插件两者均为Oracle-CDC。 -
离线 vs 实时的选型原则:
- 离线全量/条件过滤增量 → 作业类型
batch,source 用Jdbc-Oracle - 准实时 CDC 同步 → 作业类型
streaming,source 用Oracle-CDC
- 离线全量/条件过滤增量 → 作业类型
- Oracle CDC 前提:使用
Oracle-CDC时,Oracle 必须已开启归档日志(Archive Log Mode)并启用 Supplemental Logging,消费起点对应的 redo log 未被清理。 -
全局配置 vs 表级配置:
- 离线(batch):属性写在
source[0]/sink[0]中 - 准实时(streaming):表级策略(DDL 变更策略、DML 写入策略)写在
_db_tableConfigs[i].source/_db_tableConfigs[i].sink中
- 离线(batch):属性写在
评价此篇文章
