求助：如何在Oracle存储过程中接收.NET传入的动态多值参数

我之前在项目里多次碰到这种.NET传多值到Oracle存储过程用于WHERE IN的场景，给你整理几个实用的方案，从快速实现到规范写法都有：

这是最直接的实现方式，不需要额外定义类型，适合参数长度不大的简单场景。

存储过程实现 #

接收varchar2类型的参数，用Oracle的REGEXP_SUBSTR和递归查询把逗号分隔的字符串拆分成多行，再用于IN子句：

CREATE OR REPLACE PROCEDURE proc_get_target_data(p_ids IN VARCHAR2, cur_result OUT SYS_REFCURSOR)
IS
BEGIN
    OPEN cur_result FOR
        SELECT t.* 
        FROM your_target_table t
        WHERE t.id IN (
            -- 拆分逗号分隔的字符串，TRIM处理可能的空格
            SELECT TRIM(REGEXP_SUBSTR(p_ids, '[^,]+', 1, LEVEL))
            FROM dual
            CONNECT BY REGEXP_SUBSTR(p_ids, '[^,]+', 1, LEVEL) IS NOT NULL
        );
END;
/

.NET端调用 #

把多个值用逗号拼接成字符串，直接作为参数传递即可：

// 拼接参数，支持单个值（如"1001"）或多个值（如"1001,1002,1003"）
string idParam = string.Join(",", new List<string> { "1001", "1002", "1003" });

using (var conn = new OracleConnection("your_connection_string"))
{
    conn.Open();
    using (var cmd = new OracleCommand("proc_get_target_data", conn))
    {
        cmd.CommandType = CommandType.StoredProcedure;
        // 传入字符串参数
        cmd.Parameters.Add("p_ids", OracleDbType.Varchar2, idParam, ParameterDirection.Input);
        // 输出游标参数
        cmd.Parameters.Add("cur_result", OracleDbType.RefCursor, ParameterDirection.Output);
        
        using (var reader = cmd.ExecuteReader())
        {
            while (reader.Read())
            {
                // 处理查询结果
                Console.WriteLine(reader["id"] + " : " + reader["name"]);
            }
        }
    }
}

注意事项 #

• 确保拼接的字符串没有多余的逗号（比如不要写成"1001,1002,"）
• 根据实际数据长度调整存储过程中p_ids的varchar2长度（比如varchar2(2000)）
• 如果参数来自用户输入，要做合法性校验（比如限制只能是数字/合法字符），避免潜在的SQL注入风险

如果追求类型安全和更好的性能，尤其是参数值较多的场景，推荐用Oracle的嵌套表类型来传递数组。

第一步：定义嵌套表类型 #

先在Oracle中创建一个用于存储字符串列表的类型：

CREATE OR REPLACE TYPE t_string_list IS TABLE OF VARCHAR2(50);
/

第二步：编写存储过程 #

接收自定义的嵌套表类型参数，用TABLE()函数转成行集用于IN子句：

CREATE OR REPLACE PROCEDURE proc_get_target_data(p_ids IN t_string_list, cur_result OUT SYS_REFCURSOR)
IS
BEGIN
    OPEN cur_result FOR
        SELECT t.* 
        FROM your_target_table t
        WHERE t.id IN (SELECT column_value FROM TABLE(p_ids));
END;
/

.NET端调用 #

通过OracleParameter的CollectionType属性传递数组：

var idList = new List<string> { "1001", "1002", "1003" };

using (var conn = new OracleConnection("your_connection_string"))
{
    conn.Open();
    using (var cmd = new OracleCommand("proc_get_target_data", conn))
    {
        cmd.CommandType = CommandType.StoredProcedure;
        
        // 配置数组参数
        var idParam = new OracleParameter("p_ids", OracleDbType.Varchar2, idList.Count, ParameterDirection.Input);
        idParam.CollectionType = OracleCollectionType.PLSQLAssociativeArray;
        idParam.Value = idList.ToArray();
        cmd.Parameters.Add(idParam);
        
        // 输出游标参数
        cmd.Parameters.Add("cur_result", OracleDbType.RefCursor, ParameterDirection.Output);
        
        using (var reader = cmd.ExecuteReader())
        {
            while (reader.Read())
            {
                // 处理结果
            }
        }
    }
}

注意事项 #

• 这个方案完全避免了SQL注入风险，因为参数是类型化的数组
• 适合传递大量参数值，性能比字符串拆分更好
• 需要确保Oracle客户端版本和.NET驱动版本兼容，支持集合类型传递

如果你的项目已经在使用JSON处理数据，或者需要传递更复杂的参数结构，用JSON数组是个不错的选择（要求Oracle 12c及以上版本）。

存储过程实现 #

接收JSON格式的字符串参数，用JSON_TABLE解析成行集：

CREATE OR REPLACE PROCEDURE proc_get_target_data(p_ids_json IN VARCHAR2, cur_result OUT SYS_REFCURSOR)
IS
BEGIN
    OPEN cur_result FOR
        SELECT t.* 
        FROM your_target_table t
        WHERE t.id IN (
            SELECT value 
            FROM JSON_TABLE(p_ids_json, '$[*]' COLUMNS value VARCHAR2(50) PATH '$')
        );
END;
/

.NET端调用 #

把列表序列化成JSON字符串，再传递给存储过程：

var idList = new List<string> { "1001", "1002", "1003" };
// 序列化列表为JSON数组字符串，比如：["1001","1002","1003"]
string jsonParam = Newtonsoft.Json.JsonConvert.SerializeObject(idList);

using (var conn = new OracleConnection("your_connection_string"))
{
    conn.Open();
    using (var cmd = new OracleCommand("proc_get_target_data", conn))
    {
        cmd.CommandType = CommandType.StoredProcedure;
        cmd.Parameters.Add("p_ids_json", OracleDbType.Varchar2, jsonParam, ParameterDirection.Input);
        cmd.Parameters.Add("cur_result", OracleDbType.RefCursor, ParameterDirection.Output);
        
        using (var reader = cmd.ExecuteReader())
        {
            while (reader.Read())
            {
                // 处理结果
            }
        }
    }
}

注意事项 #

• 要求Oracle版本在12c及以上，因为JSON_TABLE是12c新增的函数
• 可以轻松扩展传递更复杂的参数结构（比如嵌套JSON）
• 同样需要注意JSON字符串的长度限制

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