Oracle函数调用SQL Server存储过程遇ORA-06571错误求解决方案

通过Oracle数据库网关调用SQL Server存储过程时遇到如下问题：

• 用@call方式调用Oracle函数可正常运行
• 在SELECT语句中调用该函数时，触发错误：

ORA-06571 Function X does not guarantee not to update database.

已尝试将函数放入包中并使用RESTRICT_REFERENCES(X, WNDS)，但问题仍存在。因业务限制必须在SELECT语句中调用该Oracle函数。

相关代码示例 #

SQL Server存储过程签名 #

PROCEDURE sql_server_proc(@param1 NVARCHAR(255), @param2 NVARCHAR(255), @param3 NVARCHAR(255), @rtn_val1 INT OUT, @rtn_val2 FLOAT OUT);

Oracle函数 #

CREATE OR REPLACE FUNCTION test_func(param1 VARCHAR2, param2 VARCHAR2, param3 VARCHAR2) RETURN INTEGER AS 
BEGIN 
  DECLARE 
    rtn_val1 INTEGER; 
    rtn_val2 NUMBER; 
    rtn_val3 NUMBER; 
    result NUMBER(8, 2); 
  BEGIN 
    result := sql_server_proc@sql_server(param1, param2, param3, rtn_val1, rtn_val2, rnt_val3); 
    COMMIT; 
    RETURN rtn_val1; 
  END; 
END;

报错的SELECT语句 #

SELECT test_func('XYZ', 'ABC', '123DFG') FROM DUAL;

可正常运行的@Call语句 #

@call ${returnValue||(null)||BigDecimal||noshow ds=0 dt=NUMERIC dir=out}$ = test_func('XYZ', 'ABC', '123DFG'); 
@echo returnValue = ${returnValue||(null)||BigDecimal||noshow ds=0 dt=NUMERIC dir=out}$;

1. 移除函数内的COMMIT语句 #

SELECT属于只读上下文，调用的函数不能执行任何修改数据库状态的操作（包括COMMIT、ROLLBACK或DML语句）。你的函数中显式调用了COMMIT，这是触发ORA-06571的核心原因之一。

修改后的函数：

CREATE OR REPLACE FUNCTION test_func(param1 VARCHAR2, param2 VARCHAR2, param3 VARCHAR2) RETURN INTEGER AS 
BEGIN 
  DECLARE 
    rtn_val1 INTEGER; 
    rtn_val2 NUMBER; 
    rtn_val3 NUMBER; 
    result NUMBER(8, 2); 
  BEGIN 
    result := sql_server_proc@sql_server(param1, param2, param3, rtn_val1, rtn_val2, rnt_val3); 
    -- 移除COMMIT语句
    RETURN rtn_val1; 
  END; 
END;

2. 显式声明函数的只读属性（适配不同Oracle版本） #

方法一：使用PRAGMA RESTRICT_REFERENCES（Oracle 11g及更早版本） #

即使将函数放入包中，也需要在函数内部显式添加约束声明，确保Oracle识别函数不会修改数据库状态。独立函数写法：

CREATE OR REPLACE FUNCTION test_func(param1 VARCHAR2, param2 VARCHAR2, param3 VARCHAR2) RETURN INTEGER AS 
  PRAGMA RESTRICT_REFERENCES(test_func, WNDS, WNPS);
BEGIN 
  DECLARE 
    rtn_val1 INTEGER; 
    rtn_val2 NUMBER; 
    rtn_val3 NUMBER; 
    result NUMBER(8, 2); 
  BEGIN 
    result := sql_server_proc@sql_server(param1, param2, param3, rtn_val1, rtn_val2, rnt_val3); 
    RETURN rtn_val1; 
  END; 
END;

• WNDS：保证函数不修改数据库状态
• WNPS：保证函数不修改包变量

包内函数需在包规范中添加约束：

CREATE OR REPLACE PACKAGE test_pkg AS
  FUNCTION test_func(param1 VARCHAR2, param2 VARCHAR2, param3 VARCHAR2) RETURN INTEGER;
  PRAGMA RESTRICT_REFERENCES(test_func, WNDS, WNPS);
END test_pkg;
/

CREATE OR REPLACE PACKAGE BODY test_pkg AS
  FUNCTION test_func(param1 VARCHAR2, param2 VARCHAR2, param3 VARCHAR2) RETURN INTEGER AS 
  BEGIN 
    DECLARE 
      rtn_val1 INTEGER; 
      rtn_val2 NUMBER; 
      rtn_val3 NUMBER; 
      result NUMBER(8, 2); 
    BEGIN 
      result := sql_server_proc@sql_server(param1, param2, param3, rtn_val1, rtn_val2, rnt_val3); 
      RETURN rtn_val1; 
    END; 
  END;
END test_pkg;
/

方法二：使用DETERMINISTIC和PARALLEL_ENABLE（Oracle 11g及以后版本） #

Oracle 11g之后推荐用这些属性替代RESTRICT_REFERENCES，更简洁且利于优化器识别：

CREATE OR REPLACE FUNCTION test_func(param1 VARCHAR2, param2 VARCHAR2, param3 VARCHAR2) 
RETURN INTEGER 
DETERMINISTIC 
PARALLEL_ENABLE 
AS 
BEGIN 
  DECLARE 
    rtn_val1 INTEGER; 
    rtn_val2 NUMBER; 
    rtn_val3 NUMBER; 
    result NUMBER(8, 2); 
  BEGIN 
    result := sql_server_proc@sql_server(param1, param2, param3, rtn_val1, rtn_val2, rnt_val3); 
    RETURN rtn_val1; 
  END; 
END;

• DETERMINISTIC：表明相同输入参数会返回相同结果（需确保SQL Server存储过程符合此特性）
• PARALLEL_ENABLE：允许函数在并行查询中使用，同时隐含函数无副作用

3. 若SQL Server存储过程包含写操作：使用自治事务 #

如果SQL Server存储过程本身会修改数据（必须执行COMMIT），则需要将远程调用放入自治事务中，让函数事务与SELECT主事务隔离，Oracle不会认为函数修改了主事务的数据库状态。

修改后的函数：

CREATE OR REPLACE FUNCTION test_func(param1 VARCHAR2, param2 VARCHAR2, param3 VARCHAR2) RETURN INTEGER AS 
  PRAGMA AUTONOMOUS_TRANSACTION;
BEGIN 
  DECLARE 
    rtn_val1 INTEGER; 
    rtn_val2 NUMBER; 
    rtn_val3 NUMBER; 
    result NUMBER(8, 2); 
  BEGIN 
    result := sql_server_proc@sql_server(param1, param2, param3, rtn_val1, rtn_val2, rnt_val3); 
    COMMIT; -- 自治事务内可执行COMMIT
    RETURN rtn_val1; 
  END; 
END;

注意：自治事务是独立的，提交/回滚不会影响主事务，需确保业务逻辑允许这种隔离。

内容的提问来源于stack exchange，提问作者BobTheCultist