[开源] .Net ORM 访问 Firebird 数据库

2022 年 7 月 7 日
筆記
.NET ORM, firebird, freesql, orm

前言

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 (嵌入式版本)

下载地址：//firebirdsql.org/en/server-packages/

.NET版本：.net6.0

下载地址：//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数据库，未来还会接入更多的国产数据库支持。

源码地址：//github.com/2881099/FreeSql

谢谢支持！

Tags: .NET ORM firebird freesql orm