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

2022-09-26 16:16:33

前言

京人大金仓信息技术股份有限公司（以下简称“人大金仓”）是具有自主知识产权的国产数据管理软件与服务提供商。人大金仓由中国人民大学一批最早在国内开展数据库教学、科研、开发的专家于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 --version 1.6.0-preview0102

dotnet add package FreeSql.Repository --version 1.6.0-preview0102

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}\r\n"))
    .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

谢谢支持！