[開源] .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}\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

謝謝支援！