Как написать собственный @Query в Spring Data JDBC?

Так же, как завершение ответа @jens-schauder:

Запрос должен быть таким:

    @Query("SELECT ls.id, ls.name, ls.min_age, ls.max_age, " +
            "h.handbuch_id AS manual_handbuch_id, h.author AS manual_author, h.text AS manual_text " +
            "FROM lego_set ls JOIN handbuch h ON ls.id = h.handbuch_id " +
            "WHERE name = :name")
    List<LegoSet> findByName(@Param("name") String name);

Используя этот метод, проходят следующие тесты:

    @Test
    public void so_52978700() {
        // prepare
        LegoSet cars = createLegoSet("Small Car - 01", 5, 10);
        cars.setManual(new Manual("Just put all the pieces together in the right order", "Jens Schauder"));
        repository.save(cars);

        // execute
        List<LegoSet> actual = repository.findByName("Small Car - 01");

        // verify
        assertThat(actual).hasSize(1);
        assertThat(actual.get(0).getName()).isEqualTo("Small Car - 01");
        assertThat(actual.get(0).getManual().getText()).isEqualTo("Just put all the pieces together in the right order");
    }

Сущность LegoSet имеет отношение 1: 1 к Manual. Spring Data JDBC выбирает такую ​​конструкцию с помощью соединения и ожидает репрезентативные столбцы в ResultSet.

Обратите внимание, что он ожидает, что столбцы будут представлять саму сущность Manual плюс столбец, образующий обратную ссылку на LegoSet. Кроме того, все имена столбцов должны начинаться с имени свойства + _, то есть в данном случае manual_.

Сообщение об ошибке фактически сообщает вам об отсутствующем столбце (по модулю отсутствующего пробела): Column not found: manual_handbuch_id.

В качестве альтернативы вы также можете указать свои собственные _ 9_

По поводу документации:

Вы в чем-то правы. Документация (почти) всех модулей Spring Data включает общую часть, которая легко приводит к путанице. Существует билет для перехода к лучшему решению.

Я думаю, вы пытаетесь выполнить собственный запрос. Попробуйте, как показано ниже.

@Query(  value = "SELECT * FROM lego_set ls where ls.name = :name",
           nativeQuery = true)
  List<LegoSet> findByName(@Param("name") String name);

Это должно сработать.