SQL Server 2022 Graph与Entity Developer节点ID同步问题求助

问题背景 #

通过T-SQL创建SQL Server图数据库时，节点表的$node_id是系统自动生成的别名，对应实际数据库中的动态列名（如NodeIdE051E8F24C3E4C19A168DDEF0BAA40A7），每次重建数据库该列名都会变化。T-SQL脚本可通过别名正常执行，但Entity Developer生成的C#类会绑定这个动态列名，导致每次重建库都需同步代码，影响开发效率。

可行解决方案 #

1. 手动固定节点ID的列名（推荐） #

在创建NODE表时，显式指定$node_id对应的实际列名，让其固定不变。修改表创建语句如下：

CREATE TABLE Species 
(
    -- 显式定义固定名称的节点ID列，设置为隐藏的非聚集主键
    [NodeId] NVARCHAR(100) CONSTRAINT PK_Species_NodeId PRIMARY KEY NONCLUSTERED HIDDEN,
    [Id] int IDENTITY(1,1) NOT NULL,
    [TranslatedNameId] int NULL,
    [ImageIndex] int NULL,
    [Name] nvarchar(64),
    [Description] nvarchar(max) NULL,
    -- 业务主键设为聚集主键
    PRIMARY KEY CLUSTERED (Id)
) AS NODE (NodeId = $node_id); -- 将自定义列绑定到$node_id别名

这样每次重建数据库，节点ID的列名都是NodeId，Entity Developer生成的C#类会使用这个固定名称，无需再同步修改。

2. 配置Entity Developer忽略/重命名动态列 #

• 在Entity Developer的模型设计器中，找到Species实体，将自动生成的动态列（如NodeIdE051E8F24C3E4C19A168DDEF0BAA40A7）重命名为固定名称（如NodeId）。
• 进入代码生成设置，配置实体属性的命名规则，确保该列始终使用固定名称；同时可关闭该列的自动同步更新，避免重新生成时覆盖自定义名称。
• 如果业务代码不需要直接使用节点ID，可直接从模型中移除该列，仅保留业务主键Id即可。

3. 手动映射列名（代码层面） #

如果无法修改数据库脚本，可在C#实体类中通过数据注解或EF Fluent API手动映射列名：

数据注解方式

public partial class Species 
{
    public Species()
    {
        OnCreated();
    }

    // 手动指定列名，配合方案1使用固定列名，或匹配当前数据库的动态列名
    [Column("NodeId")]
    public string NodeId { get; set; }

    /// <summary>
    /// Clé primaire.
    /// </summary>
    public int Id { get; set; }

    // 其他属性...

    partial void OnCreated();
}

Fluent API方式（在DbContext的OnModelCreating方法中）

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Species>()
        .Property(s => s.NodeId)
        .HasColumnName("NodeId"); // 或当前数据库的动态列名，配合方案1则用固定名
}

注意事项 #

• SQL Server图节点的$node_id是系统用于维护图关系的隐藏列，若业务代码不需要直接操作图关系的底层ID，优先考虑从模型中移除该列，减少不必要的绑定。
• 若使用方案1，需确保所有关联的EDGE表操作仍使用$to_id/$from_id别名，不影响原有T-SQL脚本的执行。

内容的提问来源于stack exchange，提问作者Nolmè Informatique