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

人大金仓优点

人大金仓是国产最主流ORM之一

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

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

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

Nuget安装ORM

SqSugar和人大金仓官方有深度整合，SqlSugar在人大金仓的支持上是一流的，并且支持Oracle模式的存储过程等。

并且可以有官方的支持，经过多年与金仓团队合作可以说SqlSugar是.NET下人大金仓整合最好的ORM，同时支持了

R3、 R6 Oracle模式、R6PgSql模式 、R6MySql模式和R6SqlServer模式

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、字符串空判段问题

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的结尾就可以。