如何在appsettings.json中配置Npgsql的__EFMigrationHistory至自定义Schema？

核心结论 #

不能直接在appsettings.json中配置迁移历史表（__EFMigrationHistory）的名称和所属Schema——Npgsql EF Core提供程序未将该参数暴露为可配置的配置项，必须通过代码层面的扩展方法完成设置。不过可以保留appsettings.json中的数据库连接参数，仅在代码中补充迁移历史表的配置逻辑。

具体修改方案 #

结合你现有的项目结构，按以下步骤调整：

1. 修改DbContext配置代码
   保留从appsettings.json读取连接参数的逻辑，同时添加MigrationsHistoryTable的配置：

   public void ConfigureServices(IServiceCollection services)
   {
       services.AddDbContext<DataContext>(options =>
       {
           // 读取appsettings中的Postgres配置节
           var pgConfig = Configuration.GetSection("Postgres:Client");
           
           // 用Npgsql连接字符串构建器规范生成连接字符串
           var connStringBuilder = new NpgsqlConnectionStringBuilder
           {
               Host = pgConfig["Server"],
               Port = int.Parse(pgConfig["Port"]),
               Database = pgConfig["Database"],
               Username = pgConfig["Username"],
               Password = pgConfig["Password"],
               IncludeErrorDetail = bool.Parse(pgConfig["Include Error Detail"])
           };
   
           // 配置PostgreSQL连接，并指定迁移历史表的名称和Schema
           options.UseNpgsql(connStringBuilder.ConnectionString, builder =>
           {
               // 替换为你的自定义Schema名称，迁移历史表名可保留默认或自定义
               builder.MigrationsHistoryTable("__EFMigrationHistory", "your-custom-schema");
           });
       });
   }
   

2. 设置实体默认Schema
   要让所有业务表都迁移到自定义Schema，需在DataContext的OnModelCreating方法中设置默认Schema：

   protected override void OnModelCreating(ModelBuilder modelBuilder)
   {
       // 设置所有实体的默认Schema
       modelBuilder.HasDefaultSchema("your-custom-schema");
       
       // 其他模型配置逻辑...
   }
   

3. 确保自定义Schema存在
   执行迁移前，需确保数据库中已创建目标Schema。可以通过两种方式实现：

   • 手动创建：直接在PostgreSQL中执行SQL语句：

     CREATE SCHEMA IF NOT EXISTS "your-custom-schema";
     

   • 通过迁移创建：在第一个迁移文件的Up方法中添加Schema创建逻辑：

     protected override void Up(MigrationBuilder migrationBuilder)
     {
         migrationBuilder.EnsureSchema(
             name: "your-custom-schema");
         
         // 其他迁移代码...
     }
     

后续操作 #

完成上述配置后，重新生成并执行迁移，所有表（包括迁移历史表）都会被创建在指定的自定义Schema中。

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