[開源] .Net ORM 存取 Firebird 資料庫

前言

Firebird 是一個跨平臺的關聯式資料庫系統，目前能夠執行在 Windows、linux 和各種 Unix 作業系統上，提供了大部分 SQL-99 標準的功能。它既能作為多使用者環境下的資料庫伺服器執行，也提供嵌入式資料庫的實現。

Firebird 脫胎於 Borland 公司的開源版資料庫 Interbase6.0，是一個完全非商業化的產品，用 C 和 C++ 開發。由於與 interbase 的血緣關係，大部分 interbase 的開發工具可以直接應用到 Firebird 開發中。Firebird 使用 Mozilla Public License v.1.1 許可證發行。

FreeSql 支援 Firebird 嵌入式資料庫，與 Sqlite 一樣屬於本地資料庫，並且可靠性強於 sqlite，資料庫檔案不過 10兆 大小。

1、安裝環境

資料庫環境：Firebird (嵌入式版本)

下載地址：https://firebirdsql.org/en/server-packages/

.NET版本：.net6.0

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

開發機器 ：windows 10

2、建立專案

我們以 console 型別專案試驗 插入、刪除、更新、查詢 等功能，建立控制檯專案，使用命令：

dotnet new console

dotnet add package FreeSql.Provider.Firebird

dotnet add package FreeSql.Repository

3、建立實體模型

using System;
using FreeSql.DataAnnotations;

[Table(Name = "USER_FIREBIRD")]
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.Firebird, 
    @"database=localhost:D:\fbdata\EXAMPLES.fdb;user=sysdba;password=123456;max pool size=3")
    .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 = "gaussdb1", PassWord = "123" };
repo.Insert(user);

首次存取自動建立表

var users = new []
{
    new User { UserName = "gaussdb2", PassWord = "1234" },
    new User { UserName = "gaussdb3", PassWord = "12345" },
    new User { UserName = "gaussdb4", PassWord = "123456" }
};
repo.Insert(users);
//批次插入

由於主鍵 ID 是自增，此次批次插入會拆成多次執行，並將值回填 users[0..2].Id

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("gaussdb")).ToList();

8、刪除資料

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

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

結語

這篇文章簡單介紹了在 .net6.0 環境中使用 FreeSql 對 Firebird 資料庫的存取，目前 FreeSql 還支援 .net framework 4.0 和 xamarin 平臺上使用。

除了 增刪查改，FreeSql 還支援很多功能，就不一一演示，一篇文章介紹不完。

FreeSql 是 .NETCore/.NetFramework/Xamarin 平臺下的 ORM 開源專案，支援 SqlServer/MySql/PostgreSQL/Oracle/Sqlite/Firebird/Clickhouse/達夢/神通/金倉/翰高，還有華為GaussDB資料庫，未來還會接入更多的國產資料庫支援。

原始碼地址：https://github.com/2881099/FreeSql

謝謝支援！