パラメータがNULLの場合はWHERE句の条件を無視して検索できるSQLがわからない

Question

複数のパラメータを使って検索をするメソッドで画面で空欄のまま送信されたパラメータを条件にしたWHERE句を無視して実行するSQLがわかりません。

[調べたこと]

• Java内でif文を使用しなくても、SQL内でCASE式使用して、NULLのパラメータを無視して検索できる

[利用環境]

• Java 11 + Spring Boot

• Postgres

以下のようにCASE式を使用して、NULLの時はその条件を無視するように試みたのですが、以下の添付画像にあるようなエラーが生じてしまいます。なぜうまくいかないのでしょうか?

// JPAの@Queryアノテーション内(1番下のコード参照)
SELECT * FROM mst_asset a
WHERE a.id = CASE WHEN :id IS NULL THEN a.id ELSE :id END
AND a.category_id = CASE WHEN :categoryId IS NULL THEN a.category_id ELSE :categoryId END
AND  a.admin_name = CASE WHEN :adminName IS NULL THEN a.admin_name ELSE :adminName END
AND  a.asset_name = CASE WHEN :assetName IS NULL THEN a.asset_name ELSE :assetName END

        <form th:action="@{/index/searchAsset}" th:object="${searchForm}" method="POST" name="searchForm" id="searchForm">
          <!-- 資産ID検索窓 -->
          <label for="id">資産ID</label>
          <input type="text" name="id" id="id" th:value="${id}"/>
          <!-- カテゴリ選択窓 -->
          <label for="categoryId">資産種別</label>
          <select name="categoryId" id="categoryId">
            <option value="">資産種別を選んで下さい</option>
            <option
              th:each="category:${categoryList}"
              th:selected="${selected == category.categoryId}"
              th:value="${category.categoryId}"
              th:text="${category.categoryName}"
            ></option>
          </select>
          <!-- 管理者名検索窓 -->
          <label for="adminName">管理者</label>
          <input type="text" name="adminName" id="adminName" th:value="${adminName}"/>
          <!-- 検索ワード窓 -->
          <label for="assetName">資産名</label>
          <input type="text" name="assetName" id="assetName" th:value="${assetName}"/>
          <button id="searchBtn" type="submit">検索</button>
        </form>
        <form id="csvform" method="post" th:action="@{/download/csv}">
          <input type="hidden" name="filename" />
          <button type="submit">CSV</button>
        </form>

// Controller
  @RequestMapping(value = "/searchAsset", method = RequestMethod.POST)
  public String searchAsset(@ModelAttribute("searchForm") SearchForm f, @PathVariable(name = "page") Optional<Integer> page, Model model) {
    int currentPage = page.orElse(1); // リクエストされたページ
    if (currentPage == 0) {currentPage = 1;} // 先頭ページを表示している際の「<」押下用
    Pageable pageable = PageRequest.of(currentPage - 1, PAGESIZE, SORT);
    Page<Asset> assetPage = assetService.findSearchedAndPaginatedPage(f, pageable);
    model.addAttribute("assetPage", assetPage);
    return "index";

//Service
    public Page<Asset> findSearchedAndPaginatedPage(SearchForm f, Pageable pageable) {
        Integer id = f.getId();
        Integer categoryId = f.getCategoryId();
        String adminName = f.getAdminName().replaceAll("　", " ").replaceAll("\s+", " ").trim();
        String assetName = f.getAssetName().replaceAll("　", " ").replaceAll("\s+", " ").trim();
        if (id == null) {f.setId(null);}
        if (categoryId == null) {f.setCategoryId(null);}
        if (adminName == null) {f.setAdminName(null);}
        if (assetName == null) {f.setAssetName(null);}
        List<Asset> assets = assetRepos.findByIdAndCategoryIdAndAdminNameAndAssetName(id, categoryId, adminName, assetName);

        int pageSize = pageable.getPageSize(); // 1ページあたりの表示するレコード数
        int currentPage = pageable.getPageNumber(); // 現在のページ
        int startItem = pageSize * currentPage; // 現在表示しているページの1番上のレコード
        List<Asset> list = null; // Asset型の変数をnullで初期化して保持
        if (assets.size() < startItem) { // 
            list = Collections.emptyList(); // 変数listを空のまま不変にする
        } else {
            int toIndex = Math.min(startItem + pageSize, assets.size()); // 「現在表示しているページの1番上のレコード」＋「10」と「全レコード数」の小さい方をtoIndexとする
            list = assets.subList(startItem, toIndex); // 「現在表示しているページの1番上のレコード」からtoIndexまでのレコード数 = リクエストされたページで表示したいレコード数
        }

        Page<Asset> assetList = new PageImpl<Asset>(list, pageable, assets.size()); // リクエストされたページに合致するレコード情報
        return assetList;

//Repository
@Query(value = "SELECT * FROM mst_asset a " + 
               "WHERE a.id = CASE WHEN :id IS NULL THEN a.id ELSE :id END" + 
               "AND a.category_id = CASE WHEN :categoryId IS NULL THEN a.category_id ELSE :categoryId END" + 
               "AND  a.admin_name = CASE WHEN :adminName IS NULL THEN a.admin_name ELSE :adminName END" + 
               "AND  a.asset_name = CASE WHEN :assetName IS NULL THEN a.asset_name ELSE :assetName END", nativeQuery = true)
	List<Asset> findByIdAndCategoryIdAndAdminNameAndAssetName(
        @Param("id") Integer id,
        @Param("categoryId")Integer categoryId,
        @Param("adminName") String adminName,
        @Param("assetName")String assetName);

Answer 1

私は人に語るほどコードを書いてませんがと前置きしつつ

1文だけのSQLで表現したいのですかね？
この手の任意条件は、パラメータの内容をnullかどうか判断しながら必要分を連結していくのが一般的なのかと思います。

試していませんが、こんな感じでどうでしょう。
(a.id = p@id or p@id is null ) and
(a.aa = p@aa or p@aa is null ) and
(a.bb = p@bb or p@bb is null ) 続く

これだとSQL自体は常に一意です。

パラメータマーカーは名前で指定しているので
指定した条件通りにSQLを生成するのも楽そうな気がします。
null の取り扱いはDBMSによりびみょーに違うこともあるのでpostgreの挙動も確認しないといけません。

Comments

[Bonhomme]

ご回答ありがとうございました!
おかげさまで問題を解決することができました。

Answer 2

バインド変数の型が実際のテーブルの型と違っているのでしょう。

エラーの内容は、caseでthen節とelse節で指定されている項目の型が違うと言っています。
場所的にはIDの部分だと推測。

それから、SQLでのand条件について、前に空白が無いので、上記エラーが解消しても別なエラーになると思われます。

Comments

[Bonhomme]

ご回答ありがとうございます！
画面のidとcategory_idが空欄の時はJavaの中でnullとして扱われ、それが自動的にbytea型に変換されてしまうということを認識していませんでした。
そのせいでidとcategory_idに関しては、空欄で検索ボタンををされた際には、パラメータとしてはbytea型になってしまい、case節でテーブルで規定したinteger型、else節でbytea型という不一致が起きてしまっていたようです。
Javaのコードでnullを0に変換するように追記することで、空白時もinteger方として扱うようにできました。
おかげさまで無事問題を解決することができました!
丸一日かかってもわからなかったので本当に助かりました、ありがとうございます!