C# 调用 DBMS_SQLTUNE.CREATE_TUNING_TASK 报 ORA-01008
数据小陈
结论:这里主要不是少了一个普通输入参数。问题在于,当 CommandType = CommandType.StoredProcedure 时,CommandText 不应再写成带 (:sql_text, ...) 的完整调用串。DBMS_SQLTUNE.CREATE_TUNING_TASK 是函数,返回值要用 ReturnValue 参数接收。sql_binds 的类型是 SQL_BINDS 集合,不是 CLOB;不需要传时省略该参数,需要传时按集合类型处理。
原因
- ODP.NET 在
CommandType.StoredProcedure下会把CommandText当作过程名或函数名,并自行生成 PL/SQL 调用块。若把参数列表也写进CommandText,容易出现绑定变量重复或未绑定的情况,从而触发ORA-01008: not all variables bound。 CREATE_TUNING_TASK是函数,返回VARCHAR2任务名。用StoredProcedure方式调用时,需要添加ParameterDirection.ReturnValue参数;用匿名 PL/SQL 块调用时,则要用ParameterDirection.Output接收:id。sql_binds的形参类型是SQL_BINDS,不是CLOB。当前不需要传 SQL binds 时,直接不绑定该参数,让默认值NULL生效;必须传时,再按 ODP.NET 的集合/关联数组方式绑定。- 读取函数返回值时,建议执行
ExecuteNonQueryAsync后读取ReturnValue参数,不要依赖ExecuteScalarAsync的返回行为。
推荐写法:使用 StoredProcedure
让 CommandText 只写函数名,参数名与形参名一致,可选参数可以省略:
cmd.CommandText = "DBMS_SQLTUNE.CREATE_TUNING_TASK";
cmd.CommandType = CommandType.StoredProcedure;
cmd.BindByName = true;
cmd.Parameters.Add("sql_text", OracleDbType.Clob, query, ParameterDirection.Input);
// 不需要 sql_binds 时不添加,让默认 NULL 生效
cmd.Parameters.Add("scope", OracleDbType.Varchar2, "COMPREHENSIVE", ParameterDirection.Input);
cmd.Parameters.Add("time_limit", OracleDbType.Int32, 1800, ParameterDirection.Input);
// 其他可选参数按需添加;若添加,使用正确的 OracleDbType 和 DBNull.Value
cmd.Parameters.Add("id", OracleDbType.Varchar2, ParameterDirection.ReturnValue);
await cmd.ExecuteNonQueryAsync(token).ConfigureAwait(false);
var taskName = cmd.Parameters["id"].Value?.ToString();
如果确实要显式把 sql_binds 绑定为 NULL,应使用与 SQL_BINDS 匹配的集合绑定方式,不要用 OracleDbType.Clob 强塞 DBNull.Value。不确定集合怎么绑时,优先省略该参数。
备选写法:使用匿名 PL/SQL 块
cmd.CommandType = CommandType.Text;
cmd.CommandText = @"
BEGIN
:id := DBMS_SQLTUNE.CREATE_TUNING_TASK(
sql_text => :sql_text,
sql_binds => NULL,
user_name => NULL,
scope => :scope,
time_limit => :time_limit,
task_name => NULL,
description => NULL,
con_name => NULL,
database_link_to => NULL
);
END;";
cmd.BindByName = true;
cmd.Parameters.Add("id", OracleDbType.Varchar2, ParameterDirection.Output);
cmd.Parameters.Add("sql_text", OracleDbType.Clob, query, ParameterDirection.Input);
cmd.Parameters.Add("scope", OracleDbType.Varchar2, "COMPREHENSIVE", ParameterDirection.Input);
cmd.Parameters.Add("time_limit", OracleDbType.Int32, 1800, ParameterDirection.Input);
await cmd.ExecuteNonQueryAsync(token).ConfigureAwait(false);
var taskName = cmd.Parameters["id"].Value?.ToString();
匿名块里 :id 是 Output,不是 ReturnValue;sql_binds => NULL 表示本次不传 SQL binds。需要传 binds 时,请按集合类型绑定,不能当 CLOB 传。
注意事项
- 不要再同时使用“带
:参数的CommandText”和CommandType.StoredProcedure。 - 参数名建议与函数形参名完全一致;设置
BindByName = true后,尤其要检查拼写。 - 如果仍然报
ORA-01008,先检查CommandText中是否还有未绑定的:name,再确认参数是否重复添加、方向是否正确。 ExecuteScalarAsync与ReturnValue参数搭配时,不同 ODP.NET 版本的行为可能不同。读取函数返回值更稳妥的做法,是执行ExecuteNonQueryAsync后再读参数值。
备注:内容仅供参考。
