EF Core Code First中Oracle空间列类型选择及SDO_GEOMETRY映射问题

嘿，我之前帮团队做过一模一样的迁移，踩过几个坑，给你整理了一套清晰的实操方案：

1. 先搞定依赖包安装 #

首先得把Oracle的EF Core支持装上，直接通过NuGet安装两个核心包：

• Oracle.EntityFrameworkCore：Oracle官方的EF Core提供程序，自带空间数据的完整支持
• Oracle.ManagedDataAccess.Core：Oracle的.NET数据访问核心库

用Package Manager Console的话，执行：

Install-Package Oracle.EntityFrameworkCore
Install-Package Oracle.ManagedDataAccess.Core

或者用.NET CLI：

dotnet add package Oracle.EntityFrameworkCore
dotnet add package Oracle.ManagedDataAccess.Core

2. 实体类替换类型：放弃SqlGeometry，改用NetTopologySuite类型 #

EF Core的空间数据体系现在统一基于NetTopologySuite（NTS），不需要直接用Oracle的SDOGeometry类（当然也可以，但NTS类型更通用，后续换数据库也方便）。

把原来实体里的SqlGeometry替换成NTS的对应类型：

• 点数据用NetTopologySuite.Geometries.Point
• 多边形/线串用NetTopologySuite.Geometries.Polygon/LineString
• 通用场景直接用NetTopologySuite.Geometries.Geometry

举个例子，原来的实体：

public class Store
{
    public int Id { get; set; }
    public SqlGeometry StoreLocation { get; set; }
}

改成：

using NetTopologySuite.Geometries;

public class Store
{
    public int Id { get; set; }
    public Point StoreLocation { get; set; } // 按你的数据类型选对应的NTS类型
}

3. 配置EF Core映射到SDO_GEOMETRY #

接下来要告诉EF Core把NTS类型映射到Oracle的SDO_GEOMETRY列，推荐用Fluent API（更灵活），也可以用DataAnnotations：

方式一：Fluent API（推荐） #

在你的DbContext的OnModelCreating方法里添加配置：

using Microsoft.EntityFrameworkCore;
using Oracle.EntityFrameworkCore.Spatial;
using NetTopologySuite.Geometries;

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Store>()
        .Property(s => s.StoreLocation)
        .HasColumnType("SDO_GEOMETRY") // 指定Oracle的列类型
        .HasSrid(4326); // 设置空间参考ID，一般用WGS84的4326，和你原有SqlGeometry的SRID保持一致
}

方式二：DataAnnotations #

如果习惯用特性标记，直接在实体属性上加：

using Microsoft.EntityFrameworkCore;
using NetTopologySuite.Geometries;

public class Store
{
    public int Id { get; set; }
    
    [Column(TypeName = "SDO_GEOMETRY")]
    [Srid(4326)]
    public Point StoreLocation { get; set; }
}

4. 迁移与数据库初始化 #

现在生成迁移脚本：

dotnet ef migrations add SwitchToOracleSpatial

然后更新数据库：

dotnet ef database update

注意：生成的迁移脚本里应该会创建SDO_GEOMETRY类型的列，并且包含SRID设置。如果脚本有问题，可以手动调整，确保列定义直接写SDO_GEOMETRY（不需要指定长度）。

5. 替换原有SqlGeometry的操作方法 #

原来用SqlGeometry的方法（比如STDistance、STContains）要换成NetTopologySuite的原生方法，比如：

• 计算两点距离：store1.StoreLocation.Distance(store2.StoreLocation)
• 判断是否包含：store1.StoreLocation.Contains(store2.StoreLocation)

这些方法会被EF Core自动转换成Oracle的SDO_GEOMETRY函数（比如SDO_DISTANCE、SDO_CONTAINS），不需要自己写原生SQL。

几个关键坑要注意 #

• SRID一致性：必须保证原有SqlGeometry的SRID和Oracle里设置的完全一致，不然空间计算会出现错误结果
• 数据迁移：如果要把MSSQL的旧数据导入Oracle，可以先把SqlGeometry转换成WKT格式，再用Oracle的SDO_GEOMETRY(wkt, srid)函数导入
• Oracle版本：确保你的Oracle数据库是11g及以上版本（推荐12c+），低版本可能不支持部分SDO_GEOMETRY特性

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