FreeSql.Provider.PostgreSQL 3.5.100-preview20241112

🦄 FreeSql, The first AOT ORM!

FreeSql is a powerful O/RM component, supports .NET Core 2.1+, .NET Framework 4.0+, Xamarin, And AOT.

Member project of .NET Core Community nuget stats GitHub license

English | 中文

  • 🛠 Support CodeFirst data migration.
  • 💻 Support DbFirst import entity class from database, or use Generation Tool.
  • ⛳ Support advanced type mapping, such as PostgreSQL array type, etc.
  • 🌲 Support expression functions, and customizable analysis.
  • 🏁 Support one-to-many and many-to-many navigation properties, include and lazy loading.
  • 📃 Support Read/Write separation, Splitting Table/Database, Global filters, Optimistic and pessimistic locker.
  • 🌳 Support MySql/SqlServer/PostgreSQL/Oracle/Sqlite/Firebird/达梦/人大金仓/南大通用/虚谷/神舟通用/翰高/ClickHouse/DuckDB/TDengine/QuestDB/MsAccess, etc.

QQ Groups:561616019(available)、4336577(full)、8578575(full)、52508226(full)

📚 Documentation

Get started  |  Select  |  Update  |  Insert  |  Delete  |  FAQ  
Expression  |  CodeFirst  |  DbFirst  |  Filters  |  AOP  
Repository  |  UnitOfWork  |  Dynamic Operations  |  ADO  
Read/Write  |  Splitting Table  |  Hide tech  |  Update Notes  

Please select a development mode:

Some open source projects that use FreeSql:

🚀 Quick start

dotnet add package FreeSql.Provider.Sqlite

static IFreeSql fsql = new FreeSql.FreeSqlBuilder()
  .UseConnectionString(FreeSql.DataType.Sqlite, @"Data Source=document.db")
  .UseAutoSyncStructure(true) //automatically synchronize the entity structure to the database
  .Build(); //be sure to define as singleton mode

class Song {
  [Column(IsIdentity = true)]
  public int Id { get; set; }
  public string Title { get; set; }
  public string Url { get; set; }
  public DateTime CreateTime { get; set; }
  
  public ICollection<Tag> Tags { get; set; }
}
class Song_tag {
  public int Song_id { get; set; }
  public Song Song { get; set; }
  
  public int Tag_id { get; set; }
  public Tag Tag { get; set; }
}
class Tag {
  [Column(IsIdentity = true)]
  public int Id { get; set; }
  public string Name { get; set; }
  
  public int? Parent_id { get; set; }
  public Tag Parent { get; set; }
  
  public ICollection<Song> Songs { get; set; }
  public ICollection<Tag> Tags { get; set; }
}

🔎 Query

//OneToOne、ManyToOne
fsql.Select<Tag>().Where(a => a.Parent.Parent.Name == "English").ToList();

//OneToMany
fsql.Select<Tag>().IncludeMany(a => a.Tags, then => then.Where(sub => sub.Name == "foo")).ToList();

//ManyToMany
fsql.Select<Song>()
  .IncludeMany(a => a.Tags, then => then.Where(sub => sub.Name == "foo"))
  .Where(s => s.Tags.Any(t => t.Name == "Chinese"))
  .ToList();

//Other
fsql.Select<YourType>()
  .Where(a => a.IsDelete == 0)
  .WhereIf(keyword != null, a => a.UserName.Contains(keyword))
  .WhereIf(role_id > 0, a => a.RoleId == role_id)
  .Where(a => a.Nodes.Any(t => t.Parent.Id == t.UserId))
  .Count(out var total)
  .Page(page, size)
  .OrderByDescending(a => a.Id)
  .ToList()

More..

fsql.Select<Song>().Where(a => new[] { 1, 2, 3 }.Contains(a.Id)).ToList();

fsql.Select<Song>().Where(a => a.CreateTime.Date == DateTime.Today).ToList();

fsql.Select<Song>().OrderBy(a => Guid.NewGuid()).Limit(10).ToList();

fsql.Select<Song>().ToList(a => new
{
    a.Id,
    Tags = fsql.Select<Tag>().ToList(),
    SongTags = fsql.Select<SongTag>().Where(b => b.TopicId == a.Id).ToList()
});

