前言
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 (嵌入式版本)
.NET版本:.net6.0
下载地址:https://dotnet.microsoft.com/learn/dotnet/hello-world-tutorial/install
开发机器 :windows 10
2、创建项目
我们以 console 类型项目试验 插入、删除、更新、查询 等功能,创建控制台项目,使用命令:
dotnet new console
[图片上传失败...(image-c97930-1657193310321)]
dotnet add package FreeSql.Provider.Firebird
dotnet add package FreeSql.Repository
[图片上传失败...(image-477f09-1657193310321)]
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);
[图片上传失败...(image-651293-1657193310321)]
首次访问自动创建表
var users = new []
{
new User { UserName = "gaussdb2", PassWord = "1234" },
new User { UserName = "gaussdb3", PassWord = "12345" },
new User { UserName = "gaussdb4", PassWord = "123456" }
};
repo.Insert(users);
//批量插入
[图片上传失败...(image-f27b29-1657193310321)]
由于主键 ID 是自增,此次批量插入会拆成多次执行,并将值回填 users[0..2].Id
6、更新数据
user.PassWord = "123123";
repo.Update(user);
[图片上传失败...(image-dc7d24-1657193310321)]
只更新有变化的属性(字段)
7、查询数据
var one = fsql.Select<User>(1).First(); //查询一条数据
var list = fsql.Select<User>().Where(a => a.UserName.StartsWith("gaussdb")).ToList();
[图片上传失败...(image-d82c49-1657193310321)]
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
谢谢支持!