Every Day of a DBA，第153期: Oracle 19c Active Data Guard-DML Redirection

┌─────────────────────────────────────────────────────────────┐
│                      应用层（客户端）                          │
│         连接备库，发出 DML 语句（INSERT/UPDATE/DELETE）         │
└──────────────────────┬──────────────────────────────────────┘
                       │                       
                       ▼
┌─────────────────────────────────────────────────────────────┐
│              Active Data Guard 备库                          │
│                                                             │
│  ① 接收 DML 请求                                              │
│  ② 自动检测是否为 DML 操作                                      │
│  ③ 将 DML 重定向到主库（透明，应用无感知）                         │
│  ④ 等待主库执行完毕并传回 Redo                                   │
│  ⑤ Redo 应用后，返回结果给客户端                                 │
└──────────────────────┬──────────────────────────────────────┘
                       │  重定向 (ADG_REDIRECT_DML)
                       ▼
┌─────────────────────────────────────────────────────────────┐
│                    主库（Primary）                            │
│                                                             │
│  ① 接收来自备库的重定向 DML                                     │
│  ② 在本地执行 DML 操作                                        │
│  ③ 生成 Redo 日志                                            │
│  ④ 按 Data Guard 同步策略传送到备库                            │
└─────────────────────────────────────────────────────────────┘

-- 在备库执行SELECT OPEN_MODE, DATABASE_ROLE, SWITCHOVER_STATUS, PROTECTION_MODE, FLASHBACK_ON FROM V$DATABASE;

SQL>show parameter adg_redirect_dml
 NAME                     TYPE          VALUE
 ———————————— ———– ——————————
 adg_redirect_dml            boolean       FALSE

SQL>altersystemset adg_redirect_dml=true scope=both;
System altered.

SQL>show parameter adg_redirect_dml

NAME            TYPE          VALUE
 ———————————— ———– ——————————
 adg_redirect_dml  boolean        TRUE

SQL>show parameter adg_redirect_dml
 NAME                     TYPE          VALUE
 ———————————— ———– ——————————
 adg_redirect_dml            boolean       FALSE

SQL>altersystemset adg_redirect_dml=true scope=both;
System altered.

SQL>show parameter adg_redirect_dml

NAME            TYPE          VALUE
 ———————————— ———– ——————————
 adg_redirect_dml  boolean        TRUE

-- 在当前会话启用 DML 重定向（会覆盖系统级设置）
ALTERSESSIONENABLE ADG_REDIRECT_DML;
-- 在当前会话禁用 DML 重定向
ALTERSESSIONDISABLE ADG_REDIRECT_DML;

-- 连接主库（用户名/密码方式）
sqlplus sys/oracle@primaryas sysdba

-- 创建测试表
CREATETABLE oracle_dml_test (
    name    VARCHAR2(50),
    testdate TIMESTAMP
);

-- 插入测试数据
INSERTINTO oracle_dml_test VALUES('主库写入测试', SYSDATE);
INSERTINTO oracle_dml_test VALUES('初始数据', SYSDATE);

COMMIT;

-- 验证
SELECT*FROM oracle_dml_test;

-- 连接备库（必须使用用户名/密码方式，不可用 / as sysdba）
sqlplus sys/oracle@standbyas sysdba

-- 查看主库创建的表和数据是否已同步（可能在备库需要完全路径或等待 apply 延迟）
SELECT*FROM oracle_dml_test;

-- 确认备库状态
SELECT DATABASE_ROLE, OPEN_MODE FROM V$DATABASE;

SELECTSTATUS, INSTANCE_NAME, DATABASE_ROLE, PROTECTION_MODE 
FROM V$DATABASE, V$INSTANCE;

DATABASE_ROLE         OPEN_MODE
-------------------- --------------------
PHYSICAL STANDBY     READ ONLY WITH APPLY

-- 连接备库（用户名/密码，非 SYS 用户优先）
sqlplus test_user/test_pass@standby

-- 在备库执行 DELETE 操作（将会被透明重定向到主库）
DELETEFROM oracle_dml_test WHERE name ='初始数据';

-- 显示受影响行数
-- 输出: 1 row deleted.

-- 提交事务
COMMIT;

-- 再次查询，确认读一致性
SELECT*FROM oracle_dml_test;

-- 连接主库
sqlplus sys/oracle@primaryas sysdba

-- 验证数据已从备库删除
SELECT*FROM oracle_dml_test;

-- 预期：'初始数据' 行已不存在，DML 重定向成功

-- 在备库执行
BEGIN
    INSERTINTO oracle_dml_test VALUES('PL/SQL 插入测试', SYSDATE);
    UPDATE oracle_dml_test SET name ='PL/SQL 已更新'WHERE name ='PL/SQL 插入测试';
    COMMIT;
END;
/

-- 备库：插入后未提交，本会话可看到
INSERTINTO oracle_dml_test VALUES('未提交数据', SYSDATE);
SELECT*FROM oracle_dml_test;  -- 可以看到新行

-- 另开一个备库会话（同一事务未提交前），看不到新行

-- 备库执行多表操作
INSERTINTO oracle_dml_test VALUES('多表测试A', SYSDATE);
UPDATE oracle_dml_test SET testdate = SYSDATE WHERE name LIKE'多表%';
DELETEFROM oracle_dml_test WHERE name ='多表测试A';
COMMIT;

-- 当前会话是否启用 DML 重定向
SELECT SYS_CONTEXT('USERENV','ADG_REDIRECT_DML')AS adg_redirect_enabled FROMDUAL;

-- 查看 DML 重定向相关等待事件
SELECTevent, total_waits, time_waited, average_waitFROM V$SYSTEM_EVENTWHERE eventLIKE'%ADG%'OReventLIKE'%redirect%';

ORA-16397: statement redirection from Oracle Active Data Guard standby database to primary database failed

-- 检查备库是否启用了 DML 重定向
ALTERSESSIONENABLE ADG_REDIRECT_DML;

-- 检查连接方式
SELECT SYS_CONTEXT('USERENV','AUTHENTICATION_METHOD')FROMDUAL;
-- 应返回非 SYSDBA 认证方式

-- 查看 ADG 同步状态
SELECT NAME,VALUE, TIME_COMPUTED, DATUM_TIME 
FROM V$ADG_STATS 
WHERE NAME LIKE'%lag%';