大多数情况下，Spring Data JPA 会使用 JPQL（Java Persistence Query Language）为你编写或生成查询语句。虽然这很方便，但有时你需要对数据库执行的 SQL 进行完全控制。这时，原生查询（Native Queries）就派上用场了。

• 原生查询就是你自己编写的原始 SQL 语句。
• 使用原生查询可以让你决定选择哪些列、如何连接表以及利用哪些数据库特定的函数。

可以将原生查询视为与数据库的“直连”，用于执行自定义或优化的操作。

为什么要使用原生查询？

• • 性能提升
  有时 JPQL 在某些查询中可能会显得较慢或受限。通过原生查询，你可以优化 SQL 以获得最佳速度。
• • 复杂查询
  如果你需要高级功能，例如特殊连接、窗口函数或特定数据库的关键字（如 PostgreSQL 中的 JSONB 操作符），原生查询为你提供了直接使用它们的灵活性。
• • 完全控制
  你可以确切地知道选择了哪些列以及数据是如何获取的。不会有任何“神秘代码”增加额外的开销。

如何在 Spring Boot 中使用原生查询？

1. 创建或使用现有的实体
假设你有一个简单的 Employee 实体：

@Entity
@Table(name = "employees")
public class Employee {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String firstName;
    private String lastName;
    private int salary;

    // getters 和 setters
}

2. 在 Repository 中编写原生查询
在 Repository 中，你可以编写一个方法并用 @Query 注解标记：

public interface EmployeeRepository extends JpaRepository<Employee, Long> {

    @Query(
      value = "SELECT * FROM employees e WHERE e.salary > :minSalary",
      nativeQuery = true
    )
    List<Employee> findBySalaryGreaterThan(@Param("minSalary") int minSalary);

}

• nativeQuery = true 告诉 Spring 你使用的是原始 SQL，而不是 JPQL。
• :minSalary 是一个命名参数，传递给查询。

3. 在 Service 或 Controller 中调用
现在，你可以在服务层或控制器层调用这个 Repository 方法：

@Service
public class EmployeeService {
    @Autowired
    private EmployeeRepository employeeRepository;

    public List<Employee> getHighEarners(int salaryThreshold) {
        return employeeRepository.findBySalaryGreaterThan(salaryThreshold);
    }
}

提升性能的技巧

1. 只获取你需要的数据
如果你不需要所有列，只需选择特定的列。例如：

@Query(
  value = "SELECT first_name, last_name FROM employees WHERE salary > :minSalary",
  nativeQuery = true
)
List<Object[]> findNameOnlyBySalary(@Param("minSalary") int minSalary);

这样可以减少数据传输并加快查询速度。

2. 明智地使用索引
数据库在频繁查询的列上有适当的索引时表现更好。如果你经常按 salary 过滤，考虑在该列上添加索引。

3. 监控查询
关注数据库日志或使用工具（如 PostgreSQL 的 pgAdmin 或 MySQL 的 MySQL Workbench）来查看查询的性能，并判断是否可以进一步优化。

4. 分页处理大量结果
如果查询返回大量数据，考虑使用分页来分块获取数据。Spring Data JPA 提供了内置的分页支持，可以与原生查询很好地配合使用。

示例演练

假设你想查找薪资高于 5,000 的员工，并只获取他们的名字和姓氏。以下是实现思路：

1.在 EmployeeRepository 中编写查询：

@Query(
  value = "SELECT e.first_name AS firstName, e.last_name AS lastName " +
          "FROM employees e " +
          "WHERE e.salary > :salary",
  nativeQuery = true
)
List<Object[]> findNameBySalaryGreaterThan(@Param("salary") int salary);

2. 在 Service 中调用方法以处理业务逻辑：

public List<Object[]> getHighEarnerNames(int salary) {
    return employeeRepository.findNameBySalaryGreaterThan(salary);
}

3. 在 Controller 中使用：

@RestController
@RequestMapping("/api/employees")
public class EmployeeController {

    @Autowired
    private EmployeeService employeeService;

    @GetMapping("/high-earners")
    public List<Object[]> findHighEarners(@RequestParam int minSalary) {
        return employeeService.getHighEarnerNames(minSalary);
    }
}

这种方式简单直接，让你能够完全控制数据库层的操作。

总结

• • 原生查询非常强大，但它们可能会使你的代码更依赖于特定数据库，因此仅在真正需要时使用。
• • 对于简单查询，使用 Spring Data 的派生方法或 JPQL 通常就足够了（并且更易于维护）。
• • 当你确实需要原生查询时，记得通过选择相关列、使用索引和监控性能来优化它们。

通过这种简单直接的方法，你可以在享受 Spring Boot 开发便捷性的同时，充分利用原生 SQL 的强大功能。尝试、测量并优化你的查询，以在灵活性和速度之间找到完美的平衡！