本文共 4511 字，大约阅读时间需要 15 分钟。

SqlSugar 开源数据库操作框架介绍

SqlSugar 是一款经典的 .NET 数据库操作框架，由果糖大数据科技团队维护和持续更新。作为一款功能强大且性能优越的数据库操作工具，SqlSugar 在开发者社区获得了广泛的认可，其 GitHub star 数量仅次于 EF 和 Dapper。

SqlSugar 的主要优势

• 简单易用：提供丰富的内置功能，减少手动操作，提升开发效率。
• 功能齐全：支持多种数据库类型，如 MySQL、SqlServer、Sqlite、Oracle、PostgreSQL、达梦、人大金仓等。
• 高性能：在保证功能完整性的同时，保持操作效率极高。
• 轻量级：框架自身体积小，减少资源占用。
• 全面的服务支持：提供专业的技术支持，24 小时 / 365 天在线服务。

SqlSugar 支持的数据库类型

• 关系型数据库：MySQL、SqlServer、Sqlite、Oracle、PostgreSQL。
• 开源数据库：达梦、人大金仓。

SqlSugar 的最新版本功能

SqlSugar 的最新稳定版本为 5.0.2.8，在发布后的一个月内在 NuGet 平台下载量达到 5000 次，用户反馈极其满意。随后又推出了 5.0.2.9 版本，基于稳定版本的基础上新增了 3 个核心功能：

配置查询：简化字典表联表问题

SqlSugar 的配置查询功能通过预先定义字典表，实现了在单表查询中直接获取所需信息的需求。以下是使用配置查询功能的具体示例：

创建测试数据

首先，创建一个字典实体类：

public class DataDictionary
{
    public string Code { get; set; }
    public string Name { get; set; }
    public string Type { get; set; }
}

然后，通过 SqlSugar 初始化字典表并插入测试数据：

var db = GetInstance();
var datas = new List
   
    ();
datas.Add(new DataDictionary() { Code = "1", Name = "男", Type = "sex" });
datas.Add(new DataDictionary() { Code = "2", Name = "女", Type = "sex" });
datas.Add(new DataDictionary() { Code = "1", Name = "南通市", Type = "city" });
datas.Add(new DataDictionary() { Code = "2", Name = "苏州市", Type = "city" });
datas.Add(new DataDictionary() { Code = "1", Name = "江苏省", Type = "province" });
datas.Add(new DataDictionary() { Code = "2", Name = "湖南省", Type = "province" });
db.CodeFirst.InitTables(datas);
db.Insertable(datas).ExecuteCommand();
   

传统联表查询的缺点

在传统的数据库设计中，字典表查询往往面临以下问题：

SqlSugar 的配置查询解决方案

通过 SqlSugar 的配置查询功能，可以在单表查询中直接解决字典表问题。以下是具体实现步骤：

if (!db.ConfigQuery.Any())
{
    var types = db.Queryable
   
    ()
                  .Select(it => it.Type)
                  .Distinct()
                  .ToList();
    foreach (var type in types)
    {
        db.ConfigQuery.SetTable(
            it => it.Code,
            it => it.Name,
            type,
            it => it.Type == type
        );
    }
}
   

2. 查询主表数据时，通过配置字典表直接获取对应信息：

var res = db.Queryable
    
     ()
              .Select(it => new Person()
              {
                  Id = it.Id.SelectAll(),
                  SexName = it.SexId.GetConfigValue("sex"),
                  ProvinceName = it.ProvinceId.GetConfigValue("province"),
                  CityName = it.CityId.GetConfigValue("city")
              })
              .ToList();
    

通过配置查询功能，开发者可以显著降低重复联表查询的工作量，提升开发效率。

多租户 + 仓储 + 自动分配

SqlSugar 的多租户功能通过 ConfigId 区分不同的数据库实例，支持动态切换数据库。以下是实现多租户的具体代码示例：

public class Repository
    
      : SimpleClient
    where T : class, new()
{
    public Repository(ISqlSugarClient context = null) : base(context)
    {
        if (context == null)
        {
            var db = new SqlSugarClient(new List
     
      ()
            {
                new ConnectionConfig()
                {
                    ConfigId = "1",
                    DbType = SqlSugar.DbType.SqlServer,
                    IsAutoCloseConnection = true,
                    ConnectionString = Config.ConnectionString
                },
                new ConnectionConfig()
                {
                    ConfigId = "2",
                    DbType = SqlSugar.DbType.SqlServer,
                    IsAutoCloseConnection = true,
                    ConnectionString = Config.ConnectionString2
                }
            });
            base.Context = db;
            var configId = typeof(T).GetCustomAttribute
      
       ().ConfigId;
            db.ChangeDatabase(configId);
        }
    }
    public List
       
         CommQuery(string sql)
    {
        return base.Context.Queryable
        
         ()
                        .Where(sql)
                        .ToList();
    }
}
        
       
      
     
    

此外，新版本还增加了切换仓储功能，支持在同一个服务中切换不同的数据仓储。

行转列功能

SqlSugar 的行转列功能可以将数据以表格形式返回，支持多种数据格式。以下是使用行转列功能的示例：

var test06 = db.Queryable
    
     ()
                 .ToPivotTable(it => it.Id, it => it.Name, it => it.Sum(x => x.Price));
var test07 = db.Queryable
     
      ()
                 .ToPivotList(it => it.Id, it => it.Name, it => it.Sum(x => x.Price));
var test08 = db.Queryable
      
       ()
                 .ToPivotJson(it => it.Id, it => it.Name, it => it.Sum(x => x.Price));
      
     
    

通过行转列功能，开发者可以方便地将数据转换为多种格式，提升数据处理效率。

总结

SqlSugar 作为一款功能强大、性能优越的数据库操作框架，通过配置查询、多租户支持和行转列功能等创新功能，显著提升了开发者的工作效率。如果你正在寻找一款适合 .NET 开发的数据库操作框架，SqlSugar 可能是你的不二之选。

转载地址：http://shofz.baihongyu.com/