.NET ORM 鉴别器 和 TDengine使用-SqlSugar

SqlSugar ORM

SqlSugar 是一款 老牌 .NET 开源多库架构ORM框架 ,一套代码能支持多种数据库像Admin.net、Blog.Core、CoreShop等知名开源项目都采用了SqlSugar作为底层.

特色1:超级简单

在不用任何设计模式,任何框架的情况下都可以拥有最佳体验,SqlSugar做到了保姆一样的服务,直接用不需要学习

的框架,各种默认值都是最佳配置,用到什么看一下文档便可。

特色2:产品必备

可以一套代码支持所有主流数据库(包括国产数据库),成本要远低于EF Core, EF Core基本每个数据库都需要手动写

兼容代码 。例如:建表、查询函数、索引 、修改表等等。SqlSugar只需要一套代码就能支持多个数据库。支持

多库建表,多库修改表,多库索引,多库事务,多库查询,跨库查询,多库共存,多库切换等等。

一、鉴别器(Discrimator)

类似tdengine里面超级表概念, 他可以在一张表里面存储一个或者多个个性化字段,查询自动变成条件,并且插入更新都会自赋值进行存储

Discrimator ="Type:1"//字段名字可以随便取
Discrimator ="Type:1,Name:a" //可以多个字段,不要有空格等

用例

[SugarTable("Animal",IsDisabledDelete =true)]//创建表禁止删除列必须加
public class Animal
{
   [SugarColumn(IsIdentity =true,IsPrimaryKey =true)]
   public int AnimalId { get; set; }
   public string Name { get; set; }
}
[SugarTable("Animal",Discrimator ="Type:1", IsDisabledDelete = true)]//创建表禁止删除列必须加
public class Dog : Animal
{
  [SugarColumn(IsNullable =true)]//可空
  public int DogId { get; set; }
  [SugarColumn(IsNullable = true)]//可空
  public string Breed { get; set; }
}
[SugarTable("Animal", Discrimator = "Type:2", IsDisabledDelete = true)]//创建表禁止删除列必须加
public class Cat : Animal
{
  [SugarColumn(IsNullable = true)]//可空
  public int CatId { get; set; }
  [SugarColumn(IsNullable = true)]//可空
  public string Color { get; set; }
}

创建表

db.CodeFirst.InitTables<Animal,Dog, Cat>();
//这个表包含所有字段,包括Type分类字段

查询和插入

var cat = new Cat { Name = "Whiskers", Color = "Gray" };
db.Insertable(cat).ExecuteCommand();//实体类中没有Type字段会自插入特性对应的Type=2
 
 
var catList=db.Queryable<Cat>().ToList();//自动加上条件Type=1
var dogList = db.Queryable<Dog>().ToList();//自动加上条件Type=2

更新操作

直接更新就行了Type会忽略更新

鉴别器导航

在导航应用也可以用使,他的优势就是实体中不需要这个字段,而缺点就是需要创建多个类

var dis=db.Queryable<UnitTestDis<Cat>>()
.Includes(x => x.Animals).ToList();//T是Cat那么就能导航Cat
 
var dis2 = db.Queryable<UnitTestDis<Dog>>()
.Includes(x => x.Animals).ToList();//T是Dog那么就能导航Dog
 
[SugarTable("UnitTestDis")]//泛型需要设置表名
public class UnitTestDis<T>
{
  [SugarColumn(IsPrimaryKey =true,IsIdentity =true)]
  public int Id { get; set; }
  public int Aid { get; set; }
  [Navigate(NavigateType.OneToMany,nameof(Animal.AnimalId),nameof(Aid))]
  public List<T> Animals { get; set; }
}

二、TDengine 数据库支持

TDengine——开源、高性能、云原生的时序数据库 TDengine 是一款开源、云原生的时序数据库,专为物联网、工业互联网、金融、IT 运维监控等场景设计并优化。它能让大量设备、数据采集器每天产生的高达 TB 甚至 PB 级的数据得到高效实时的处理,对业务的运行状态进行实时的监测、预警,从大数据中挖掘出商业价值。

TDengine 连接字符串

Host=localhost;Port=6030;Username=root;Password=taosdata;Database=power

TDengine Nuegt安装

NUGET SDK需要下载和安装

https://docs.taosdata.com/connector/csharp/

下面是NUGET安装

SqlSugar.TDengineCore``SqlSugarCore

TDengine DEMO 源码

https://github.com/DotNetNext/SqlSugar

.NET ORM 鉴别器 和 TDengine使用-SqlSugar

SqlSugar下面准备要支持 mongodb 数据库,喜欢推荐一下,SqlSugar一直努力的创新和维护