EF Core 6如何无需单独连接配置实体映射其他SQL Server数据库表

EF Core 原生[Table]特性的Schema参数仅映射SQL Server的架构层级，传入Drugs.dbo时会被整体识别为架构名，最终生成不符合语法的[Drugs.dbo].[PRODUCTS]格式。
在不使用独立数据库连接、不修改数据库端配置的前提下，同实例跨库映射可以直接通过Fluent API配置表的Catalog（数据库名）实现，EF Core会自动生成SQL Server支持的[库名].[架构名].[表名]三段式引用格式，支持单查询关联多个库的表。

具体实现步骤 #

1. 在DbContext的OnModelCreating方法中，为跨库实体指定所属数据库、架构、表名：

   using Microsoft.EntityFrameworkCore;
   using Microsoft.EntityFrameworkCore.Metadata;
   
   protected override void OnModelCreating(ModelBuilder modelBuilder)
   {
       // 配置映射Drugs库的PRODUCTS表
       var productConfig = modelBuilder.Entity<Product>();
       // 设置所属数据库(Catalog)
       productConfig.Metadata.SetAnnotation(
           RelationalAnnotationNames.Catalog, 
           "Drugs"
       );
       // 设置架构
       productConfig.Metadata.SetSchema("dbo");
       // 设置表名
       productConfig.Metadata.SetTableName("PRODUCTS");
       // 标记该表不纳入当前上下文的迁移范围，避免迁移时在主库生成冗余表
       productConfig.ExcludeFromMigrations();
   }
   

2. 配置校验
   可以通过ToQueryString()方法验证生成的SQL格式是否正确：

   var testQuerySql = dbContext.Products.Take(1).ToQueryString();
   

   生成的SQL中表引用部分为[Drugs].[dbo].[PRODUCTS]即为配置生效。

注意事项 #

• 该方案仅支持同一SQL Server实例下的跨库访问，需要保证当前连接字符串使用的账号对映射的外部库拥有对应读写权限
• 跨库表和主库表可以直接在LINQ中编写关联查询，EF Core会自动生成包含多库三段式表名的JOIN语句，使用逻辑和单库表完全一致
• 不要尝试直接在[Table]特性中拼接三段式表名，EF Core会对传入的名称做整体转义，无法生成合法的跨库引用格式

内容的提问来源于stack exchange，提问作者viraptor