1. 当 Extract 报出 OGG-00869，先别急着重启进程
GoldenGate 的 Extract 进程在读取源端表结构时，会为每张需要同步的表申请一个「列清单句柄」（column list handle）。这个句柄本质上是 Extract 在内存里维护的一份表列元数据快照，用来把 redo/undo 里解析出来的列号映射成实际列名，再组装成 trail 文件里的记录。一旦这个句柄拿不到，Extract 就会在 report 文件里打出WARNING OGG-00869 Failed to retrieve column list handle for table，紧接着往往跟着ERROR OGG-00199 Table ... does not exist in target database。
很多人看到 OGG-00199 第一反应是「目标端表被删了」，于是跑去目标库查dba_tables，结果发现表好好的。这就是 OGG-00869 最迷惑人的地方：它报的是「拿不到列清单句柄」，而不是「表真的不存在」。真正的原因通常藏在源端——表结构刚做过 DDL、数据字典没同步、游标数不够、或者 Extract 用的数据库账号权限被收窄。
这篇内容面向正在被 OGG-00869 卡住的 Oracle DBA 和 GoldenGate 运维同学，从表结构变更、字典同步、权限与游标四个角度把根因拆开，给出可以直接复制的 Extract 参数片段、列清单校验 SQL 和复现验证步骤。同时我会说明怎么用 TaoToken 统一 Key/API 通道把诊断脚本的调用凭证集中管起来，避免每次排障都要在多个终端里翻 key。适合谁看：手上跑着 GoldenGate 9.5.1 及以上版本、Extract 偶发或持续报 OGG-00869、想一次性把列句柄失效问题排干净的人。
先说结论方向：OGG-00869 不是单一原因的错误码，它是一个「症状码」。你要做的是顺着句柄申请链路往回查，而不是盯着报错本身。下面按排查顺序展开。
2. TaoToken 统一 Key 通道：把诊断脚本的凭证收口
在正式排障之前，先解决一个工程化问题。排查 OGG-00869 时，你往往要跑一堆脚本：查dba_tab_columns、比对源目标列差异、调 GoldenGate 的info extract、甚至写个 Python 脚本批量校验列清单。这些脚本如果各自硬编码数据库密码或 API key，维护起来就是灾难。我试过把诊断脚本的调用凭证统一走 TaoToken 的 Key 通道，后面换 key、加权限、做审计都只改一处。
TaoToken 在这里的角色是「统一凭证网关」：你通过官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册后，在控制台生成一个统一 Key，所有诊断脚本、CI 任务、临时排查工具都拿这个 Key 去调 API，而不是各自存一套凭证。API 入口是 https://taotoken.net/api（注意这个地址不加 UTM 参数，直接作为 Base URL 用）。
具体怎么落地？分三步。
第一步，在控制台创建 Key。打开 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，进入 API Keys 页面，新建一个 Key。建议按用途命名，比如ogg-diag-readonly，方便后面做权限隔离。
第二步，把 Key 写进诊断脚本的配置。不要写死在代码里，用环境变量或配置文件。比如你的列清单校验脚本可以这样读：
export TAOTOKEN_API_KEY="sk-你的统一Key" export TAOTOKEN_BASE_URL="https://taotoken.net/api"第三步，脚本里通过 Base URL + Key 调用。如果你用的是 OpenAI 兼容的 SDK，直接改 base_url 即可：
from openai import OpenAI import os client = OpenAI( api_key=os.environ["TAOTOKEN_API_KEY"], base_url=os.environ["TAOTOKEN_BASE_URL"] ) # 让模型帮你分析 Extract report 里的报错上下文 resp = client.chat.completions.create( model="claude-sonnet-4-5", messages=[ {"role": "user", "content": "以下是 GoldenGate Extract report 片段，帮我判断 OGG-00869 的可能根因：..."} ] ) print(resp.choices[0].message.content)这里有个关键点：模型 ID 要写对。TaoToken 的模型对话入口在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，你可以在那里查到当前可用的模型 ID，别凭记忆写。三件套永远是 Base URL + Key + Model ID，缺一个都调不通。
为什么排障场景值得用统一 Key？因为 OGG-00869 的排查经常是「多人协作 + 多脚本 + 临时性」。今天你写个脚本查列差异，明天同事写个脚本比对字典，如果每人一套 key，出问题根本不知道是谁的凭证失效了。统一到 TaoToken 之后，401 报错只可能指向一个地方，排查成本直接砍半。
如果你后面要把这套诊断能力做成长期跑的 Agent（比如定时巡检 Extract 状态、自动抓 report 里的 OGG-00869 并分析），那就该看 Coding Plan 了：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。它适合长期编码和 Agent 场景，比按次调用更划算。
3. 可复制的 Extract 参数片段与列清单校验 SQL
现在进入正题。OGG-00869 的根因排查，我习惯按「先看参数、再查字典、后验权限」的顺序走。下面每一段都可以直接复制。
3.1 Extract 参数片段：把列清单相关配置显式化
GoldenGate 的 Extract 参数文件里，有几个参数直接影响列清单句柄的申请行为。建议在你的extract.prm里显式写清楚，而不是全靠默认值：
EXTRACT ext1 USERIDALIAS ogg_src DOMAIN OracleGoldenGate -- 源端表，显式列出，避免通配符带来的字典解析歧义 TABLE CTAS.LOCAL_PERMIT_T, COLS (ID, PERMIT_NO, STATUS, CREATE_TIME); -- 如果表结构频繁变更，开启 DDL 同步 DDL INCLUDE MAPPED DDLOPTIONS REPORT -- 字典相关 TRANLOGOPTIONS CONVERTUCS2CLOBS -- 关键：确保字典被正确加载 DICTIONARYOPTIONS DICTIONARYLOADONDEMAND重点说DICTIONARYOPTIONS。GoldenGate 在启动 Extract 时会加载数据字典，如果字典加载不完整，某些表的列清单句柄就会申请失败。DICTIONARYLOADONDEMAND让字典按需加载，适合表多但 Extract 只同步部分表的场景。如果你的环境表数量不大，也可以考虑启动时全量加载，减少运行期申请句柄的失败概率。
另一个容易忽略的是TABLE行里的COLS子句。当你显式列出列名，Extract 就不需要去字典里动态解析全部列，句柄申请路径更短，OGG-00869 出现的概率会下降。代价是表结构变更后你要同步改参数，所以配合DDL INCLUDE MAPPED一起用。
3.2 列清单校验 SQL：确认源端字典里列到底在不在
报 OGG-00869 时，第一件事是确认源端数据字典里这张表的列信息是否完整。用下面这段 SQL，把 Extract 关心的列全部拉出来：
-- 查源端表的列清单，确认列是否存在、类型是否正常 SELECT owner, table_name, column_name, data_type, data_length, nullable, column_id FROM dba_tab_columns WHERE owner = 'CTAS' AND table_name = 'LOCAL_PERMIT_T' ORDER BY column_id;如果这条 SQL 返回空，说明表在源端字典里根本查不到——可能是表被 drop 了、或者你连的库不对、或者权限不够看不到。如果返回的列数和 Extract 参数里COLS声明的列数对不上，那就是表结构变更后参数没同步，句柄申请时列映射失败。
再补一条查表是否存在的 SQL：
SELECT owner, table_name, status, last_ddl_time FROM dba_tables WHERE owner = 'CTAS' AND table_name = 'LOCAL_PERMIT_T';last_ddl_time很关键。如果这个时间点晚于 Extract 启动时间，说明表在 Extract 运行期间被 DDL 改过，字典快照可能已经过期，这就是 OGG-00869 的高发场景。
3.3 游标数检查：open_cursors 是不是太小
原始资料里提到open_cursors设为 50 太低，推荐 1000 以上。这个点值得单独拎出来。Extract 在申请列清单句柄时会占用游标，如果open_cursors被打满，句柄申请就会失败，报出 OGG-00869。查当前值：
SHOW PARAMETER open_cursors;查历史峰值：
SELECT resource_name, current_utilization, max_utilization, limit_value FROM v$resource_limit WHERE resource_name = 'open_cursors';如果max_utilization接近limit_value，基本可以确认是游标不够。调整方式：
ALTER SYSTEM SET open_cursors = 1000 SCOPE = BOTH;注意SCOPE = BOTH会同时改内存和 spfile，重启后仍生效。改完不需要重启数据库，但 Extract 进程建议重启一次，让它重新申请句柄。
3.4 权限校验：Extract 账号能不能读字典
Extract 用的数据库账号需要能读dba_tab_columns、dba_tables等字典视图。如果权限被收窄，句柄申请也会失败。检查账号权限：
SELECT privilege FROM dba_sys_privs WHERE grantee = 'OGG_SRC' UNION ALL SELECT privilege FROM dba_tab_privs WHERE grantee = 'OGG_SRC' AND table_name IN ('DBA_TAB_COLUMNS', 'DBA_TABLES');Extract 账号至少要有SELECT ANY DICTIONARY或者对相关字典视图的显式 SELECT 权限。如果这里查出来是空的，补权限：
GRANT SELECT ANY DICTIONARY TO OGG_SRC;4. 验证请求与成功结果：让 OGG-00869 不再复现
参数、SQL、权限都过了一遍之后，怎么确认问题真的解决了？不能只看「这次没报错」，要构造一个可复现的验证流程。
4.1 重启 Extract 并观察 report
先停 Extract：
GGSCI> STOP EXTRACT ext1再启动：
GGSCI> START EXTRACT ext1然后盯 report 文件：
tail -f $GG_HOME/dirrpt/EXT1.rpt正常情况下，你会看到字典加载完成的日志，以及类似Columns mapped for CTAS.LOCAL_PERMIT_T的信息。如果 OGG-00869 不再出现，说明句柄申请成功。
4.2 用 info 命令确认列清单状态
GoldenGate 提供了INFO EXTRACT命令，可以看 Extract 当前的状态和它认识的表：
GGSCI> INFO EXTRACT ext1, DETAIL重点看输出里有没有CTAS.LOCAL_PERMIT_T以及它的列映射信息。如果表出现在列表里且没有 warning，说明列清单句柄已经正常持有。
4.3 构造一次表结构变更，验证 DDL 同步
真正稳的验证是「改一次表结构，看 Extract 能不能跟上」。在测试环境执行：
ALTER TABLE CTAS.LOCAL_PERMIT_T ADD (REMARK VARCHAR2(200));然后观察 report：
tail -f $GG_HOME/dirrpt/EXT1.rpt | grep -i "LOCAL_PERMIT_T"如果 Extract 能识别这次 DDL 并更新列清单，没有报 OGG-00869，说明字典同步链路是通的。这一步能排掉「字典快照过期」这类隐蔽问题。
4.4 用 TaoToken 脚本做批量校验
单表验证通过后，如果你有几十上百张表，手动查太慢。写个脚本批量跑列清单校验，凭证走 TaoToken 统一 Key：
import os import oracledb from openai import OpenAI # 数据库连接（凭证也从统一配置读） dsn = oracledb.makedsn("src-host", 1521, service_name="ORCL") conn = oracledb.connect(user="ogg_src", password=os.environ["DB_PWD"], dsn=dsn) cur = conn.cursor() cur.execute(""" SELECT owner, table_name, COUNT(*) AS col_cnt FROM dba_tab_columns WHERE owner = 'CTAS' GROUP BY owner, table_name """) rows = cur.fetchall() # 把结果交给模型做异常判断 client = OpenAI( api_key=os.environ["TAOTOKEN_API_KEY"], base_url=os.environ["TAOTOKEN_BASE_URL"] ) summary = "\n".join([f"{r[0]}.{r[1]}: {r[2]} 列" for r in rows]) resp = client.chat.completions.create( model="claude-sonnet-4-5", messages=[{"role": "user", "content": f"以下是源端表列数统计，帮我找出可能列数异常（比如为0）的表：\n{summary}"}] ) print(resp.choices[0].message.content)这个脚本的价值在于：它把「查字典」和「判断异常」串起来了，而且凭证统一走 TaoToken，不会散落在各个脚本里。模型对话入口在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，模型 ID 从那里查。
5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth
排障过程中，除了 OGG-00869 本身，你还会撞上一堆周边报错。下面按真实遇到的频率列出来，对照着查。
5.1 401 Unauthorized
这是 TaoToken 调用里最常见的。原因通常是 Key 没设对、Key 过期、或者环境变量没生效。检查顺序：
echo $TAOTOKEN_API_KEY echo $TAOTOKEN_BASE_URL如果 Key 是空的，说明 export 没执行或者写在了错误的 shell 配置里。如果 Key 有值但还是 401，去控制台确认这个 Key 是否被禁用或删除：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。注意 Base URL 必须是https://taotoken.net/api，多一个斜杠或者少一个/api都会 401。
5.2 local proxy failed
这个报错通常出现在你本地配了代理，但代理没起来或者端口不对。TaoToken 的 API 调用不需要额外代理，直接连https://taotoken.net/api即可。如果你环境里有HTTP_PROXY/HTTPS_PROXY环境变量，先清掉：
unset HTTP_PROXY unset HTTPS_PROXY然后重试。如果公司网络有统一出口，确认出口能访问taotoken.net域名。
5.3 reading choices 报错
reading 'choices'这类报错一般是响应结构不符合预期，常见原因是模型 ID 写错了，或者请求体格式不对。检查两点：一是model字段的值必须是从模型列表页查到的准确 ID；二是messages必须是数组，每条有role和content。如果你用的是非 OpenAI 兼容的调用方式，确认 SDK 版本支持自定义 base_url。
5.4 OAuth 相关报错
如果你在 Claude Code 或类似工具里接入，可能会遇到 OAuth 报错。这类工具通常需要你在配置里填 Base URL + Key + Model ID 三件套。Claude Code 的接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有完整的配置示例。注意 Claude Code 的配置文件和普通 SDK 不一样，别把环境变量那套直接搬过去。
5.5 OGG-00869 反复出现
如果按第 3 节的步骤都做了，OGG-00869 还是反复出现，重点查两个地方：一是last_ddl_time是否持续在变（说明有定时 DDL 任务在改表），二是open_cursors的max_utilization是否又打满了。前者需要在 DDL 任务里加 GoldenGate 的 DDL 同步触发，后者需要评估是不是有别的应用在抢游标。
5.6 三件套对照表
| 配置项 | 正确值 | 常见错误 |
|---|---|---|
| Base URL | https://taotoken.net/api | 写成首页地址、多斜杠、少/api |
| Key | 控制台生成的sk-开头字符串 | 用了旧 Key、Key 被禁用 |
| Model ID | 模型列表页查到的准确 ID | 凭记忆写、大小写错 |
6. 把排查清单固化下来，下次直接跑
OGG-00869 这类问题的麻烦之处在于它跨了 GoldenGate、Oracle 字典、权限、游标四个层面，每次都要从头查一遍很累。我的做法是把第 3、4 节的 SQL 和脚本固化成一个排查清单，配合 TaoToken 统一 Key 通道，让整个流程可复用。
清单大概长这样：第一步跑dba_tab_columns确认列在不在；第二步跑dba_tables看last_ddl_time；第三步查open_cursors峰值；第四步查 Extract 账号权限；第五步重启 Extract 看 report；第六步构造 DDL 验证同步。六步走完，基本能定位到根因。
诊断脚本的凭证统一走 TaoToken，好处是换 Key 只改一处，多人协作时也不会出现「谁的 key 失效了」这种扯皮。如果你要把这套清单做成定时巡检的 Agent，Coding Plan 会比按次调用更合适：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。
最后留一个我踩过的坑：改完open_cursors后一定要重启 Extract，光改数据库参数不重启，Extract 持有的旧游标不会释放，OGG-00869 可能还会再报一次。重启之后如果 report 里出现Columns mapped字样，基本就稳了。