More..

🚁 Repository

dotnet add package FreeSql.Repository

[Transactional]
public void Add() {
  var repo = ioc.GetService<BaseRepository<Tag>>();
  repo.DbContextOptions.EnableCascadeSave = true;

  var item = new Tag {
    Name = "testaddsublist",
    Tags = new[] {
      new Tag { Name = "sub1" },
      new Tag { Name = "sub2" }
    }
  };
  repo.Insert(item);
}

Reference: Use TransactionalAttribute and UnitOfWorkManager in ASP.NET Core to Achieve the Multiple Transaction Propagation.

💪 Performance

FreeSql Query & Dapper Query

Elapsed: 00:00:00.6733199; Query Entity Counts: 131072; ORM: Dapper

Elapsed: 00:00:00.4554230; Query Tuple Counts: 131072; ORM: Dapper

Elapsed: 00:00:00.6846146; Query Dynamic Counts: 131072; ORM: Dapper

Elapsed: 00:00:00.6818111; Query Entity Counts: 131072; ORM: FreeSql*

Elapsed: 00:00:00.6060042; Query Tuple Counts: 131072; ORM: FreeSql*

Elapsed: 00:00:00.4211323; Query ToList<Tuple> Counts: 131072; ORM: FreeSql*

Elapsed: 00:00:01.0236285; Query Dynamic Counts: 131072; ORM: FreeSql*

FreeSql ToList & Dapper Query

Elapsed: 00:00:00.6707125; ToList Entity Counts: 131072; ORM: FreeSql*

Elapsed: 00:00:00.6495301; Query Entity Counts: 131072; ORM: Dapper

More..

👯 Contributors

And other friends who made important suggestions for this project, they include:

systemhejiyong, LambertW, mypeng1985, stulzq, movingsam, ALer-R, zouql, 深圳|凉茶, densen2014, LiaoLiaoWuJu, hd2y, tky753, feijie999, constantine, JohnZhou2020, mafeng8, VicBilibily, Soar, quzhen91, homejun, d4ilys etc.

💕 Donation

L*y 58元、花花 88元、麦兜很乖 50元、网络来者 2000元、John 99.99元、alex 666元、bacongao 36元、无名 100元、Eternity 188元、无名 10元、⌒.Helper~..oO 66元、习惯与被习惯 100元、无名 100元、蔡易喋 88.88元、中讯科技 1000元、Good Good Work 24元、Nothing 100元、兰州天擎赵 500元、哈利路亚 300元、 无名 100元、蛰伏 99.99元、TCYM 66.66元、MOTA 5元、LDZXG 30元、Near 30元、建爽 66元、无名 200元、LambertWu 100元、无名 18.88元、乌龙 50元、无名 100元、陳怼怼 66.66元、陳怼怼 66.66元、丁淮 100元、李伟坚-Excel催化剂 100元、白狐 6.66元、她微笑的脸y 30元、Eternity²º²¹ 588元、夜归柴门 88元、蔡易喋 666.66元、 *礼 10元、litrpa 88元、Alax CHOW 200元、Daily 66元、k*t 66元、蓝 100元、*菜 10元、生命如歌 1000元、山鸡 88元、平凡 100元、大树 1000元、软软的毛毛虫 66.66元、问卷星 2000元、与你无关 5000元

Thank you for your donation

🗄 License

MIT

Showing the top 20 packages that depend on FreeSql.Provider.PostgreSQL.

Packages Downloads
ZhonTai.Admin
中台Admin接口库
42
ZhonTai.Admin
中台Admin接口库
43
ZhonTai.Admin
中台Admin接口库
46
ZhonTai.Admin
中台Admin接口库
47
ZhonTai.Admin
中台Admin接口库
62
ZhonTai.Admin
中台Admin接口库
64
ZhonTai.Admin
中台Admin接口库
73
ZhonTai.Admin
中台Admin接口库
81
ZhonTai.Admin
中台Admin接口库
82
ZhonTai.Admin
中台Admin接口库
92
ZhonTai.Admin
中台Admin权限管理接口库
80

