pragma inline 是 pl/sql 中用于建议编译器内联小函数的指令,但仅当 plsql_optimize_level ≥ 2 时生效,且对含游标、异常、动态 sql 或超 15–20 行的子程序静默忽略。

PRAGMA INLINE 能让 PL/SQL 编译器把小的子程序调用“展开”成内联代码,但默认不生效,必须显式启用且有严格条件限制。
PRAGMA INLINE 必须配合 plsql_optimize_level ≥ 2 才起作用
Oracle 不会仅凭 PRAGMA INLINE 就做内联;它只是个“建议”,真正是否内联由优化器级别决定。低于 Level 2(比如设为 1 或 0),该 pragma 完全被忽略。
- 确认当前会话优化级别:
SELECT plsql_optimize_level FROM v$parameter WHERE name = 'plsql_optimize_level'; - 临时提升(推荐开发期使用):
ALTER SESSION SET plsql_optimize_level = 2; - 生产环境若需持久生效,应通过
ALTER SYSTEM SET plsql_optimize_level = 2 SCOPE=BOTH;设置,而非依赖单个存储过程里的 pragma
INLINE 只对“小而简单”的子程序有效,大函数或含复杂结构的会被跳过
编译器对内联有硬性过滤:如果子程序体超过约 15–20 行、含游标循环、异常块(EXCEPTION)、动态 SQL(EXECUTE IMMEDIATE)或递归调用,PRAGMA INLINE 将被静默忽略。
- 适合场景:纯计算型小函数,例如
get_tax_rate(p_amount NUMBER)只做简单算术和 IF 判断 - 不适合场景:带
FOR UPDATE游标、调用其他存储过程、含DBMS_OUTPUT或事务控制语句的子程序 - 验证是否生效:查询
USER_PLSQL_OBJECT_SETTINGS中对应对象的PLSQL_OPTIMIZE_LEVEL和PLSQL_CODE_TYPE,再结合DBMS_PREPROCESSOR查看预处理后代码(需权限)
语法写法必须紧贴子程序声明头,且参数名要完全匹配
PRAGMA INLINE 不是注释,位置和拼写错一个字符就失效。它必须出现在子程序声明之后、IS 或 AS 之前,且参数名必须与调用处一致(大小写不敏感,但命名要准确)。
CREATE OR REPLACE PROCEDURE calc_bonus(p_emp_id IN NUMBER) IS
PRAGMA INLINE(calc_bonus, 'YES'); -- ✅ 正确:紧贴声明,函数名+引号值
v_base NUMBER;
BEGIN
SELECT salary * 0.1 INTO v_base FROM employees WHERE employee_id = p_emp_id;
DBMS_OUTPUT.PUT_LINE('Bonus: ' || v_base);
END;
- 常见错误:
PRAGMA INLINE('calc_bonus', 'YES')(括号顺序反了)、PRAGMA INLINE(calc_bonus, YES)('YES' 缺少引号)、写在BEGIN后面 - 若子程序在包内,pragma 必须放在包体(
BODY)中对应子程序声明处,不能放在包规范(SPEC)里
原生编译(native)下 INLINE 效果更明显,但编译时间略增
当开启 plsql_code_type = native 时,内联带来的性能提升通常比解释模式(interpreted)高 10%–30%,尤其在高频调用的小计算逻辑中。但要注意:原生编译本身耗时更长,且生成的机器码不可跨平台迁移。
- 启用方式:
ALTER SESSION SET plsql_code_type = native;,再重新编译存储过程 - 验证是否原生:
SELECT object_name, plsql_code_type FROM user_plsql_object_settings WHERE object_name = 'CALC_BONUS'; - 关键提醒:不要在开发机盲目开 native + inline 做性能测试——编译慢、调试难、堆栈信息不友好;应先用解释模式 + optimize_level=2 确认逻辑正确,再切 native
真正影响内联成败的不是 pragma 本身,而是子程序的“可内联性”:它必须足够轻量、无副作用、无外部依赖。很多开发者写了 pragma 却没效果,问题往往出在子程序悄悄引入了游标或异常处理——这些细节在代码审查时极易被忽略。











