[开源] .Net 使用 ORM 访问 人大金仓数据库

前言

京人大金仓信息技术股份有限公司（以下简称“人大金仓”）是具有自主知识产权的国产数据管理软件与服务提供商。人大金仓由中国人民大学一批最早在国内开展数据库教学、科研、开发的专家于1999年发起创立，先后承担了国家“863”、“核高基”等重大专项，研发出了具有国际先进水平的大型通用数据库产品。2018年，人大金仓申报的“数据库管理系统核心技术的创新与金仓数据库产业化”项目荣获2018年度国家科学技术进步二等奖，产学研的融合进一步助力国家信息化建设。

随着华为、中兴事务，国产数据库市场相信是未来是趋势走向，纵观 .net core 整个圈子对国产人大金仓数据库的支持几乎为 0，今天我们使用 FreeSql ORM 来体验国产人大金仓数据库（虽然是拿pgsql源码修改的）。

整体来讲，人大金仓对 Oracle 语法有着 90% 的兼容性，但还有一些细节需要注意，FreeSql 对此做了优化进行了完美支持。

1、安装环境

数据库服务器：KingbaseES V8

下载地址：https://www.kingbase.com.cn/index/service/c_id/212.html

.NET版本：.net core 3.1

下载地址：https://dotnet.microsoft.com/learn/dotnet/hello-world-tutorial/install

开发机器 ：windows 10

ODBC驱动：

由于人大金仓数据库目前只能使用 ODBC 驱动访问数据库，如果成功安装了 KingbaseES V8，然后我们查看系统 ODBC，正常的话会显示如下：

2、创建项目

我们以 console 类型项目试验 插入、删除、更新、查询 等功能，创建控制台项目，使用命令：

dotnet new console

dotnet add package FreeSql.Provider.Odbc

dotnet add package FreeSql.Repository

3、创建实体模型

using System;
using FreeSql.DataAnnotations;

public class User
{
    [Column(IsIdentity = true)]
    public long Id { get; set; }

    public string UserName { get; set; }

    public string PassWord { get; set; }

    public DateTime CreateTime { get; set; }
}

4、初始化 ORM

static IFreeSql fsql = new FreeSql.FreeSqlBuilder()
    .UseConnectionString(FreeSql.DataType.OdbcKingbaseES, 
    "Driver={KingbaseES 8.2 ODBC Driver ANSI};Server=127.0.0.1;Port=54321;UID=USER2;PWD=123456789;database=TEST")
    .UseMonitorCommand(cmd => Trace.WriteLine($"线程：{cmd.CommandText}
"))
    .UseAutoSyncStructure(true) //自动创建、迁移实体表结构
    .UseNameConvert(NameConvertType.ToUpper)
    .Build();

5、插入数据

var repo = fsql.GetRepository<User>();

var user = new User { UserName = "kingbase1", PassWord = "123" };
repo.Insert(user);

var users = new []
{
    new User { UserName = "kingbase2", PassWord = "1234" },
    new User { UserName = "kingbase3", PassWord = "12345" },
    new User { UserName = "kingbase4", PassWord = "123456" }
};
repo.Insert(users);
//批量插入

6、更新数据

user.PassWord = "123123";
repo.Update(user);

7、查询数据

var one = fsql.Select<User>(1).First(); //查询一条数据

var list = fsql.Select<User>().Where(a => a.UserName.StartsWith("kingbase")).ToList();

8、删除数据

fsql.Delete<User>(1).ExecuteAffrows();

fsql.Delete<User>().Where(a => a.UserName.StartsWith("kingbase")).ExecuteAffrows();

结语

这篇文章简单介绍了在 .net core 3.1 环境中使用 FreeSql 对国产人大金仓数据库的访问，目前 FreeSql 还支持 .net framework 4.0 和 xamarin 平台上使用。

国产数据库未来是发展趋势，拥有自主权不受他人限制，我在好几个群里看到有人说公司正准备全面使用国产系统+国产数据库。

除了 增删查改，FreeSql 还支持很多功能，就不一一演示，一篇文章介绍不完。

FreeSql 是 .NETCore/.NetFramework/Xamarin 平台下的 ORM 开源项目，支持 SqlServer/MySql/PostgreSQL/Oracle/Sqlite/达梦，还有人大金仓数据库，未来还会接入更多的国产数据库支持。

源码地址：https://github.com/2881099/FreeSql

谢谢支持！