PostgreSQL Array 数组类型与 FreeSql 打出一套【组合拳】

技术分享 3年前 (2022-06-08) 0 999+

前言

PostgreSQL 是世界公认的功能最强大的开源数据库，除了基础数据类型 int4/int8/varchar/numeric/timestamp 等，还支持 int4[]/int8[]/varchar[]/numeric[]/timestamp[] 数组类型、hstore 类型（类似 c# Dictionary<string, string>）、gis 类型。

选择一项技术一定是可以帮助我们提升效率，并且使用一定是非常简便的，才能让我们赚取更多时间，早点下班甚至上班摸鱼。这篇文章主要讲数组类型，如何与 FreeSql 打出简便高效的【组合拳】。

PostgreSQL 可以为每一种类型创建数组，比如 int4 对应的数组类型是 int4[]、varchar 对应的数据类型是 varchar[]。

PostgreSQL 虽然支持多维数组，但是不建议使用，因为实际使用中会带来很多操作麻烦，违背了使用简便的初衷。一维数组足够应付很多场景。

FreeSql 本身已经支持五种导航属性，OneToOne/ManyToOne/OneToMany/ManyToMany/Parent，为它们量身打造了级联保存、贪婪加载、延迟加载、级联删除(递归)、CTE递归查询等功能。

今天 FreeSql 为 PostgreSQL Array 数组类型提供了第六种新的导航属性 PgArrayToMany 专属功能。

issues #1145

Feature 特性：对数组做导航

简要描述原因：pg 之类的数据库支持数组类型，但是没有对数组做导航支持

使用场景：避免无必要的中间表

class User {   public int[] RoleIds { get; set; }   public Role[] Roles  { get; set; } } class Role {   public int Id { get; set; } }

解决方案

经过多方需求讨论之后，设定了【功能目标】如下：（已发布版本 v3.2.666-preview20220606）

功能名称：PostgreSQL 【数组类型】的【导航属性】专属功能

public enum TableRefType {     OneToOne, ManyToOne, OneToMany, ManyToMany,     PgArrayToMany //PgArray 专用导航类型 }

方式一：select * from Role where Id in (RoleIds)

class User {     public int[] RoleIds { get; set; }     [Navigate(nameof(RoleIds))]     public List<Role> Roles { get; set; } }

方式二：select * from User where RoleIds @> ARRAY[Id]::int4[]

class Role {     public int Id { get; set; }     [Navigate(nameof(User.RoleIds))]     public List<User> Users { get; set; } }

1、支持 LazyLoading 延时加载

2、支持 IncludeMany、IncludeByPropertyName 贪婪加载

fsql.Select<User>().IncludeMany(a => a.Roles).ToList(); fsql.Select<User>().IncludeByPropertyName("Roles").ToList();  fsql.Select<Role>().IncludeMany(a => a.Users).ToList(); fsql.Select<Role>().IncludeByPropertyName("Users").ToList();

3、支持 Lambda 子查询

fsql.Select<User>().Where(a => a.Roles.Any(b => b.RoleName == "管理员")).ToList(); fsql.Select<User>().Where(a => a.Roles.Count() > 0).ToList();  fsql.Select<Role>().Where(a => a.Users.Any(b => b.UserName == "Admin")).ToList(); fsql.Select<Role>().Where(a => a.Users.Count() > 0).ToList();  //... 以及 AsSelect()

4、不支持级联保存、级联删除（因机制冲突）

资料补充

至此，FreeSql 支持了六种导航属性。

FreeSql 五种导航属性进化过程 OneToOne/ManyToOne/OneToMany/ManyToMany/Parent（文章内不包括 PgArrayToMany 介绍）

FreeSql 是 .Net ORM，能支持 .NetFramework4.0+、.NetCore、Xamarin、XAUI、Blazor、以及还有说不出来的运行平台，因为代码绿色无依赖，支持新平台非常简单。目前单元测试数量：5000+，Nuget下载数量：180K+，源码几乎每天都有提交。

QQ群：4336577(已满)、8578575(在线)、52508226(在线)

FreeSql 主要优势在于易用性上，基本是开箱即用，在不同数据库之间切换兼容性比较好。作者花了大量的时间精力在这个项目，肯请您花半小时了解下项目，谢谢。功能特性如下：

支持 CodeFirst 对比结构变化迁移；
支持 DbFirst 从数据库导入实体类；
支持丰富的表达式函数，自定义解析；
支持批量添加、批量更新、BulkCopy；
支持导航属性，贪婪加载、延时加载、级联保存；
支持读写分离、分表分库，租户设计；
支持 MySql/SqlServer/PostgreSQL/Oracle/Sqlite/达梦/神通/人大金仓/翰高/MsAccess；

FreeSql 使用非常简单，只需要定义一个 IFreeSql 对象即可：

static IFreeSql fsql = new FreeSql.FreeSqlBuilder()     .UseConnectionString(FreeSql.DataType.MySql, connectionString)     .UseAutoSyncStructure(true) //自动同步实体结构到数据库     .Build(); //请务必定义成 Singleton 单例模式

注意：单例不等于线程不安全，除了事务，实际内部是有连接池管理 Ado.net IDbConnection 对象，请放心大胆使用，不用纠结线程安全问题。

微软制造了优秀的语言 c#，利用语言特性可以做一些非常好用的功能，在 ORM 中使用导航属性非常适合。