\_awrsqrpt.sql 是 Oracle 未文档化但稳定的内部脚本,用于在 SQL*Plus 中提取指定 SQL ID 的 AWR 历史执行计划,需满足版本≥10.2.0.5、权限充足、SQL ID 严格匹配等前提。

直接用 _awrsqrpt.sql 提取指定 SQL ID 的历史执行计划
这不是标准功能,而是 Oracle 内部未文档化但稳定可用的脚本,专为查单条 SQL 的 AWR 历史计划设计。它不依赖 GUI,纯 SQL*Plus 下跑,但必须满足硬性前提:Oracle 10.2.0.5+、当前用户有 SELECT_CATALOG_ROLE 或显式授予 DBA_HIST_SQL_PLAN 和 DBA_HIST_SQLSTAT 视图权限、SQL ID 大小写严格匹配且无不可见字符(比如复制时带入的 \u200b)。
执行命令是:
sqlplus / as sysdba @?/rdbms/admin/_awrsqrpt.sql
它会按顺序提示你填:报告类型(html 或 text)、起止快照 ID、DB ID、实例号、最后才是 SQL ID——注意别把顺序搞错,第 5 个才是你要的 SQL ID。
常见错误现象:
-
ORA-00904: "OTHER_XML" invalid identifier:版本低于10.2.0.5或缺少关键补丁 - 输出
no rows selected:不是脚本失效,大概率是该 SQL ID 在指定快照区间内没被 AWR 采样到,或权限不足查不到DBA_HIST_SQLPLAN - 报告里计划为空:可能该 SQL 在对应快照中只执行过 0 次,或只在
v$sql里缓存过,没进入 AWR 历史
先确认 SQL ID 是否真实存在于 AWR 中
别急着跑 _awrsqrpt.sql,先验证手里的 SQL ID 是否能从 AWR 表里捞出数据。否则白等几十秒,还怀疑脚本坏了。
执行这两条语句:
SELECT sql_id, sql_text FROM dba_hist_sqltext WHERE sql_id = 'your_sql_id';
SELECT DISTINCT sql_id, plan_hash_value FROM dba_hist_sqlstat WHERE sql_id = 'your_sql_id' AND snap_id BETWEEN 29379 AND 29382;
如果第一条返回空,说明这条 SQL 没进过 AWR(可能执行次数太少、或被过滤掉);第二条空,说明它在指定快照区间没执行过,或者执行了但没被统计(比如解析失败、被取消)。这时 _awrsqrpt.sql 必然也捞不到东西。
注意:SQL ID 对空格、换行、绑定变量名、隐式类型转换都敏感。例如 WHERE id = '123' 和 WHERE id = 123(id 是 NUMBER)生成的是两个不同 SQL ID,不能混用。
DBA_HIST_SQLBIND 查绑定变量值要加类型判断
如果你导出的报告里看到某次执行特别慢,想确认当时传了什么参数,得查 DBA_HIST_SQLBIND。但它存的是 ANYDATA 类型,不能直接 SELECT value_anydata 出明文。
必须根据 DATATYPE_STRING 字段做分支处理,否则会静默返回 NULL 或报 ORA-22370:
SELECT
position,
datatype_string,
CASE
WHEN datatype_string LIKE 'VARCHAR2%' THEN anydata.access_varchar2(value_anydata)
WHEN datatype_string = 'NUMBER' THEN TO_CHAR(anydata.access_number(value_anydata))
WHEN datatype_string = 'DATE' THEN TO_CHAR(anydata.access_date(value_anydata), 'YYYY-MM-DD HH24:MI:SS')
END AS bind_value
FROM dba_hist_sqlbind
WHERE sql_id = 'your_sql_id' AND snap_id = 29380;容易踩的坑:
- 直接
TO_CHAR(value_anydata):对所有类型都返回 NULL,不报错,结果误导人 - 用
ACCESS_NUMBER()解VARCHAR2:立刻报ORA-22370 - 忽略
SNAP_ID过滤:全表扫DBA_HIST_SQLBIND极慢,务必带上SQL ID+SNAP_ID+DBID
替代方案:DBMS_XPLAN.DISPLAY_AWR 快速看计划摘要
如果只是想快速确认某 SQL ID 在 AWR 里有没有计划、有几个不同 PLAN_HASH_VALUE,不用等完整报告生成,直接用:
SELECT * FROM TABLE(dbms_xplan.display_awr('your_sql_id'));它只返回文本格式的计划树,不包含统计信息和绑定值,但响应快、门槛低。适合初筛——如果这一步都返回 no rows,那 _awrsqrpt.sql 也没必要跑了。
注意点:
- 不支持指定快照范围,查的是该 SQL ID 在整个 AWR 历史中所有已采集的计划
- 若返回多条,说明该 SQL 有多个执行计划(比如因绑定变量窥探、直方图、自适应游标导致),需要进一步结合
DBA_HIST_SQLSTAT看各计划的EXECUTIONS和ELAPSED_TIME_TOTAL - 某些极老版本(如 11.2.0.1)可能不识别部分
OTHER_XML字段,报错时换DISPLAY_CURSOR查最近一次缓存计划
真正难的不是怎么跑命令,而是搞清你手里的 SQL ID 来自哪里、是否覆盖目标时段、有没有被 AWR 实际捕获——这些信息藏在 DBA_HIST_SQLTEXT 和 DBA_HIST_SQLSTAT 的联合查询里,而不是脚本提示里。


















