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