Schema Creation

使用 SQL 数据库时，模式是基本组成部分。Spring Data JDBC 支持广泛的模式选项，但是在从域模型开始时，提出一个初始域模型可能会具有挑战性。为了在代码优先方法中提供帮助，Spring Data JDBC 随附与集成以使用 Liquibase 创建数据库更改集。

考虑以下域实体：

@Table
class Person {
  @Id long id;
  String firstName;
  String lastName;
  LocalDate birthday;
  boolean active;
}

通过以下代码呈现初始 ChangeSet：

RelationalMappingContext context = … // The context contains the Person entity, ideally initialized through initialEntitySet
LiquibaseChangeSetWriter writer = new LiquibaseChangeSetWriter(context);

writer.writeChangeSet(new FileSystemResource(new File(…)));

产生以下更改日志：

databaseChangeLog:
- changeSet:
    id: '1685969572426'
    author: Spring Data Relational
    objectQuotingStrategy: LEGACY
    changes:
    - createTable:
        columns:
        - column:
            autoIncrement: true
            constraints:
              nullable: false
              primaryKey: true
            name: id
            type: BIGINT
        - column:
            constraints:
              nullable: true
            name: first_name
            type: VARCHAR(255 BYTE)
        - column:
            constraints:
              nullable: true
            name: last_name
            type: VARCHAR(255 BYTE)
        - column:
            constraints:
              nullable: true
            name: birthday
            type: DATE
        - column:
            constraints:
              nullable: false
            name: active
            type: TINYINT
        tableName: person

列类型由实现 SqlTypeMapping 策略界面的对象计算。可空性由类型推断，如果一个属性类型使用原始 Java 类型，则将其设置为 false。

架构支持可以在整个应用开发生命周期中为你提供帮助。在差分模式中，你会向架构编写器实例提供一个现有的 Liquibase Database，架构编写器会将现有表与映射实体进行比较，并从差异推导出要创建/删除哪些表和列。默认情况下，不会删除任何表和列，除非你配置 dropTableFilter 和 dropColumnFilter。两个过滤器谓词都提供表名或列名，因此你的代码可以计算可以删除哪些表和列。

writer.setDropTableFilter(tableName -> …);
writer.setDropColumnFilter((tableName, columnName) -> …);

架构支持只能标识表/列的添加和删除，即删除未映射或数据库中不存在的表/列。列无法重命名，也无法迁移数据，因为实体映射未提供架构如何演变的详细信息。