DB2

• OGG 配置参考ORACLE配置：http://docs.zbomc.com/docs/zcbusv2/zcbusv2-1favjrlcpspf0

文档信息

一、前言

1.1 文档目的

本文档系统梳理DB2各版本对INSERT/UPDATE/DELETE操作全列信息捕获的支持能力，标准化OGG配置规则，为CDC同步场景中全列数据捕获的实施、版本选型及问题排查提供统一指导，保障数据同步的完整性。

1.2 核心背景

DB2原生日志仅记录DML操作的“增量信息”：INSERT默认记录全列，UPDATE仅记录修改列+主键，DELETE仅记录主键/唯一键。OGG需通过专属参数组合，基于主键定位从表中抓取全列数据，该能力生效依赖“DB2版本+OGG版本+配置参数+权限环境”四者匹配。

1.3 核心概念与术语

二、技术前置条件

2.1 DB2日志配置（核心）

OGG依赖DB2归档日志实现全列捕获，需按以下步骤开启：

-- 1. 连接目标数据库
db2 connect to YOUR_DB_NAME user DB2INST1 using YOUR_PWD

-- 2. 开启归档日志
db2 update db cfg for YOUR_DB_NAME using LOGARCHMETH1 DISK:/db2_archive_log
db2 update db cfg for YOUR_DB_NAME using LOGRETAIN ON

-- 3. 开启后立即备份数据库（日志生效必需）
db2 backup db YOUR_DB_NAME to /tmp/db2_backup

2.2 权限配置

OGG运行用户（如DB2INST1）需具备以下权限，确保日志读取与表数据访问：

-- 最简授权方式（生产环境可按需最小化配置）
db2 grant sysadm on database to user DB2INST1

-- 最小权限替代方案（精细控制）
db2 grant select on sysibm.systables to DB2INST1
db2 grant select on sysibm.syscolumns to DB2INST1
db2 grant access to database partition group ibmdefaultgroup to DB2INST1

2.3 数据对象要求

1. 目标表必须包含主键/唯一键：OGG需通过主键定位行数据，才能抓取UPDATE/DELETE全列信息；无主键表即使配置参数，仅能捕获主键/修改列。
2. 禁用行压缩（部分版本）：DB2 LUW v9.7等早期版本开启行压缩可能导致全列数据抓取乱码，需临时禁用：

   db2 ALTER TABLE DB2INST1.T9 COMPRESS NO;

三、版本兼容性矩阵

3.1 DB2 LUW 版本适配

3.2 DB2 z/OS 版本适配

3.3 DB2 for i 版本适配

3.4 不适配版本组合汇总

四、OGG配置规范

4.1 核心参数说明

4.2 基础配置模板（通用版）

配置文件路径：OGG安装目录 /dirprm/EDB2.prm

-- ==============================================
-- OGG Extract 配置（DB2 DML全列捕获通用模板）
-- 适配：DB2 LUW 10.5+/OGG 12c+
-- ==============================================
-- 1. 进程定义
EXTRACT EDB2        -- 进程名（E开头，长度≤8字符）

-- 2. DB2环境变量配置
SETENV (DB2INSTANCE = "DB2INST1")       -- 替换为实际DB2实例名
SETENV (DB2DBDFT = "YOUR_DB_NAME")      -- 替换为实际数据库名
SETENV (NLS_LANG = "UTF8")              -- 数据库字符集（按需调整为GBK等）

-- 3. 性能与检查点配置
MEMORYOPTIONS CACHESIZE 1G              -- 进程缓存大小（按需调整：512M/2G）
CHECKPOINTSECS 30                       -- 30秒生成检查点，异常重启快速恢复

-- 4. 认证配置（生产环境推荐加密密码）
USERID DB2INST1, ENCRYPTED PASSWORD "加密密码" ENCRYPTKEY default
-- 测试环境明文密码（不推荐生产使用）：
-- USERID DB2INST1, PASSWORD "YOUR_PWD"

-- 5. Trail文件配置（开启压缩降低存储开销）
EXTTRAIL ./dirdat/tt, COMPRESSION ON, MEGABYTES 200

-- 6. DB2日志提取专属配置
TRANLOGOPTIONS 
  DB2INSTANCE DB2INST1,                 -- 与SETENV保持一致
  MEMBER 0,                             -- DPF分区环境需指定成员编号
  LOGRETENTION YES                      -- 保留日志至OGG提取完成，防止提前清理

-- 7. 全局全列捕获参数（按需选择）
GETUPDATEBEFORES                       -- 全局开启UPDATE BEFORE值捕获
NOCOMPRESSDELETES                      -- 全局开启DELETE全列捕获

-- 8. 表级配置（优先级高于全局）
TABLE DB2INST1.T9, LOGALLCOLS;          -- T9表开启全列捕获
-- 多表配置示例：
-- TABLE DB2INST1.T8, LOGALLCOLS;
-- TABLE DB2INST1.T7, LOGALLCOLS, GETUPDATEBEFORES, NOCOMPRESSDELETES;

4.3 分场景配置示例

场景1：仅捕获指定表DELETE全列

EXTRACT EDB2
SETENV (DB2INSTANCE = "DB2INST1")
SETENV (DB2DBDFT = "YOUR_DB_NAME")
USERID DB2INST1, PASSWORD "YOUR_PWD"
EXTTRAIL ./dirdat/tt, COMPRESSION ON
TRANLOGOPTIONS DB2INSTANCE DB2INST1, LOGRETENTION YES
-- 仅对T9表配置DELETE全列参数
TABLE DB2INST1.T9, LOGALLCOLS, NOCOMPRESSDELETES;

