FreeSql中GBase8s数据库主键回写问题的解决方案

背景介绍

在使用FreeSql ORM框架连接GBase8s数据库时，开发者可能会遇到自增主键不回写的问题。这个问题主要出现在使用bigserial类型作为自增主键的情况下，而框架默认使用的是serial8类型的查询方式。

问题分析

GBase8s数据库支持多种自增序列类型，包括serial8和bigserial。当开发者使用bigserial类型作为表的主键时，FreeSql默认的查询语句SELECT dbinfo('serial8') FROM dual无法正确获取到插入后生成的主键值。

解决方案

方案一：自定义适配器

开发者可以通过自定义适配器来覆盖默认的主键查询逻辑：

public class GBSAdapter : FreeSql.Internal.CommonProvider.AdoProvider
{
    public override string InsertAfterGetIdentitySql => "SELECT dbinfo('bigserial') FROM dual";
}

然后在初始化FreeSql时使用这个适配器：

fsql.SetCustomAdapter(new GBSAdapter());

方案二：使用复合查询语句

为了兼容不同版本和类型的GBase8s数据库，可以使用更全面的查询语句：

SELECT
    DECODE(
        dbinfo('serial8'),
        0,
        DECODE(
            dbinfo('bigserial'),
            0,
            dbinfo('sqlca.sqlerrd1'),
            dbinfo('bigserial')
        ),
        dbinfo('serial8')
    )
FROM
    dual;

这个查询会依次尝试获取serial8、bigserial值，最后回退到sqlca.sqlerrd1。

方案三：正确配置实体类

确保实体类的主键属性正确配置了IsIdentity特性：

[Column(IsPrimary = true, IsIdentity = true)]
public long ID { get; set; }

实现原理

FreeSql通过RawExecuteIdentity方法获取插入后的自增主键值。对于GBase8s数据库，默认实现是查询serial8类型的值。当开发者使用bigserial类型时，需要覆盖这一行为。

最佳实践

1. 明确数据库使用的自增序列类型（serial8或bigserial）
2. 根据实际类型选择合适的解决方案
3. 在生产环境中建议使用方案二的复合查询语句，以提高兼容性
4. 在实体类中明确标记主键和自增属性

总结

通过理解GBase8s数据库的自增序列机制和FreeSql的主键回写原理，开发者可以灵活解决主键不回写的问题。根据实际项目需求选择合适的解决方案，确保数据操作的完整性和一致性。