SqlSugar调用Kdbndp存储过程处理数组参数的最佳实践

在使用SqlSugar ORM框架与Kdbndp数据访问组件时，开发者可能会遇到需要调用PostgreSQL存储过程并传递数组参数的情况。本文将详细介绍如何正确处理这种场景。

问题背景

PostgreSQL数据库支持数组类型的参数，在存储过程中可以声明如string[]这样的数组参数。当使用SqlSugar的Kdbndp扩展调用这类存储过程时，需要特别注意参数的传递方式。

解决方案

关键配置

在调用包含数组参数的存储过程时，必须为参数设置IsArray=true属性。这是SqlSugar识别数组类型参数的关键配置项。

代码示例

假设我们有一个PostgreSQL存储过程如下：

CREATE OR REPLACE PROCEDURE TestProc(menus string[])
AS 
BEGIN
   -- 业务逻辑处理
   SELECT c1;
END;

对应的C#调用代码应该这样写：

var result = db.Ado.UseStoredProcedure().GetDataTable("TestProc", new {
    menus = new SugarParameter {
        Value = new string[] {"item1", "item2", "item3"},
        IsArray = true  // 关键配置
    }
});

注意事项

1. 参数类型匹配：确保C#中的数组类型与存储过程参数声明的类型一致
2. 空数组处理：可以传递空数组，但要注意存储过程中的逻辑处理
3. 复杂类型数组：对于自定义类型的数组，需要确保类型映射正确

实现原理

SqlSugar通过Kdbndp组件与PostgreSQL交互时，底层会将C#数组转换为PostgreSQL的数组类型。设置IsArray=true会触发特定的参数转换逻辑，确保数据能够正确传递。

最佳实践建议

1. 对于频繁调用的存储过程，可以考虑封装为Repository方法
2. 在复杂场景下，建议添加参数方向的明确指定（Input/Output）
3. 考虑添加错误处理逻辑，捕获可能的类型转换异常

通过正确配置IsArray属性，开发者可以轻松实现SqlSugar与PostgreSQL存储过程间的数组参数传递，满足各种业务场景需求。