用途:审查 PL/SQL 代码本身,包括改动后的过程或包、尚未应用的提出文件,以及怀疑导致问题的对象。审查分两遍:先看数据库已知的确定性问题,再按清单推断可能的问题。
用法:开始时声明“Using plsql-review — checking the database's signals first.”。第一遍使用数据库自身结论:pythia errors NAME 给出带 line:column 的编译错误与警告;pythia src NAME 读取带编译器行号的源码,便于把发现锚定到具体行;pythia impact NAME --depth 2 查看对象的暴露程度,依赖者多的对象中的问题优先级更高。对尚未应用的文件,编译结论要到应用时才产生,需明确说明编译仍未验证。第二遍按 reference/antipatterns.md 逐条检查七类反模式:逐行游标循环、字符串拼接动态 SQL、WHEN OTHERS THEN NULL、循环内 COMMIT、手抄类型而非 %TYPE/%ROWTYPE、缺少 NOCOPY 的大 OUT 参数、与代码库约定漂移(pythia similar 可看现有风格)。
报告方式:每条发现锚定为“line N: <问题> — <为何有害> — <修复>”。严重程度顺序为:破坏正确性、静默丢数据或报错、规模化性能、风格漂移。写结论前先用 src 核对实际行,不要只凭 diff 记忆。干净的结果要说明检查了什么,例如编译干净、无新增 INVALID、清单通过。
限制:不适合判断改动是否可安全应用,那属于 plsql-impact 与 plsql-apply 预览的职责;也不适用于非 PL/SQL 的应用代码。