sql宏不是动态sql，不能拼接表名或列名；它是在编译时内联展开的语法糖，所有对象名必须写死，仅支持标量参数传值，不接受变量注入对象名，也不支持运行时转义。
sql宏不是动态sql，不能拼接表名或列名
oracle 21c 的 sql_macro 是编译时内联展开的语法糖，不是运行时字符串拼接。它不接受变量注入对象名（如 @tablename），也不支持 quotename() 那类运行时转义。如果你试图用宏替换表名或排序字段，会直接报错 ora-64625: invalid identifier in sql macro 或编译失败。
它的适用场景很明确：封装可复用的、结构固定但参数可变的查询逻辑，比如统一的时间范围过滤、状态码映射、租户隔离条件。所有对象名（表、列）必须在宏定义时写死，仅允许标量参数（NUMBER、VARCHAR2、DATE）传入值。
- ✅ 正确：宏里写死
orders表，用p_start_date参数控制时间范围 - ❌ 错误：试图用
p_table_name参数动态指定表名
定义函数式SQL宏实现参数化过滤
用 SQL_MACRO(SCALAR) 定义一个返回 WHERE 片段的宏，然后在存储过程中直接嵌入到静态 SQL 中。这样既避免了动态拼接，又能让优化器复用执行计划。
示例：
CREATE OR REPLACE FUNCTION filter_by_status(p_status VARCHAR2) RETURN VARCHAR2 SQL_MACRO(SCALAR) AS BEGIN RETURN q'[ AND status = p_status ]'; END;
在存储过程中调用：
SELECT order_id, amount
FROM orders
WHERE created_date >= SYSDATE - 7
&& filter_by_status('SHIPPED');
注意：&& 是宏调用语法，不是字符串连接符；p_status 会被原样代入，由外部 SQL 的绑定变量机制保障安全。
- 宏体中不能出现 DML、DDL 或 PL/SQL 控制流
- 参数必须声明为标量类型，不能是
REF CURSOR或记录类型 - 宏展开后整个 SQL 仍是一条静态语句，
EXPLAIN PLAN可见完整执行路径
组合多个宏实现多条件动态开关
当筛选条件数量不固定时，不要用 IF 分支拼 SQL 字符串，而是用多个宏 + 布尔逻辑控制是否生效。每个宏返回空字符串或有效条件片段，主查询用 AND (1=1 OR ...) 包裹确保语法合法。
例如：
CREATE OR REPLACE FUNCTION filter_by_region(p_region VARCHAR2)
RETURN VARCHAR2 SQL_MACRO(SCALAR) AS
BEGIN
IF p_region IS NULL THEN
RETURN q'[ AND 1=1 ]'; -- 空条件占位
ELSE
RETURN q'[ AND region = p_region ]';
END IF;
END;
调用方式：
SELECT * FROM sales WHERE 1=1 && filter_by_region(v_region_param) && filter_by_amount(v_min_amt, v_max_amt);
这种写法下，无论参数是否为空，生成的最终 SQL 都是静态的，执行计划稳定，且无注入风险——因为所有拼接都在编译期完成，参数只参与值绑定。
- 宏返回的字符串必须是合法 SQL 片段，不能含分号或
WHERE关键字（主 SQL 已有） - 多个宏叠加时，注意括号层级和运算符优先级，建议统一用
AND (...)包裹每个条件 - 调试方法：用
DBMS_OUTPUT.PUT_LINE打印宏展开后的实际 SQL（需开启SQL_MACRO调试模式）
与传统动态SQL对比的关键差异点
宏方案无法替代真正需要对象名动态化的场景（如按月分表查 log_202406）。这时你仍得用 EXECUTE IMMEDIATE + DBMS_ASSERT 校验，但要注意：
-
SQL_MACRO生成的 SQL 在硬解析阶段就确定，共享池中只存一份执行计划；而EXECUTE IMMEDIATE每次不同文本都会产生新计划，易导致缓存污染 - 宏的参数天然绑定，无需手动写
USING子句；动态SQL 必须显式声明所有参数，漏一个就会报ORA-01008 - 宏不支持游标返回，复杂结果集仍需传统 REF CURSOR；但简单过滤逻辑用宏更轻量、更易测试
真正要警惕的是把宏当成“安全版动态SQL”来用——它根本不是为那个目的设计的。该用白名单+DBMS_ASSERT.SIMPLE_SQL_NAME 的地方，别硬塞宏进去绕弯子。
