Oracle DG环境下的透明应用程序故障转移TAF配置方法

### Oracle DG 下的 TAF 配置：别让“自动切换”沦为空谈 许多运维人员以为配置了 Oracle Data Guard，客户端就能自动无缝切换到新主库——这种想法过于理想化。Oracle Data Guard 本身并未内置客户端自动重连机制，透明应用程序故障转移（TAF）必须由服务端 service 与客户端 TNS 配置协同才能生效。仅修改 `tnsnames.ora` 或只创建一个 service，都无法实现 SELECT 级别不中断的透明切换。下面将逐步拆解，详细说明实现 TAF 的必要条件。 #### 必须在主库创建带 FAILOVER 属性的 service 这是 TAF 生效的基本前提。备库会通过 DG 同步该 service 的元数据，但不会自动启动或停止——必须依赖触发器控制其状态。配置时，以下几个参数需要特别留意： - `failover_method => 'BASIC'` 是最常用且兼容性最佳的选项。`'PRECONNECT'` 要求备库预先建立全部连接，在 Data Guard 场景下几乎无法使用。 - `failover_type => 'SELECT'` 表示查询类语句可以被重放，但事务类操作仍会回滚。如果业务中存在大量 DML，需要确认应用层能够容忍中断。 - `aq_ha_notifications => TRUE` 必须启用，否则备库角色变更后客户端无法收到通知，TAF 将无法触发。 - 服务名（`service_name`）和网络名（`network_name`）建议保持一致，以免 `tnsnames.ora` 中 SERVICE_NAME 配置错误。 #### 必须配置触发器+存储过程自动启停 service 当主库切换为备库、备库升级为主库后，service 状态必须实时同步，否则客户端连接到新主库时发现 service 未启动，TAF 将直接失效。以下是几个容易踩坑的注意事项： - 触发器类型必须为 `AFTER STARTUP ON DATABASE`，不能使用 `BEFORE` 或 `LOGON`——因为启动时数据库角色尚未确定。 - 存储过程中查询 `V$DATABASE.DATABASE_ROLE` 是唯一可靠的方法，`V$INSTANCE` 在备库中可能不可用或返回错误值。 - 切勿在备库手动执行 `START_SERVICE`：DG 同步的是 service 定义，而非运行状态；强行启动会导致双主冲突。 - 验证是否生效：在新主库上执行 `SELECT NAME, ENABLED FROM DBA_SERVICES`，对应 service 的 `ENABLED` 字段应显示为 `TRUE`。 #### 客户端 tnsnames.ora 只需最小化配置 当服务端已定义 FAILOVER 参数时，客户端 `FAILOVER_MODE` 设置将被忽略——Oracle 明确要求优先采用服务端配置。因此，客户端配置越简单越好： - TNS 条目中只需指定 `SERVICE_NAME`（其值等于 service 的 `network_name`），无需写入 `FAILOVER_MODE`。 - 地址列表（`ADDRESS_LIST`）中只需写入一个地址（例如主库 VIP），TAF 切换由 service 自动路由，不依赖客户端多地址轮询。 - 严禁在 `listener.ora` 中配置 `GLOBAL_DBNAME`：该静态注册项会直接禁用 TAF，且不会产生任何报错提示。 - JDBC 连接串中若显式指定 `failover=true`，与服务端配置冲突时以服务端配置为准，但建议统一关闭客户端侧的冗余参数。 #### 验证时重点看 V$SESSION.FAILED_OVER 字段 判断 TAF 是否真正触发，不能只看连接是否成功，而应关注会话级状态。许多测试人员误以为“能连上就是 OK”，实际上只是 connect-time failover 在起作用。正确的验证方法如下： - 执行一次长查询（例如 `SELECT COUNT(*) FROM BIG_TABLE`），同时手动 kill 主库实例或断开网络。 - 在查询仍在运行时，立即在客户端连接到新主库，执行 `SELECT FAILED_OVER FROM V$SESSION WHERE SID = SYS_CONTEXT('USERENV', 'SID')`。 - 返回 `YES` 才代表 TAF 的 SELECT 模式生效；若返回 `NO`，说明仅重新建立了新会话，原查询已被丢弃。 - 注意：JDBC thin driver 默认不支持 TAF，必须使用 OCI 驱动（即 `oracle.jdbc.driver.OracleDriver` 已淘汰，应改用 `oracle.jdbc.OracleDriver` 并启用 native library）。 最容易被忽略的是 AQ 通知机制和 JDBC 驱动类型——两者任一缺失，TAF 就会退化为普通重连，SELECT 语句无法重放。即使服务端配置再完美，客户端若收不到通知，一切努力都将归零。