Oracle 獲取 Session 資訊的兩大核心函數：USERENV 與 SYS_CONTEXT 完整參考

Oracle 獲取 Session 資訊的兩大核心函數：USERENV 與 SYS_CONTEXT

在 PL/SQL、觸發器、審計、應用上下文中，常需獲取當前會話的用戶、終端、IP、語言等資訊。Oracle 提供兩套機制：

一、USERENV (Legacy，仍支援)

語法：USERENV('parameter')

範例

SELECT USERENV('LANGUAGE') FROM DUAL;
-- AMERICAN_AMERICA.ZHS16GBK

二、SYS_CONTEXT (推薦，功能更強、可擴充)

語法：SYS_CONTEXT('namespace', 'parameter')

最常用命名空間為 USERENV，支援超過 50 種參數：

一鍵查詢所有常用參數

SELECT
  SYS_CONTEXT('USERENV','TERMINAL')        terminal,
  SYS_CONTEXT('USERENV','LANGUAGE')        language,
  SYS_CONTEXT('USERENV','SESSIONID')       sessionid,
  SYS_CONTEXT('USERENV','INSTANCE')        instance,
  SYS_CONTEXT('USERENV','ISDBA')           isdba,
  SYS_CONTEXT('USERENV','CURRENT_USER')    current_user,
  SYS_CONTEXT('USERENV','SESSION_USER')    session_user,
  SYS_CONTEXT('USERENV','PROXY_USER')      proxy_user,
  SYS_CONTEXT('USERENV','DB_NAME')         db_name,
  SYS_CONTEXT('USERENV','HOST')            host,
  SYS_CONTEXT('USERENV','OS_USER')         os_user,
  SYS_CONTEXT('USERENV','IP_ADDRESS')      ip_address,
  SYS_CONTEXT('USERENV','AUTHENTICATION_TYPE') auth_type
FROM DUAL;

三、進階應用：結合 V$SESSION 獲取完整會話畫像

SELECT s.sid, s.serial#, s.username, s.machine, s.program, s.module, s.action,
       s.logon_time, s.status, s.sql_id, s.prev_sql_id,
       ctx.ip_address, ctx.os_user, ctx.terminal, ctx.authentication_type
FROM   v$session s
JOIN (
  SELECT
    SYS_CONTEXT('USERENV','SESSIONID')       sessionid,
    SYS_CONTEXT('USERENV','IP_ADDRESS')      ip_address,
    SYS_CONTEXT('USERENV','OS_USER')         os_user,
    SYS_CONTEXT('USERENV','TERMINAL')        terminal,
    SYS_CONTEXT('USERENV','AUTHENTICATION_TYPE') authentication_type
  FROM DUAL
) ctx ON s.audsid = ctx.sessionid
WHERE  s.sid = SYS_CONTEXT('USERENV','SID');  -- 當前會話

四、最佳實踐建議

1. 統一使用 SYS_CONTEXT：功能超集、支援自訂命名空間 (CREATE CONTEXT)、效能優於 USERENV。
2. 審計/安全觸發器：記錄 IP_ADDRESS, OS_USER, MODULE, ACTION (配合 DBMS_APPLICATION_INFO.SET_MODULE)。
3. 應用上下文：建立自訂 Context 存放租戶 ID、權限標籤，實現 VPD (Virtual Private Database) 行級安全。
4. 注意權限：SYS_CONTEXT('USERENV', ...) 需 EXECUTE ON SYS.DBMS_SESSION (PUBLIC 默認擁有)。

1. 上一篇文章： Oracle 分區表執行計劃深度解析：Partition Pruning 與 Pstart/Pstop 關鍵指標
2. 下一篇文章： Oracle FOR UPDATE vs FOR UPDATE NOWAIT/WAIT n：鎖定行鎖行為差異與實戰選型

Oracle 教學

Oracle 遞歸查詢圖文版：CONNECT BY 與 WITH 實戰演示 (含輸出截圖)

遞歸查詢四大經典場景 (附實際查詢結果截圖) 沿用 上一文

使用 asql 以 SQL 查詢分析 Apache Access Log 完整教學

使用 asql 以 SQL 查詢分析 Apache Acce

《SQL必知必會》第2章筆記：計算字段與函數應用

《SQL必知必會》第2章筆記：計算字段與函數應用 一、為什

Oracle 表空間自動擴展設定：AUTOEXTEND ON、MAXSIZE、手動 RESIZE 完整操作

問題背景 新建資料庫預設表空間 400MB，資料量超過即報錯