这是@QueryHints发挥作用的地方。它允许开发者向 JPA 提供者（例如 Hibernate）传递特定供应商的提示以优化查询执行。通过利用@QueryHints，我们可以微调数据库交互以实现更好的性能、减少内存消耗和改进查询执行速度。

在这篇文章中，我们将探讨如何有效地使用@QueryHints，涵盖常见的优化，如只读查询、抓取大小调整、查询超时和缓存策略。我们还将讨论何时使用@QueryHints以及何时避免使用，以确保你在优化 Spring Data JPA 查询时做出明智的决定。

在 Spring Data JPA 中，@QueryHints 注解允许我们向 JPA 提供商提供 特定供应商 的提示，帮助微调查询执行。这些提示 不会修改查询本身，但会影响 Hibernate（或另一个 JPA 提供商）内部执行查询的方式。

如何使用@QueryHints

@QueryHints 注解在 Spring Data JPA 仓库中使用，用于传递一个列表的提示，每个提示都由一个@QueryHint注解表示。@QueryHint 接受两个参数：

• • name: 提示的名称（JPA 或 Hibernate 特定）。
• • value: 分配给提示的值。

@Query("SELECT e FROM Employee e WHERE e.salary > :salary")
    @QueryHints( {
            @QueryHint(name = "org.hibernate.readOnly", value = "true"),
            @QueryHint(name = "org.hibernate.fetchSize", value = "50"),
            @QueryHint(name = "org.hibernate.cacheable", value = "true"),
            @QueryHint(name = "jakarta.persistence.cache.retrieveMode", value = "USE"),
            @QueryHint(name = "jakarta.persistence.cache.storeMode", value = "USE"),
            @QueryHint(name = "jakarta.persistence.query.timeout", value = "2000")
    })
    List<Employee> findEmployeesWithSalaryGreaterThan(@Param("salary") double salary);

只读查询

将查询标记为只读防止 Hibernate 跟踪检索到的实体的更改。这避免了不必要的持久化开销，减少内存消耗并提高查询性能。

为什么使用只读查询？

• • Hibernate 跟踪实体变化以检测持久化修改。
• • 对于只读操作，这种跟踪是不必要的，并且会消耗额外的内存。
• • 将查询标记为只读可跳过此跟踪，提高性能。

示例：将查询标记为只读

@QueryHints({ @QueryHint(name = "org.hibernate.readOnly", value = "true") })
Employee findByEmail(String email);

💡 性能优势：

• • Hibernate 不会在中保留检索到的实体。
• • 节省通过跳过不必要的脏检查来节省 CPU 和内存。
• • 非常适合查询获取报告、日志或分析数据，其中不需要更新。

b) 获取大小优化

当获取大结果集时，一次性检索所有记录可能导致高内存消耗和慢速性能。`fetchSize` 提示允许控制每次检索多少行，从而提高查询效率。

为什么设置获取大小？

• • 没有指定 fetch size，JPA 会一次性加载所有数据，导致内存使用量高。
• • 设置获取大小 以分块方式检索数据，减少 内存压力 并优化 JDBC 通信。

示例：控制获取大小

@QueryHints({ @QueryHint(name = "org.hibernate.fetchSize", value = "50") })
List<Employee> findAllEmployees();

💡 性能优势：

• • 高效内存使用：每次仅加载 50 条记录，而不是一次性加载所有内容。
• • 减少数据库负载：分块获取最小化对数据库资源的影响。
• • 有用的大型表格：当处理数百万条记录时，有助于防止内存溢出错误。

c) JDBC 查询超时

长时间运行的查询会阻塞资源，导致 应用程序性能缓慢。设置 查询超时 确保如果查询超过指定时间，则会 自动终止。

为什么设置查询超时？

• • 防止查询无限期地阻塞连接 。
• • 确保更快的应用程序响应时间。
• • 帮助避免死锁和性能瓶颈。

示例：设置查询超时（5 秒）

@QueryHints({ @QueryHint(name = "javax.persistence.query.timeout", value = "5000") }) // 5 sec timeout
List<Employee> findByLastName(String lastName);

💡 性能优势：

• • 如果查询时间超过 5 秒，则 取消。
• • 避免通过快速释放资源来防止线程饥饿。
• • 适用于处理高数据库负载的应用。

d) 缓存策略优化

缓存通过减少频繁访问数据的数据库访问次数来提高性能。JPA 提供两种级别的缓存：

1. 1. <强烈 id=0>一级缓存（默认）— 会话级缓存（仅限于事务）。
2. 2. 二级缓存 — 应用程序范围内的缓存，在事务间持续存在。

The cacheable提示允许查询使用二级缓存。使用二级缓存。

示例：启用查询缓存

@QueryHints({ @QueryHint(name = "org.hibernate.cacheable", value = "true") })
List<Employee> findAllCached();

💡 性能优势：

• • 避免重复的数据库查询，通过从缓存中检索数据。
• • 加速重复查询，提高整体响应时间。
• • 非常适合经常访问但很少更新的数据（例如，产品目录、配置设置）。

何时使用以及何时避免使用@QueryHints

何时使用 @QueryHints

• • 优化读密集型操作。
• • 与需要高效获取的 大型数据集 一起工作。
• • 避免对只读查询进行不必要的脏检查。
• • 控制 查询执行时间 以防止长时间运行的操作。
• • 提高通过缓存的性能。

避免在以下情况下使用 @QueryHints：

• • 查询已经通过索引和适当的连接进行了优化。
• • 使用动态查询，其中提示可能不够灵活。

需要一种供应商无关的解决方案（因为一些提示是 Hibernate 特定的）。

结论

使用@QueryHints在Spring Data JPA中可以通过优化查询执行显著提高性能。关键要点：

• • 只读查询通过跳过持久性检查来减少内存开销。
• • 抓取大小优化 提高了大数据集检索效率。
• • 查询超时可防止长时间运行的查询阻塞系统资源。
• • 缓存策略加快重复查询并减少数据库负载。

在应用@QueryHints之前，请始终使用类似Hibernate Statistics、Spring Boot Actuator 或数据库查询分析器的工具来分析您的查询，以确定实际性能瓶颈。