Liquibase：如何将 ZonedDateTime 映射到 TIMESTAMP WITH TIME ZONE

## ** Liquibase：将 ZonedDateTime 映射到 TIMESTAMP WITH TIME ZONE

问题

使用 Liquibase 时，在生成 Spring 实体与数据库差异时，Liquibase 生成了具有 TIMESTAMP WITHOUT TIME ZONE 的变更集，而实际应该生成 TIMESTAMP WITH TIME ZONE。那么，如何指定 Liquibase 将 ZonedDateTime 映射到 TIMESTAMP WITH TIME ZONE，而 LocalDateTime 映射到 TIMESTAMP WITHOUT TIME ZONE 呢？

解决方案

要解决这个问题，需要执行以下步骤：

1. 创建自定义类型转换器

创建一个自定义类型转换器类，例如 ZonedDateTimeType，它实现了 Liquibase.change.custom.CustomTypeChange 接口。在该类中，实现 getValueToMigrateTo 和 getValueToMigrateFrom 方法，如下所示：

public class ZonedDateTimeType implements CustomTypeChange {

    @Override
    public Object getValueToMigrateTo(Object value) {
        if (value instanceof ZonedDateTime) {
            return ((ZonedDateTime) value).toInstant();
        }
        return value;
    }

    @Override
    public Object getValueToMigrateFrom(Object value) {
        if (value instanceof Timestamp) {
            return ((Timestamp) value).toInstant().atZone(ZoneId.systemDefault());
        }
        return value;
    }
}

2. 注册自定义类型转换器

在 Liquibase 配置文件中（通常是 liquibase.xml），注册自定义类型转换器：

<changeLog>
    <customChange type="org.example.ZonedDateTimeType"/>
</changeLog>

3. 更新变更集

更新你的变更集以使用自定义类型转换器：

<changeSet author="your_name" id="your_change_set_id">
    <createTable tableName="your_table_name">
        <column name="zoned_date_time" type="TIMESTAMP WITH TIME ZONE" customType="org.example.ZonedDateTimeType"/>
        <column name="local_date_time" type="TIMESTAMP WITHOUT TIME ZONE"/>
    </createTable>
</changeSet>

结论

通过执行这些步骤，你就可以配置 Liquibase 将 ZonedDateTime 映射到 TIMESTAMP WITH TIME ZONE，而将 LocalDateTime 映射到 TIMESTAMP WITHOUT TIME ZONE。这样，你的变更集将能够正确地创建和更新数据库表。

## 常见问题解答

1. 为什么需要自定义类型转换器？

Liquibase 默认将 ZonedDateTime 映射到 TIMESTAMP WITHOUT TIME ZONE。为了正确处理时区信息，需要使用自定义类型转换器将 ZonedDateTime 映射到 TIMESTAMP WITH TIME ZONE。

2. 自定义类型转换器是如何工作的？

自定义类型转换器实现了 CustomTypeChange 接口。在 getValueToMigrateTo 和 getValueToMigrateFrom 方法中，转换器负责将 ZonedDateTime 值转换为可由 Liquibase 识别的类型（Instant），以及从 Liquibase 识别的类型转换回 ZonedDateTime。

3. 如何调试自定义类型转换器？

你可以使用 Liquibase 的调试日志功能来调试自定义类型转换器。在 liquibase.properties 文件中设置 liquibase.logLevel=DEBUG，然后运行 mvn liquibase:diff 或 mvn liquibase:update。

4. 自定义类型转换器有性能影响吗？

自定义类型转换器可能会对性能产生轻微影响，因为它们需要在 Liquibase 处理数据时执行额外的转换。然而，这种影响通常可以忽略不计。

5. 是否可以将自定义类型转换器用于其他数据类型？

是的，你可以创建自定义类型转换器来映射其他数据类型，例如 UUID 或 JSON。具体实现将取决于目标数据类型。