使用IBM.EntityFrameworkCore调用Db2存储过程时遇SQL0451N错误求助

错误信息 #

IBM.Data.Db2.DB2Exception (0x80004005): ERROR [42815] [IBM][AS] SQL0451N  
The "1" definition, in the statement that defines routine "*N        ", 
contains a data type "FOOSCHEMA.FOONAME" that is not appropriate for a non-sourced routine 
written in the given language or a routine that is defined as autonomous.
   at IBM.Data.Db2.DB2Connection.HandleError(IntPtr hHandle, SQL_HANDLE hType, RETCODE retcode)
   at IBM.Data.Db2.DB2Command.ExecuteNonQueryObject(Boolean skipInitialValidation)
   at IBM.Data.Db2.DB2Command.ExecuteNonQueryObject()
   at IBM.Data.Db2.DB2Command.ExecuteNonQuery()

调用代码 #

using var db2 = await db2Context.CreateDbContextAsync();
using var command = db2.Database.GetDbConnection().CreateCommand();

command.CommandText = "call FOOSCHEMA.FOONAME(?, ?, ?, ?, ?)";
command.CommandType = System.Data.CommandType.Text;

command.Parameters.Add(new DB2Parameter
{
    ParameterName = "FooInputParam",
    Value = "ST",
    Direction = System.Data.ParameterDirection.Input,
    DB2Type = DB2Type.Char,
    Size = 2,
});

command.Parameters.Add(new DB2Parameter
{
    ParameterName = "FooInputOutputParam",
    Direction = System.Data.ParameterDirection.InputOutput,
    DB2Type = DB2Type.Char,
    Size = 500
});

/* 3 additional `Input` params redacted */

await db2.Database.OpenConnectionAsync();
var commandResult = await command.ExecuteNonQueryAsync(); // ERROR HERE

环境详情 #

• .NET 8应用
  • Microsoft.EntityFrameworkCore 8.0.2
  • IBM.EntityFrameworkCore 8.0.0.200
• Db2 for i
  • 7.4
  • Level 26

说明：当前环境可正常调用其他Db2存储过程，目标存储过程签名见附图。

排查及解决思路 #

• 检查存储过程参数的自定义类型冲突
  SQL0451N错误提到的数据类型FOOSCHEMA.FOONAME，大概率是存储过程参数使用了与自身同名的自定义类型（如UDT、行类型）。Db2 for i的非源化例程或自治例程对复杂自定义类型有使用限制：

  1. 执行SQL查询参数详情：SELECT * FROM QSYS2.ROUTINE_PARAMETERS WHERE SPECIFIC_SCHEMA = 'FOOSCHEMA' AND SPECIFIC_NAME = 'FOONAME'，确认是否存在自定义类型参数。
  2. 若存在自定义类型，检查该类型是否符合存储过程编写语言（如SQL、CLR）的支持规范，自治例程对类型的限制更严格。

• 修正参数匹配与初始化

  1. 确认存储过程的参数数量、方向（输入/输出/输入输出）与代码定义完全一致，确保call语句的?数量和实际参数数匹配。
  2. 给输入输出参数设置初始值（如Value = string.Empty），Db2 for i部分场景要求输入输出参数必须有初始值才能正常调用。

• 调整CommandType调用方式
  尝试将CommandType改为StoredProcedure，让驱动自动处理参数映射，避免手动构造call语句的类型解析问题：

  command.CommandText = "FOOSCHEMA.FOONAME";
  command.CommandType = System.Data.CommandType.StoredProcedure;
  

• 验证版本兼容性
  当前IBM.EntityFrameworkCore 8.0.0.200与Microsoft.EntityFrameworkCore 8.0.2存在小版本差异，尝试升级IBM.EntityFrameworkCore到最新兼容补丁版，或确认该版本对Db2 for i 7.4 Level 26的自定义类型解析支持情况。

• 检查存储过程的自治属性
  自治例程对数据类型使用有严格限制，执行SQL查询存储过程属性：SELECT ROUTINE_DEFINITION, AUTONOMOUS FROM QSYS2.SYSPROCS WHERE SCHEMA_NAME = 'FOOSCHEMA' AND PROCEDURE_NAME = 'FOONAME'：

  1. 若为自治例程，确保所有参数使用Db2内置数据类型，而非自定义类型。
  2. 若必须使用自定义类型，需修改存储过程为非自治，或调整自定义类型的定义以符合自治例程要求。

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