C# 操作国产数据库【 人大金仓 】之四大模式

人大金仓优点

人大金仓是国产最主流数据库之一

具有和PgSql一样强悍的性能,同时人大金仓支持了四种数据库模式 :

Oracle、PgSql、MySql和SqlServer ,假如你们系统有多种数据库开发

有国产化要求,那么你们切换到人大金仓就会很方便了

Nuget安装ORM

SqSugar和人大金仓官方有深度整合,SqlSugar在人大金仓的支持上是一流的,支持Oracle模式的存储过程、Schema

并且支持 R3、 R6 Oracle模式、R6PgSql模式 、R6MySql模式和R6SqlServer模式

和金仓官方有多年合作,经过多年努力可以说SqlSugar是.NET下人大金仓整合最好的ORM

复制代码
SqlSugarCore
SqlSugarCore.Kdbndp

数据库版本配置

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

R3 老版本

直接安装 和使用

R6:Oracle模式(推荐默认 )

支持存储过程 和 PostgreSQL语法 (推荐)

R6:MySql模式 ( 需要独立最新 )

SqlSugarCore.Kdbndp 到最新版本

R6:PostgreSQL模式(需配置)

配置一下pg模式如下

复制代码
//SqlSugarCore 5.1.4.143-preview08 支持
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.143
        DataBaseModel= DbType.PostgreSQL//配置PG模式主要是兼容系统表差异
    }
})

R6:SqlServer模式(需配置)

如何要使用CodeFirst需要配置

复制代码
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.144-preview16+ 支持
        DataBaseModel= DbType.SqlServer//配置SqlServer模式主要是兼容CodeFirst报错
    }
})

已知问题:

1、Date类型不支持,只支持DateTime类型 金仓官方在开发了

2、it.时间.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 以上版本  

5、操作人大金仓数据库

复制代码
using SqlSugar;
 

SqlSugarClient Db = new SqlSugarClient(new ConnectionConfig()
{
    ConnectionString = "datasource=demo.db",
    DbType = DbType.Kdbndp,//MySql和SqlServer模式看上面需要配置DatabaseModel
    IsAutoCloseConnection = true
});
 
//建库
Db.DbMaintenance.CreateDatabase();//达梦和Oracle不支持建库
 
//建表(看文档迁移)
Db.CodeFirst.InitTables<Student>(); //所有库都支持     
 
//查询表的所有
var list = Db.Queryable<Student>().ToList();
 
//插入
Db.Insertable(new Student() { SchoolId = 1, Name = "jack" }).ExecuteCommand();
 
//更新
Db.Updateable(new Student() { Id = 1, SchoolId = 2, Name = "jack2" }).ExecuteCommand();
 
//删除
Db.Deleteable<Student>().Where(it => it.Id == 1).ExecuteCommand();
  
 
//实体与数据库结构一样
public class Student
{
    //数据是自增需要加上IsIdentity 
    //数据库是主键需要加上IsPrimaryKey 
    //注意:要完全和数据库一致2个属性
    [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
    public int Id { get; set; }
    public int? SchoolId { get; set; }
    public string? Name { get; set; }
}

6、架构支持 schema(非Public)

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

7、字符串空判段问题

XI(LJ0SUBJ_R%(BO1(TTGEH.png

8、.NET Framework用户dll

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

Kdbndp_dll.rar framework用户用R6Oracle或者R3 只有.NET Core支持了四种模式

9、常见问题

9.1 string ==""无效

oracle模式下没空只有null, 多库用户可以配置一下off参数
ora_input_emptystr_isnull = off 这个参数放到,kingbase.conf的结尾就可以。