此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Data Relational 3.4.0! |
Schema 创建
在使用 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
列类型是从实现 strategy 接口的对象计算的。
如果属性类型使用原始 Java 类型,则从类型推断出可为 Null性,并设置为 Nullability。SqlTypeMapping
false
架构支持可以在整个应用程序开发生命周期中为您提供帮助。
在差分模式下,您将现有 Liquibase 提供给架构编写器实例,架构编写器将现有表与映射的实体进行比较,并从差异中得出要创建/删除的表和列。
默认情况下,除非您配置 和 ,否则不会删除任何表和列。
这两个筛选条件谓词都提供相应的列名,以便您的代码可以计算可以删除哪些表和列。Database
dropTableFilter
dropColumnFilter
writer.setDropTableFilter(tableName -> …);
writer.setDropColumnFilter((tableName, columnName) -> …);
架构支持只能在删除未映射的表/列或添加数据库中不存在的列的意义上识别添加和删除。 无法重命名列,也无法迁移数据,因为实体映射不提供架构演变的详细信息。 |