PAYATHON 2026

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;不需要传时省略该参数,需要传时按集合类型处理。

原因

  1. ODP.NET 在 CommandType.StoredProcedure 下会把 CommandText 当作过程名或函数名,并自行生成 PL/SQL 调用块。若把参数列表也写进 CommandText,容易出现绑定变量重复或未绑定的情况,从而触发 ORA-01008: not all variables bound。
  2. CREATE_TUNING_TASK 是函数,返回 VARCHAR2 任务名。用 StoredProcedure 方式调用时,需要添加 ParameterDirection.ReturnValue 参数;用匿名 PL/SQL 块调用时,则要用 ParameterDirection.Output 接收 :id。
  3. sql_binds 的形参类型是 SQL_BINDS,不是 CLOB。当前不需要传 SQL binds 时,直接不绑定该参数,让默认值 NULL 生效;必须传时,再按 ODP.NET 的集合/关联数组方式绑定。
  4. 读取函数返回值时,建议执行 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 后再读参数值。

备注:内容仅供参考。