Visual Studio环境下从EF6迁移适配PostgreSQL的分步方案求助

前置准备：安装对应NuGet包 #

• 打开Visual Studio解决方案的NuGet包管理器，搜索安装两个稳定版包：
  • EntityFramework：建议选择6.4.x版本
  • EntityFramework6.Npgsql：需和已安装的EF6版本、Npgsql依赖版本匹配
    注意：不要安装适配EF Core的Npgsql包，必须选择后缀带EntityFramework6的版本

第二步：修改配置文件（App.config/Web.config） #

首先替换原有SQL Server连接串为PostgreSQL格式：

<connectionStrings>
  <add name="你的EF上下文名称" 
       connectionString="Host=PG服务器地址;Port=5432;Database=迁移后的PG库名;Username=PG登录账号;Password=PG登录密码" 
       providerName="Npgsql" />
</connectionStrings>

然后修改entityFramework节点，注册PostgreSQL提供程序：

<entityFramework>
  <providers>
    <!-- 可注释或删除原有SQL Server的provider配置，添加下方配置 -->
    <provider invariantName="Npgsql" type="Npgsql.NpgsqlServices, EntityFramework6.Npgsql" />
  </providers>
</entityFramework>

最后添加DbProviderFactories配置，避免运行时找不到提供程序：

<system.data>
  <DbProviderFactories>
    <remove invariant="Npgsql" />
    <add name="Npgsql Data Provider" invariant="Npgsql" support="FF" description=".Net Framework Data Provider for Postgresql" type="Npgsql.NpgsqlFactory, Npgsql" />
  </DbProviderFactories>
</system.data>

第三步：更新EDMX数据模型 #

1. 打开项目中已有的EDMX模型文件，右键设计区空白处，选择从数据库更新模型
2. 在弹出的连接配置窗口中，选择PostgreSQL数据源，输入PG库连接信息，测试连接通过后进入下一步
3. 勾选需要映射的表、视图、存储过程，确认后执行更新，工具会自动替换原有SQL Server的元数据为PostgreSQL映射规则
4. 手动检查模型中各表的Schema：原有SQL Server默认Schema为dbo，PostgreSQL默认Schema为public，如果有自定义Schema要同步修改对应实体的Schema属性

第四步：兼容问题修复 #

• 数据类型映射修复：检查自增列的StoreGeneratedPattern属性是否设置为Identity，SQL Server的datetime类型对应PG的timestamp without time zone/timestamp with time zone，字符串类型统一对应varchar/text即可
• 大小写问题修复：PostgreSQL默认标识符为小写，如果迁移时保留了原有SQL Server的大写表名/列名，需要在实体的表名、列名映射属性上添加双引号包裹，或者修改PG表结构统一标识符为小写
• 原生SQL语法修复：原有业务代码中写的原生SQL需要调整语法差异，比如将TOP N改为LIMIT N，日期函数、字符串拼接函数等替换为PG对应的语法
• 存储过程适配：原有SQL Server存储过程迁移到PG后，要检查参数顺序、返回值格式，对应调整EF中存储过程的映射配置

第五步：功能测试 #

1. 先执行基础CRUD操作验证基础连接和映射是否正常
2. 测试关联查询、事务操作、批量操作是否符合预期
3. 全量覆盖业务场景的数据库操作，排查未覆盖的兼容问题

常见问题排查 #

• 运行时报错找不到具有固定名称“Npgsql”的 ADO.NET 提供程序的实体框架提供程序：检查NuGet包是否安装正确，配置文件中的provider、DbProviderFactories节点配置是否正确
• 查询时报错列/表不存在：优先排查大小写匹配问题，检查PG库中的表名列名是否和EF模型中的映射一致
• 更新EDMX时找不到PG数据源：确认已经安装了EntityFramework6.Npgsql包，Visual Studio版本支持对应Npgsql版本

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