人大金仓 .NET 操作数据库


SqlSugar和人大金仓官方深度整合,SqlSugar在人大金仓是最好的,不光光C#最好,所有语言中是最好的,并且支持Oracle模式的存储过程和游标等。

并且可以有官方的支持,.NET下人大金仓整合最好的ORM

1、Nuget安装ORM

SqlSugarCore

2、数据库版本

每个版本都有些注意点,有些需要提定一下模式,有些需要升级一下nuget

R3 老版本

直接安装 和使用

R6:Oracle模式(推荐默认 )

 直接安装 和使用 ,兼容PG语法(推荐 )

R6:MySql模式  

升级到 5.1.4.152+

SqlSugarClient db = new SqlSugarClient(new ConnectionConfig()
{
    DbType = DbType.Kdbndp,
    ConnectionString ="Server=127.0.0.1;Port=54321;UID=SYSTEM;PWD=system;database=SQLSUGAR4XTEST1", 
    IsAutoCloseConnection = true, 
    MoreSettings=new ConnMoreSettings()
    { 
        //SqlSugarCore  升级到 5.1.4.152 +
        DataBaseModel= DbType.MySql//配置MySql模式主要是兼容系统表差异
    }
})

R6:PostgreSQL模式(需配置)

配置一下pg模式如下

SqlSugarClient db = new SqlSugarClient(new ConnectionConfig()
{
    DbType = DbType.Kdbndp,
    ConnectionString ="Server=127.0.0.1;Port=54321;UID=SYSTEM;PWD=system;database=SQLSUGAR4XTEST1", 
    IsAutoCloseConnection = true, 
    MoreSettings=new ConnMoreSettings()
    { 
        //SqlSugarCore  升级到 5.1.4.146 +
        DataBaseModel= DbType.PostgreSQL//配置PG模式主要是兼容系统表差异
    }
})

R6:SqlServer模式(需配置) 

SqlSugarClient db = new SqlSugarClient(new ConnectionConfig()
{
    DbType = DbType.Kdbndp,
    ConnectionString ="Server=127.0.0.1;Port=54321;UID=SYSTEM;PWD=system;database=SQLSUGAR4XTEST1", 
    IsAutoCloseConnection = true, 
    MoreSettings=new ConnMoreSettings()
    { 
       //SqlSugarCore 升级到 5.1.4.146 +
       DataBaseModel= DbType.SqlServer//配置SqlServer模式主要是兼容CodeFirst报错
       
      //该模式下已知问题:   
      //SqlServer模式下不支持Date类型请使用DateTime类型
      //时间.Date==时间.Date要改成it.时间.ToString("yyyy-MM-dd")==时间.ToString("yyyy-MM-dd")
    }
})

3、表模式

2种模式用法小有区别,推荐规范表

1. 规范表: 自动转大写  

2. 驼峰表: 不自动转大写

规范(自动转大写) 

表名 STUDENT  字段 ID  NAME   ,直接用就行了SqlSugar不需要设置

 SqlSugarClient db = new SqlSugarClient(new ConnectionConfig()
 {
       DbType = DbType.Kdbndp,
       ConnectionString ="Server=127.0.0.1;Port=54321;UID=SYSTEM;PWD=system;database=SQLSUGAR4XTEST1",
       IsAutoCloseConnection = true
 });
  //自动生成下划线看PostgreSQL文档用法差不多

不规范(不转换大写)

 需要配置禁用转大写

 SqlSugarClient db = new SqlSugarClient(new ConnectionConfig()
 {
       DbType = DbType.Kdbndp,
       ConnectionString = "Server=127.0.0.1;Port=54321;UID=SYSTEM;PWD=system;database=SQLSUGAR4XTEST1",
       IsAutoCloseConnection = true,
       MoreSettings=new ConnMoreSettings() { 
           IsAutoToUpper=false //禁用自动转成大写表 5.1.3.41-preview08
       }
   });
  //注意:请升级到 5.1.3.41-preview08 以上版本

4、人大金仓优点

 基本上和PgSql一模一样更贴近开发功能也继承了pgsql所有功能,对开发人员比较友好

5、操作人大金仓数据库

 SqlSugarClient db = new SqlSugarClient(new ConnectionConfig()
 {
            ConnectionString = "Server=.xxxxx",//连接符字串
            DbType = DbType.Kdbndp, //数据库类型
            IsAutoCloseConnection = true //不设成true要手动close
 });

查询

db.Queryable<Student>().ToList()//查询所有
db.Queryable<Student>().Where(it=>it.Id==1).ToList()//根据条件查询

//分页  int pageIndex = 1; // pageindex是从1开始的不是从零开始的
  int pageSize = 20;
  int totalCount=0;
  //单表分页
  var page = db.Queryable<Student>().ToPageList(pageIndex, pageSize, ref totalCount);

插入

//返回插入行数
db.Insertable(insertObj).ExecuteCommand(); //都是参数化实现 
//插入返回自增列
db.Insertable(insertObj).ExecuteReturnIdentity(); 
//返回雪花ID 看文档3.1具体用法(在最底部)
long id= db.Insertable(实体).ExecuteReturnSnowflakeId();

更多用法看左边菜单

6、架构支持 schema(非Public)

5.1.3.35-preview19 +

连接字符串上加上 searchpath=架构名  ,可以支持多架构

7、字符串空判段问题

XI(LJ0SUBJ_R%(BO1(TTGEH.png

8、.NET Framework用户dll

需要引用的dll ,官方定制比外面找的dll更加强大  ( .NET Core用户直接安装SqlSugarCore就可以了)

Kdbndp_dll.rar

9、查看安装的模式

show database_mode;

10、游标参数

升级:SqlSugarCore 5.1.4.149+

//1.字符串加上
;CursorAsDataRead=True

//2.具体用法
var p = new SugarParameter("@outcursor", null)
{ 
   IsRefCursor = true,
   Direction = System.Data.ParameterDirection.Output 
};
db.Ado.UseStoredProcedure().ExecuteCommand("cs_20240312",p );
Console.WriteLine(p.Value);

11、数组类型

//实体
SugarColums(IsArray=true)
//Sql参数
new SugarParameter("Names",array){ IsArray=true }

12、常见问题

 11.1 string ==""无效

oracle模式下没空只有null, 多库用户可以配置一下off参数

ora_input_emptystr_isnull = off  这个参数放到,kingbase.conf的结尾就可以。
关闭
果糖网