场景2：捕获指定表UPDATE全列（BEFORE+AFTER）+ DELETE全列

EXTRACT EDB2
SETENV (DB2INSTANCE = "DB2INST1")
SETENV (DB2DBDFT = "YOUR_DB_NAME")
USERID DB2INST1, PASSWORD "YOUR_PWD"
EXTTRAIL ./dirdat/tt, COMPRESSION ON
TRANLOGOPTIONS DB2INSTANCE DB2INST1, LOGRETENTION YES
-- 表级精准配置全量全列捕获
TABLE DB2INST1.T9, LOGALLCOLS, GETUPDATEBEFORES, NOCOMPRESSDELETES;

场景3：DB2 z/OS 专属配置

EXTRACT EDB2Z
SETENV (DB2INSTANCE = "DB2ZINST")
SETENV (DB2DBDFT = "YOUR_ZOS_DB")
USERID DB2ZINST, PASSWORD "YOUR_PWD"
EXTTRAIL ./dirdat/zz, COMPRESSION ON
TRANLOGOPTIONS 
  SUBSYSTEM DB2Z,                       -- z/OS 子系统名
  LOGSTREAMID 0001,                     -- 日志流ID
  LOGRETENTION YES
GETUPDATEBEFORES
NOCOMPRESSDELETES
TABLE DB2ZINST.T9, LOGALLCOLS;

4.4 配置生效步骤

1. 将配置文件保存至OGG安装目录 /dirprm 文件夹；
2. 启动GGSCI工具，执行以下命令完成进程创建与启动：

# 进入OGG安装目录
cd /ogg_home

# 启动GGSCI工具
./ggsci

# 1. 创建Extract进程（基于事务日志，从当前时间开始捕获）
GGSCI> ADD EXTRACT EDB2, TRANLOG, BEGIN NOW

# 2. 关联Trail文件（与配置中EXTTRAIL路径一致）
GGSCI> ADD EXTTRAIL ./dirdat/tt, EXTRACT EDB2

# 3. 启动Extract进程
GGSCI> START EDB2

# 4. 验证进程状态（正常运行标志：RUNNING）
GGSCI> INFO EDB2

# 5. 查看进程报告（排查配置或运行异常）
GGSCI> VIEW REPORT EDB2

五、全列捕获验证方法

5.1 业务操作验证

1. 在DB2中执行测试DML操作，生成全列捕获数据：

-- 连接DB2数据库
db2 connect to YOUR_DB_NAME user DB2INST1 using YOUR_PWD

-- 1. 插入测试数据
INSERT INTO DB2INST1.T9 VALUES (1, ' 测试插入 ', 'CODE001', ' 插入备注 ', '2025-12-04');

-- 2. 更新测试数据（修改非主键列）
UPDATE DB2INST1.T9 SET NAME = ' 测试更新 ', CODE = 'CODE002' WHERE ID = 1;

-- 3. 删除测试数据
DELETE FROM DB2INST1.T9 WHERE ID = 1;

-- 提交事务
db2 commit;

2. 在GGSCI中查看进程统计，验证全列捕获列数：

GGSCI> STATS EDB2, TABLE DB2INST1.T9

• 生效标志：UPDATE/DELETE操作的“Columns Captured”数量等于表的总列数（而非仅主键/修改列）。

5.2 Trail文件解析验证（logdump工具）

通过OGG自带的logdump工具解析Trail文件，直观校验全列信息：

# 进入OGG安装目录
cd /ogg_home

# 启动logdump工具
./logdump

# 1. 打开Trail文件（替换为实际生成的文件，如tt000001）
LOGDUMP> OPEN ./dirdat/tt000001

# 2. 开启详情显示模式
LOGDUMP> DETAIL ON

# 3. 查找指定DML操作记录
LOGDUMP> FIND RECORD TYPE UPDATE  # 查找UPDATE记录
LOGDUMP> FIND RECORD TYPE DELETE  # 查找DELETE记录

# 4. 查看记录详情（生效标志：显示表所有列的名称和去空格后的值）
LOGDUMP> NEXT

六、生产环境最佳实践

1. 版本选型：优先选择“DB2 LUW 11.5 + OGG 21c”组合，稳定性与性能最优；DB2 z/OS推荐v12+搭配OGG 12c+。
2. 参数管控：仅对核心业务表（需数据回溯、一致性校验）启用全列捕获参数，非必要表保留默认配置，降低Trail文件体积与DB2压力。
3. 安全配置：生产环境必须使用加密密码，通过以下命令生成：

   GGSCI> ENCRYPT PASSWORD 你的明文密码 ENCRYPTKEY default

   将生成的加密字符串替换配置中的“加密密码”。
4. 运维监控：定期通过INFO EDB2 MONITOR EXTRACT EDB2命令检查进程状态；监控Trail文件大小，通过PURGEEXTTRAIL命令清理过期文件。
5. 补丁管理：DB2 for i需及时安装IBM PTF补丁，DB2 z/OS需适配OGG专属版本与子系统配置。

七、常见问题与排查

八、附录

附录1：核心参数速查表

附录2：常用命令参考