OCI客户端启用TAC必须同时配置服务端与客户端:连接串需含TAC=ON且使用SCAN地址,服务端须用srvctl启用BASIC TAF与RLB,客户端代码需捕获SQLRecoverableException并调用恢复API。

OCI客户端启用TAC(透明应用连续性)必须配合服务端配置,单独在客户端加参数无效。
OCI连接字符串必须包含 TAC=ON 且使用 SCAN 名称
Oracle 19c RAC 的 TAC 不是纯客户端行为,它依赖服务端的 TAF 配置、实例注册的服务属性以及客户端连接时明确声明支持。常见错误是只改 tnsnames.ora 或 JDBC URL 却漏掉关键项。
- 连接串中必须显式指定
TAC=ON,例如:(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=rac-scan)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb1)(TAC=ON))) - 不能用单节点 VIP 或主机名直连,必须走 SCAN(
rac-scan),否则服务端无法路由重连请求 - 如果用 JDBC,URL 中需带
oracle.net.tns_admin指向含正确配置的tnsnames.ora,且驱动版本 ≥ 19.3(ojdbc10.jar 或更高)
srvctl modify service 必须开启 -taf 和 -rlb
TAC 在服务端由 Oracle Clusterware 管理的服务控制,不是数据库参数。不执行这步,客户端即使连上了,故障时也不会触发会话恢复。
- 确认当前服务已注册:
srvctl status service -d ORCL -s orclpdb1 - 启用 TAF + RLB(运行时负载均衡):
srvctl modify service -d ORCL -s orclpdb1 -taf BASIC -rlb YES - 重启服务生效:
srvctl stop service -d ORCL -s orclpdb1 && srvctl start service -d ORCL -s orclpdb1 - 注意:
BASIC是唯一支持 TAC 的 TAF 模式;PRECONNECT不兼容 TAC
客户端代码里必须调用 setEndToEndMetrics 并捕获 SQLRecoverableException
TAC 不是“自动续命”,它依赖应用主动参与会话上下文重建。OCI 客户端(如 C/C++、Pro*C)需显式启用追踪,并在异常后调用恢复 API。
- 连接建立后立即设置追踪标签:
OCISessionBegin(..., OCI_DEFAULT); OCIServerAttach(...); OCIAttrSet(..., OCI_HTYPE_SESSION, ..., OCI_ATTR_END_TO_END_METRICS, ...) - 执行 SQL 前,用
OCIAttrSet设置OCI_ATTR_END_TO_END_METRICS,传入含service_name和module的字符串数组 - 捕获
SQLRecoverableException(不是SQLException),并在 catch 块中调用OCISessionEnd+OCISessionBegin重建会话 - 若用 UCP 连接池,需启用
enableTransparentApplicationContinuity=true,且池中所有连接必须来自同一服务名
最容易被忽略的是:TAC 的会话恢复只对 SELECT 和部分 DML 生效,且要求事务未提交——一旦 COMMIT 发出,TAC 就不再接管。生产环境务必在批处理或长事务前评估语句粒度和超时窗口。


















