[开源] .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,正常的话会显示如下:

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

2、创建项目

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

dotnet new console

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

dotnet add package FreeSql.Provider.Odbc --version 1.6.0-preview0102

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

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

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);

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

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

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

6、更新数据

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

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

7、查询数据

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

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

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

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

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

谢谢支持!

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

上一篇:SQL-Base 用表组织数据


下一篇:SQL学习笔记--2