如何用EF Core 7将外部数据库查询映射至非实体类DTO？

方法1：无实体DbContext + 原生SQL查询 #

无需创建外部表对应的实体类，通过临时DbContext执行原生SQL并映射到DTO。

1. 创建空DbContext，仅配置外部数据库连接：

public class ExternalDbContext : DbContext
{
    private readonly string _connectionString;

    public ExternalDbContext(string connectionString)
    {
        _connectionString = connectionString;
    }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        // 根据外部数据库类型选择对应的提供者，比如MySQL用UseMySQL
        optionsBuilder.UseSqlServer(_connectionString);
    }
}

2. 定义目标DTO类：

public class UserDto
{
    public int Id { get; set; }
    public string Username { get; set; }
    public string Email { get; set; }
}

3. 执行查询并映射：

using var dbContext = new ExternalDbContext("你的外部数据库连接字符串");

// 方式1：FromSqlRaw（直接传入SQL语句）
var users = dbContext.Set<UserDto>()
    .FromSqlRaw("SELECT Id, Username, Email FROM Users WHERE IsActive = 1")
    .ToList();

// 方式2：FromSqlInterpolated（参数化查询，防SQL注入）
bool isActive = true;
var users = dbContext.Set<UserDto>()
    .FromSqlInterpolated($"SELECT Id, Username, Email FROM Users WHERE IsActive = {isActive}")
    .ToList();

如果DTO属性名和数据库列名不匹配，可通过[Column]特性指定映射关系：

public class UserDto
{
    [Column("UserID")]
    public int Id { get; set; }
    [Column("UserName")]
    public string Username { get; set; }
}

方法2：使用EF Core 7新增的SqlQuery方法 #

EF Core 7专门提供了SqlQuery扩展，无需在DbContext中注册DTO类型，直接执行查询映射：

using var dbContext = new ExternalDbContext("你的外部数据库连接字符串");

var users = dbContext.SqlQuery<UserDto>(
    "SELECT Id, Username, Email FROM Users WHERE IsActive = @isActive",
    new SqlParameter("@isActive", true)
).ToList();

方法3：动态查询（适配不固定的DTO结构） #

如果需要处理动态结果，可将查询映射到Dictionary<string, object>：

var dynamicResults = dbContext.SqlQuery<Dictionary<string, object>>("SELECT Id, Username FROM Users")
    .ToList();

foreach (var result in dynamicResults)
{
    var id = result["Id"];
    var username = result["Username"];
}

关键注意事项 #

• 确保DbContext使用的数据库提供者与外部数据库类型匹配（如SQL Server用Microsoft.EntityFrameworkCore.SqlServer）。
• 所有查询必须使用参数化方式，避免SQL注入风险。
• 无需启用迁移：该DbContext仅用于查询，不会修改外部数据库结构，因此不需要配置迁移。

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