如何检查 @BatchSize 对实际数据库查询次数的影响?
可以用 Hibernate Statistics 统计 SQL 语句数量,也可以通过 Session Metrics 日志辅助观察。当前测试只加载一个 OrderSummary 及其 items 集合,通常会执行两次查询。调整 @BatchSize 的值未必会改变这个结果。
为什么始终只有两次查询?
在这个映射中,@BatchSize(size = 5) 表示 Hibernate 一次批量加载最多可以初始化 5 个 OrderSummary.items 集合。它不限制每次查询返回的 Item 行数,也不限制整个测试执行的查询次数。
假设关联保持默认的延迟加载,缓存、其他关联和监听器也没有影响查询过程,当前测试通常会执行:
entityManager.find(OrderSummary.class, 1L)查询一个OrderSummary。summary.getItems().hasSize(13)对应的断言访问集合大小,触发items初始化,一次查询加载该集合中的全部 13 个Item。
这里参与加载的只有一个集合。把 size 从 5 改为 10,不会改变加载这 13 个 Item 所需的查询次数。数据库中共有 20 个 Item,也不足以说明应该发生批量加载;需要看当前持久化上下文中有多少个待初始化的同类集合。
开启统计与日志
在测试配置中启用统计,并单独设置统计日志的级别:
spring:
jpa:
properties:
hibernate.generate_statistics: true
logging:
level:
root: WARN
org.springframework.web: INFO
edu.orders.service: DEBUG
org.hibernate.SQL: DEBUG
org.hibernate.type.descriptor.sql.BasicBinder: TRACE
org.hibernate.engine.internal.StatisticalLoggingSessionEventListener: INFO
root: WARN 会过滤未单独配置级别的 INFO 日志。将 org.hibernate.engine.internal.StatisticalLoggingSessionEventListener 设为 INFO,可以让它的统计信息通过日志级别过滤。hibernate.generate_statistics 则用于启用 Hibernate 统计。
Session Metrics 通常在 Session 结束时输出,不一定会在断言执行后立即出现。如果应用另外禁用了 Session 事件日志或替换了监听器,还需要检查相应设置。
注意 YAML 的缩进。问题中展示的配置如果直接保存为没有缩进的 YAML,不能形成预期的 logging.level 层级。
org.hibernate.type.descriptor.sql.BasicBinder 是 Hibernate 5 常用的参数绑定日志类别。使用 Hibernate 6 时,通常改为:
logging:
level:
org.hibernate.orm.jdbc.bind: TRACE
参数绑定日志用于查看参数,统计 SQL 数量时不必开启。
在测试中读取语句计数
直接读取 Statistics 比手动数日志行更方便。下面的示例保留原测试的加载方式,并增加语句计数:
@DataJpaTest(properties = {
"spring.jpa.properties.hibernate.generate_statistics=true",
"spring.jpa.properties.hibernate.cache.use_second_level_cache=false",
"spring.jpa.properties.hibernate.cache.use_query_cache=false"
})
@ActiveProfiles("test")
class OrdersDbTest {
@Autowired
EntityManager entityManager;
@Test
void shouldExtractItemsFromOrder() {
SessionFactory sessionFactory = entityManager
.getEntityManagerFactory()
.unwrap(SessionFactory.class);
Statistics statistics = sessionFactory.getStatistics();
entityManager.clear();
statistics.clear();
OrderSummary summary = entityManager.find(OrderSummary.class, 1L);
assertThat(summary.getItems()).hasSize(13);
long statementCount = statistics.getPrepareStatementCount();
assertThat(statementCount).isEqualTo(2L);
}
}
示例需要导入 org.hibernate.SessionFactory 和 org.hibernate.stat.Statistics。EntityManager 的包名应与项目版本一致,可能是 javax.persistence 或 jakarta.persistence。
2L 断言以上述条件为前提:执行一次父实体查询和一次集合查询,且测量期间没有其他 SQL。如果完整实体映射包含额外的 eager 关联,应根据实际 SQL 调整判断。
getPrepareStatementCount() 统计 JDBC statement 的准备次数。在这种没有写入和其他数据库操作的读取测试中,可以用它观察查询数量。它不是通用的 SELECT 执行计数器,测量期间的 INSERT、UPDATE 等语句也可能计入。getQueryExecutionCount() 无法覆盖所有实体加载和集合初始化产生的 SQL,因此不适合单独用于判断这个场景。
如何验证 @BatchSize 确实生效?
准备多个 OrderSummary,先将它们加载到同一个持久化上下文中,再逐个初始化 items。例如,可以在测试方法中使用以下测量过程:
entityManager.clear();
List<OrderSummary> summaries = entityManager.createQuery(
"select s from OrderSummary s order by s.id",
OrderSummary.class
).getResultList();
// Exclude the parent query from the measurement.
statistics.clear();
for (OrderSummary summary : summaries) {
Hibernate.initialize(summary.getItems());
}
long collectionStatementCount = statistics.getPrepareStatementCount();
System.out.println("Collection statements: " + collectionStatementCount);
statistics 沿用上一段的获取方式,Hibernate 对应 org.hibernate.Hibernate。测试数据必须包含多个 OrderSummary;原问题中的 20 个 Item 并不等于 20 个父实体。
在没有缓存命中、集合尚未初始化且没有其他 SQL 的简单场景下,如果同一个持久化上下文中有 20 个待加载的 OrderSummary.items 集合,size = 5 时预计约有 4 次集合查询,size = 10 时约有 2 次。父实体查询已在计数前排除。具体批次仍需结合 Hibernate 版本和实际 SQL 确认,不能保证所有加载过程都有相同的查询次数。
观察 SQL 时,应检查一次集合查询是否覆盖多个 SUMMARY_ID。常见形式是带多个父实体标识符的 IN 条件,具体 SQL 形式可能随 Hibernate 版本和数据库方言变化。
测量时不要使用 JOIN FETCH 提前初始化集合,也不要在循环中调用 entityManager.clear()。前者会改变加载方式,后者会清掉参与批量加载的持久化上下文。Statistics 属于整个 SessionFactory,并行测试可能干扰计数,应让这类计数测试独立执行。
备注:内容仅供参考。
