学习SqlSugar的跨库查询基本用法

news2025/4/15 19:10:17

使用SqlSugar操作数据库通常都是单库操作，跨库查询的情况要么是单个系统数据不完整，需要其它系统的关联业务数据支撑，要么就是需要整合汇总多个系统的数据进行数据数据分析、处理、展示。遇到上述情况，可以要求另外的系统提供查询接口，也可以将多个数据库的数据按规则导入到另一个数据库中，再有就是本文要学习的跨库查询方法。
SqlSugar支持自动跨库、手工跨库两种操作，对同服务器、跨服务器的跨库查询也有不同的处理方式。官网文档中介绍SqlSugar支持SqlServer、MySql、Oracle 等多种数据库的跨库查询，但支持程度、操作方式不尽相同。本文学习同服务器中的针对SQLServer的跨库查询基本用法，更详细的跨库用法请见参考文献1。
查询之前，首先创建具有多数据库连接的SqlSugarClient对象实例（代码如下所示，借用的参考文献1中的示例代码），数据库连接之间用ConfigId区分，然后采用Tenant特性类标记数据库实体类，也即指定每个实体类所用数据库连接的ConfigId，该操作是在自动跨库查询时使用，手工跨库查询用不到。

var db = new SqlSugarClient(new List<ConnectionConfig>()
{
 new ConnectionConfig(){ConfigId="A",DbType=DbType.SqlServer,ConnectionString=..,IsAutoCloseConnection=true  },
 new ConnectionConfig(){ConfigId="B",DbType=DbType.SqlServer,ConnectionString=..,IsAutoCloseConnection=true  }
});

[Tenant("A")]
public class CLASS
{}

[Tenant("B")]
public class STUDENT
{}

手工跨库查询时，使用带Join的函数联表时，在函数的输入参数中按“库名.dbo.表名”指定，库名对应的是数据库连接的ConfigId，示例代码如下。

var queryResult= db.Queryable<CLASS>() //主表用当前db就行了
        .LeftJoin<STUDENT>((o,i)=> o.Id == i.classid,"B.dbo.STUDENT")         
        .Where((o,i)=> i.age>10)
        .Select((o,i)=>new Result() { ClassName=o.Name , StudentName=i.Name })
        .ToList();

如果是同服务器的自动跨库查询，需要将上面代码中的Queryable函数替换为QueryableWithAttr函数，同时实体类添加Tenant特性类指定数据库连接的ConfigId，调用形式变成了下面示例代码的样式：

var queryResult= db.QueryableWithAttr<CLASS>()
        .LeftJoin<STUDENT>((o,i)=> o.Id == i.classid)         
        .Where((o,i)=> i.age>10)
        .Select((o,i)=>new Result() { ClassName=o.Name , StudentName=i.Name })
        .ToList();