.NET Framework 4.5

.NET Standard 2.0

.NET 8.0

.NET 7.0

.NET 6.0

.NET Framework 4.5.1

.NET Framework 4.5.2

.NET Framework 4.6.1

Version Downloads Last updated
3.5.303 38 11/13/2025
3.5.302 24 11/13/2025
3.5.216 31 11/07/2025
3.5.215 30 10/24/2025
3.5.215-preview20250917 30 09/18/2025
3.5.213 40 08/27/2025
3.5.213-preview20250825 34 08/25/2025
3.5.213-preview20250815 31 08/15/2025
3.5.212 29 08/01/2025
3.5.211 34 07/26/2025
3.5.211-preview20250716 29 07/18/2025
3.5.210 30 07/11/2025
3.5.210-preview20250626 30 07/03/2025
3.5.209 31 06/26/2025
3.5.208 36 06/19/2025
3.5.207 36 06/02/2025
3.5.206 37 05/16/2025
3.5.205 38 05/08/2025
3.5.204 35 05/02/2025
3.5.204-preview20250428 39 05/03/2025
3.5.204-preview20250425 44 04/30/2025
3.5.203 36 04/25/2025
3.5.202 41 04/11/2025
3.5.201 38 04/05/2025
3.5.200 41 03/28/2025
3.5.109 42 03/23/2025
3.5.108 40 03/13/2025
3.5.107 37 03/13/2025
3.5.106 43 02/23/2025
3.5.105 45 02/11/2025
3.5.105-preview20250116 39 01/30/2025
3.5.104 39 01/26/2025
3.5.103 40 01/09/2025
3.5.103-preview20241226 36 01/07/2025
3.5.103-preview20241224 48 12/24/2024
3.5.103-preview20241205 49 12/17/2024
3.5.102 51 12/24/2024
3.5.101 43 12/09/2024
3.5.100-preview20241127 41 03/10/2025
3.5.100-preview20241123 26 08/11/2025
3.5.100-preview20241113 41 11/14/2024
3.5.100-preview20241112 46 11/14/2024
3.5.100-preview20241108 44 11/14/2024
3.5.100-preview20241101 42 11/14/2024
3.5.100-preview20240825 43 11/14/2024
3.5.100-preview20240815 44 11/14/2024
3.5.100-preview20240810 46 11/14/2024
3.5.100-preview20240808 38 11/14/2024
3.5.100-preview20240725 43 02/05/2025
3.2.833 51 11/14/2024
3.2.832 49 11/14/2024
3.2.830 43 11/14/2024
3.2.825 51 05/26/2024
3.2.822 38 11/14/2024
3.2.821 50 05/06/2024
3.2.820 44 11/14/2024
3.2.816-preview20240322 49 05/26/2024
3.2.816-preview20240314 49 05/26/2024
3.2.815 46 11/14/2024
3.2.812 42 12/24/2024
3.2.811 59 02/04/2024
3.2.811-preview20240126 51 05/26/2024
3.2.811-preview20240120 44 05/26/2024
3.2.810 50 11/14/2024
3.2.808 51 11/14/2024
3.2.805 42 11/14/2024
3.2.802 47 12/12/2024
3.2.801 48 11/14/2024
3.2.700 50 11/14/2024
3.2.698 55 11/14/2024
3.2.697 44 11/14/2024
3.2.696 49 11/14/2024
3.2.695 43 11/14/2024
3.2.693 52 05/29/2024
3.2.690 47 11/14/2024
3.2.687 45 11/14/2024
3.2.685 41 11/14/2024
3.2.684 49 12/13/2024
3.2.683 46 11/14/2024
3.2.682 42 11/14/2024
3.2.681 58 11/14/2024
3.2.680 46 12/13/2024
3.2.669 52 11/14/2024
3.2.666 47 11/14/2024
3.2.665 45 11/14/2024
3.2.664 49 11/14/2024
3.2.662 49 11/14/2024
3.2.661 41 11/14/2024
3.2.651 50 06/01/2024
3.2.640 53 11/14/2024
3.2.610 49 11/14/2024
3.2.609 54 11/14/2024
3.2.604 45 11/14/2024
3.2.603 50 11/14/2024
3.2.500 39 12/02/2024
3.0.100 46 11/14/2024
2.6.100 41 11/14/2024
2.5.200 52 11/14/2024
2.5.100 44 11/14/2024
2.3.200 44 11/14/2024
2.3.106 42 11/14/2024
2.3.100 44 11/14/2024
2.0.105 45 11/14/2024
2.0.102 55 11/14/2024
2.0.101 42 11/14/2024
2.0.0-preview1120 47 05/26/2024
2.0.0-preview1119 46 11/14/2024
2.0.0-preview1115 41 11/14/2024
2.0.0-preview1109 51 05/26/2024
2.0.0-preview1106 49 05/26/2024
2.0.0-preview1105 48 05/26/2024
2.0.0-preview1026 44 05/26/2024
1.10.3 50 05/26/2024
1.10.1 49 05/26/2024
1.10.0-preview1020 56 05/26/2024
1.10.0-preview1001 43 05/26/2024
1.9.1 48 11/14/2024
1.9.0 43 05/26/2024
1.9.0-preview0920 53 05/26/2024
1.9.0-preview0906 49 05/26/2024
1.8.2 56 11/14/2024
1.8.1 44 05/26/2024
1.7.1 56 05/26/2024
1.7.0 55 05/26/2024
1.6.0 57 05/26/2024
1.5.0 45 05/26/2024
1.5.0-preview0525 53 05/26/2024
1.5.0-preview0521 52 05/26/2024
1.5.0-preview0509 51 05/26/2024
1.5.0-preview0502 44 05/26/2024
1.4.0 58 05/26/2024
1.4.0-preview0424 54 05/26/2024
1.4.0-preview0423 43 05/26/2024
1.4.0-preview0422 46 05/26/2024
1.4.0-preview0415 40 05/26/2024
1.4.0-preview0413 47 05/26/2024
1.3.6 55 05/20/2024
1.3.5 52 05/26/2024
1.3.4 46 11/14/2024
1.3.0-preview8 46 05/26/2024
1.2.1 50 05/26/2024
1.2.0-preview5 46 11/14/2024
1.1.0 42 05/26/2024
1.0.1 46 11/14/2024
1.0.0 50 05/26/2024
0.12.21 43 11/14/2024
0.12.20 42 11/14/2024
0.12.18 43 11/14/2024
0.12.16 41 11/14/2024
0.12.12 41 11/14/2024
0.12.11 43 11/14/2024
0.12.9 46 05/26/2024
0.12.8 44 05/26/2024
0.12.7 46 11/14/2024
0.12.6 48 05/26/2024
0.12.5 41 05/26/2024
0.12.3 56 05/26/2024
0.11.24 44 11/14/2024
0.11.23 42 11/14/2024
0.11.22 42 12/17/2024
0.11.21 55 11/14/2024
0.11.20 45 11/14/2024
0.11.19 45 11/14/2024
0.11.18 49 11/14/2024
0.11.12 53 11/14/2024
0.11.11 50 12/11/2024
0.11.9 50 05/26/2024
0.11.6 55 05/26/2024
0.11.4 49 05/26/2024
0.11.3 56 05/26/2024
0.11.2 46 05/26/2024
0.11.1 58 05/26/2024
0.10.15 41 11/14/2024
0.10.14 48 11/14/2024
0.10.13 47 11/14/2024
0.10.12 52 11/14/2024
0.10.11 37 11/14/2024
0.10.10 46 11/14/2024
0.10.9 50 05/26/2024
0.10.8 54 05/26/2024
0.10.7 52 05/26/2024
0.10.6 53 05/26/2024
0.10.5 46 05/26/2024
0.10.4 49 05/26/2024
0.10.3 48 05/26/2024
0.10.2 43 11/14/2024
0.10.1 52 05/26/2024
0.9.18 44 05/26/2024
0.9.17 44 05/26/2024
0.9.16 50 05/26/2024
0.9.15 52 05/26/2024
0.9.11 51 11/14/2024
0.9.10 45 11/14/2024
0.9.7 51 05/26/2024