Como formar uma consulta SQL para integração com os repositórios Spring Data JPA?

No Spring Data JPA, para integrar consultas SQL com os repositórios, pode usar a anotação @Query. Ela permite escrever consultas SQL nativas ou JPQL diretamente na interface do repositório.

Exemplo com consulta SQL nativa:

public interface UserRepository extends JpaRepository<User, Long> {
    @Query(value = "SELECT * FROM users WHERE status = ?1", nativeQuery = true)
    List<User> findByStatus(String status);
}

Exemplo com consulta JPQL:

public interface UserRepository extends JpaRepository<User, Long> {
    @Query("SELECT u FROM User u WHERE u.status = ?1")
    List<User> findByStatus(String status);
}

Dessa forma, a consulta SQL é formada dentro da anotação @Query, e o Spring Data JPA a integra automaticamente com o repositório e a executa ao chamar o método.