解决pgloader迁移Prisma生成的SQLite日期时间字段问题

在使用pgloader工具将Prisma生成的SQLite数据库迁移到PostgreSQL时，日期时间字段的处理可能会遇到一些特殊问题。本文将详细分析这一问题并提供解决方案。

问题背景

当使用Prisma ORM定义数据模型时，如果字段类型为DateTime并使用@default(now())修饰符，Prisma会在SQLite中创建类型为"DateTime"的列，并设置默认值为CURRENT_TIMESTAMP。然而，这种日期时间在SQLite中的实际存储格式与PostgreSQL的timestamp类型存在差异。

问题分析

SQLite实际上将DateTime值存储为Unix时间戳（毫秒精度），而PostgreSQL期望的是标准的timestamp或timestamptz类型。pgloader默认的SQLite到PostgreSQL的类型转换规则无法正确处理这种特殊情况。

解决方案

通过pgloader的自定义类型转换功能，我们可以显式指定如何将SQLite的datetime类型转换为PostgreSQL的timestamptz类型。具体实现如下：

1. 创建一个pgloader配置文件
2. 使用cast type datetime to timestamptz指令定义转换规则
3. 通过Lambda函数将毫秒级Unix时间戳转换为秒级并生成PostgreSQL时间戳

load database
    from sqlite:///<filepath>
    into pgsql://<connectionstring>

with quote identifiers

cast type datetime to timestamptz using (lambda (x) (unix-timestamp-to-timestamptz (if x (floor x 1000))))

excluding table names like '_prisma_migrations';

注意事项

1. 此解决方案会丢失毫秒级精度，如果应用需要精确到毫秒的时间戳，需要调整转换逻辑
2. quote identifiers选项用于保留表名和列名的大小写，如果不需要可以移除
3. 使用此方案前，确保pgloader版本包含必要的修复（特别是处理带引号标识符的问题）

最佳实践

对于使用Prisma的项目进行数据库迁移时，建议：

1. 先在测试环境验证迁移结果
2. 检查所有日期时间字段在迁移后的值是否正确
3. 考虑是否需要保留毫秒精度，根据需求调整转换逻辑
4. 迁移完成后，在应用层验证数据一致性

通过这种自定义类型转换的方式，可以确保Prisma生成的SQLite数据库中的日期时间字段能够正确迁移到PostgreSQL中。