利用 Oracle 登录触发器自动记录客户端 IP

ZhangQi

在 Oracle 数据库运维和日常排查中，快速定位活跃会话（Session）的来源 IP 是一个常见需求。默认情况下，通过 v$session 视图直接查看 IP 并不直观

通过创建一个简单的系统级登录触发器（Logon Trigger），可以实现用户登录时自动将客户端 IP 写入会话信息中，方便后续审计与排查

核心代码

使用具有 DBA 权限的用户（如 SYS）执行以下脚本：

SQL
CREATE OR REPLACE TRIGGER on_logon_trigger
  AFTER LOGON ON DATABASE
BEGIN
   DBMS_APPLICATION_INFO.SET_CLIENT_INFO(SYS_CONTEXT('userenv', 'ip_address'));
END;
/

工作原理

AFTER LOGON ON DATABASE：定义触发时机；每当任何用户成功建立数据库连接时，该触发器会在后台自动执行
SYS_CONTEXT('userenv', 'ip_address')：调用内置环境上下文，实时获取当前登录客户端的 IP 地址
DBMS_APPLICATION_INFO.SET_CLIENT_INFO：将获取到的 IP 地址注册到当前会话的 client_info 属性中

应用与效果

触发器生效后，当需要排查数据库连接来源时，只需查询 v$session 视图，即可直接在 client_info 列中看到清晰的 IP 地址：

SELECT sid, serial#, username, program, client_info
FROM v$session
WHERE username IS NOT NULL;

提示：该触发器仅对创建后新建立的连接生效，已有连接不会追溯记录