Npgsql/EFCore.PG 中处理系统列xmin的注意事项

在PostgreSQL数据库系统中，xmin是一个特殊的系统列，它记录了创建该行的事务ID。这个列对于实现多版本并发控制(MVCC)机制至关重要。当使用Npgsql作为.NET应用程序与PostgreSQL数据库的桥梁时，开发者需要特别注意这个系统列的特殊性。

xmin列的特性

xmin是PostgreSQL内部维护的系统列，具有以下重要特征：

1. 不可重命名：作为系统列，xmin的名称是固定的，任何尝试修改其名称的操作都会失败
2. 自动管理：该列由PostgreSQL自动维护，开发者不应直接修改其值
3. 并发控制：xmin常被用作乐观并发控制的版本标记

从xmin迁移到显式版本列

在早期版本的Npgsql中，开发者可以通过UseXminAsConcurrencyToken()方法将xmin列用作并发控制标记。但随着版本升级，推荐的做法是使用显式的版本列：

public abstract class BaseEntity
{
    public long Id { get; private set; }
    public DateTime CreatedDateTime { get; private set; }
    public DateTime ModifiedDateTime { get; private set; }
    
    [Timestamp]
    public uint Version { get; set; }
}

这种方式的优势在于：

• 更明确的版本控制机制
• 避免依赖PostgreSQL内部实现细节
• 提高代码的可移植性

常见问题与解决方案

在迁移过程中，开发者可能会遇到以下问题：

1. 自动生成的迁移尝试重命名xmin

当EF Core检测到模型从使用xmin变为使用显式版本列时，可能会错误地生成重命名xmin列的迁移代码。这种情况下，应该手动编辑迁移文件，删除相关的RenameColumn操作。

2. 列名大小写转换的影响

如果项目中实现了全局的列名大小写转换逻辑，需要注意排除并发标记列：

foreach (var prop in entityProperties)
{
    // 跳过并发标记列
    if (prop.IsConcurrencyToken) continue;
    
    var colName = prop.GetColumnName(StoreObjectIdentifier.Table(GetTableName(prop)!, GetSchemaName(prop)!));
    prop.SetColumnName(colName?.ToLower());
}

3. 模型快照中的配置

正确的版本列配置应如下所示：

b.Property<uint>("Version")
    .IsConcurrencyToken()
    .ValueGeneratedOnAddOrUpdate()
    .HasColumnType("xid")
    .HasColumnName("version");

最佳实践建议

1. 避免直接操作xmin系统列
2. 使用显式版本列而非依赖系统列
3. 在全局模型配置中特别注意处理并发标记列
4. 仔细检查自动生成的迁移代码，确保不包含对系统列的操作

通过遵循这些实践，可以确保应用程序与PostgreSQL的交互更加稳定可靠，同时也为未来的升级和维护打下良好基础。