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