Spring Data JPA 中的 @DynamicInsert 指南
24-09-04
banq
在本文中，我们探索@DynamicInsert注释，并通过代码示例了解它的实际应用。我们研究 Hibernate 如何动态生成仅包含非空列的 SQL 插入语句，通过避免 SQL 查询中不必要的数据来优化性能。
Spring Data JPA中的@DynamicInsert注释通过在 SQL 语句中仅包含非空字段来优化插入操作。此过程加快了生成的查询速度，减少了不必要的数据库交互。虽然它可以提高具有许多可空字段的实体的效率，但它会带来一些运行时开销。因此，在排除空列的好处大于性能成本的情况下，我们应该有选择地使用它。
JPA 中的默认插入行为使用EntityManager或 Spring Data JPA 的save()方法持久化 JPA 实体时，Hibernate 会生成一条 SQL 插入语句。此语句包括每个实体列，即使某些列包含空值。因此，在处理包含许多可选字段的大型实体时，插入操作效率可能很低。
现在让我们看看这个保存操作。我们首先考虑一个简单的Account实体：
@Entitypublic class Account { @Id private int id; @Column private String name; @Column private String type; @Column private boolean active; @Column private String description; // getters, setters, constructors}我们还将为Account实体创建一个 JPA 存储库：
@Repositorypublic interface AccountRepository extends JpaRepository
Account account = new Account();account.setId(ACCOUNT_ID);account.setName("account1");account.setActive(true);accountRepository.save(account);Hibernate 将生成包含所有列的 SQL 插入语句，即使只有少数列具有非空值：
insert into Account (active,description,name,type,id) values (?,?,?,?,?)这种行为并不总是最佳的，特别是对于某些字段可能为空或仅稍后初始化的大型实体。
使用@DynamicInsert我们可以在实体级别使用@DynamicInsert注释来优化此插入行为。应用后，Hibernate 将生成仅包含非空值列的 SQL 插入语句，从而避免 SQL 查询中出现不必要的列。
让我们将@DynamicInsert注释添加到Account实体：
@Entity@DynamicInsertpublic class Account { @Id private int id; @Column private String name; @Column private String type; @Column private boolean active; @Column private String description; // getters, setters, constructors}现在，当我们保存一个新的Account实体并且其中某些列设置为 null 时，Hibernate 将生成一个优化的 SQL 语句：
Account account = new Account();account.setId(ACCOUNT_ID);account.setName("account1");account.setActive(true);accountRepository.save(account);生成的 SQL 将仅包含非空列：
insert into Account (active,name,id) values (?,?,?)
@DynamicInsert的工作原理在 Hibernate 级别，@DynamicInsert影响框架生成和执行 SQL 插入语句的方式。 默认情况下，Hibernate 会预先生成并缓存包含每个映射列的静态 SQL 插入语句，即使在持久化实体时某些列包含空值。这是 Hibernate 性能优化的一部分，因为它可以重用预编译的 SQL 语句，而无需每次都重新生成它们。
但是，当我们将@DynamicInsert注释应用于实体时，Hibernate 会改变此行为并在运行时动态生成插入 SQL 语句。
何时使用@DynamicInsert@DynamicInsert注释是 Hibernate 中的一项强大功能，但应根据特定场景选择性地使用它。其中一种场景涉及具有许多可空字段的实体。当实体具有可能不总是填充的字段时，@DynamicInsert会通过从 SQL 查询中排除未设置的列来优化插入操作。这减少了生成的查询的大小并提高了性能。
当某些数据库列具有默认值时，此注释也很有用。防止 Hibernate 插入空值允许数据库使用其默认设置处理这些字段。例如，created_at列可能会在插入记录时自动设置当前时间戳。通过在插入语句中排除此字段，Hibernate 可以保留数据库的逻辑并防止覆盖默认行为。
此外，@DynamicInsert在插入性能至关重要的情况下也很有用。此注释可确保仅将具有许多字段（可能并非全部填充）的相关数据发送到数据库。这在高性能系统中特别有用，因为最小化 SQL 语句的大小会显著影响效率。
何时不使用@DynamicInsert尽管如我们所见，此注释有很多好处，但在某些情况下它并不是最佳选择。我们不应该使用@DynamicInsert 的最具体情况是我们的实体大多具有非空值的情况。在这种情况下，动态 SQL 生成可能会增加不必要的复杂性，而不会提供显著的效果。在这种情况下，由于大多数字段是在插入操作期间填充的，因此@DynamicInsert提供的优化变得多余。
此外，不仅具有许多非空字段的表不适合使用@DynamicInsert，而且具有少量属性的表也不适合使用 @DynamicInsert 。对于简单实体或只有少量字段的小表，使用@DynamicInsert的优势很小，排除空值带来的性能提升不太可能很明显。
在涉及批量插入的场景中， @DynamicInsert的动态特性可能会导致效率低下。由于 Hibernate 为每个实体重新生成 SQL，而不是重复使用预编译查询，因此批量插入的执行效率可能不如静态 SQL 插入。
在某些情况下，@DynamicInsert可能无法很好地适应复杂的数据库配置或架构，尤其是在涉及复杂的约束或触发器时。例如，如果架构具有要求某些列具有特定值的约束，则@DynamicInsert可能会忽略这些列（如果它们为null ），从而导致约束违规或错误。
假设我们的Account实体带有一个数据库触发器，如果文章类型为空，则插入“ UNKNOWN ” ：
CREATE TRIGGER account_type BEFORE INSERT ON account FOR EACH ROW BEGIN IF NEW.type IS NULL THEN SET NEW.type = 'UNKNOWN'; END IF;END如果没有提供类型，Hibernate 将完全排除该列。因此，触发器可能无法激活。