[DP-554] 검색어 자동완성 API (ES → MySQL 마이그레이션) #184

yu-so-young2 · 2025-08-17T14:04:42Z

📝 작업 내용

검색어 자동완성 기능 구현
- 초성검색, 자/모음 분리 검색 가능
- 한글 관련 함수 호출을 위한 HangulUtils 생성
- MATCH AGAINST 함수 사용을 위하여 FunctionContributor 등록
tech_keyword 테이블 생성 및 인덱스 생성
MySQL 테스트컨테이너 등록

🔗 참고할만한 자료(선택)

💬 리뷰 요구사항(선택)

검색어 데이터 삽입시 인덱스가 생성되려면 @BeforeTransaction 을 통해 넣어주어야 해서 그렇게 구현했습니다! (https://rkrkrr0101.tistory.com/114) 이렇게 안 하면 조회결과가 0이더라구요ㅠㅠ

ssosee

고생하셨습니다~ ^0^

ssosee · 2025-08-18T14:11:30Z

src/main/java/com/dreamypatisiel/devdevdev/domain/entity/TechKeyword.java

바이너리로 데이터를 강제하기(데이터 정확성이 올라감(?)) 위해서 COLLATE utf8mb4_bin 를 사용한건가요?!

맞습니다! 한글 자/모를 분리할 때 유니코드를 정확히 비교하기 위해서 사용했습니다!

ssosee · 2025-08-18T14:18:55Z

...dreamypatisiel/devdevdev/domain/repository/techArticle/custom/TechKeywordRepositoryImpl.java

+        );
+
+        // 스코어 계산을 위한 expression
+        var jamoScore = Expressions.numberTemplate(Double.class,


혹시 var 타입을 사용한 이유가 있을까요?!

헙 코틀린 습관 이슈... 수정하겠습니다~!

ssosee · 2025-08-18T15:14:23Z

...dreamypatisiel/devdevdev/domain/repository/techArticle/custom/TechKeywordRepositoryImpl.java

+    private final JPQLQueryFactory query;
+
+    @Override
+    public List<TechKeyword> searchKeyword(String inputJamo, String inputChosung, Pageable pageable) {


대략 이런 쿼리로 이해했는데요. 맞을까요?!

select tk.* from tech_keyword tk where match(tk.jamo_key) against('+ㅈㅏㅂㅏ' in boolean mode) > 0.0 or match(tk.chosung_key) against('+ㅈㅂ' in boolean mode) > 0.0 order by greatest( match(tk.jamo_key) against('+ㅈㅏㅂㅏ' in boolean mode), match(tk.chosung_key) against('+ㅈㅂ' in boolean mode) ) desc, char_length(tk.keyword) asc limit 20;

정확합니다! 실제로 호출하면 아래와 같은 쿼리가 작성됩니다.

select tk1_0.id, tk1_0.chosung_key, tk1_0.created_at, tk1_0.jamo_key, tk1_0.keyword, tk1_0.last_modified_at from tech_keyword tk1_0 where match (tk1_0.jamo_key) against (? in boolean mode)>0.0 or match (tk1_0.chosung_key) against (? in boolean mode)>0.0 order by greatest(match (tk1_0.jamo_key) against (? in boolean mode), match (tk1_0.chosung_key) against (? in boolean mode)) desc, character_length(tk1_0.keyword) limit ?

ssosee · 2025-08-18T15:19:39Z

src/main/java/com/dreamypatisiel/devdevdev/global/utils/HangulUtils.java

+    private static final int COMPAT_JAMO_START = 0x3130; // 'ㄱ'
+    private static final int COMPAT_JAMO_END = 0x318F;   // 'ㆎ'
+
+    // 한글 분해를 위한 상수


CHOSUNG, JUNGSUNG, JONGSUNG 배열의 length 를 사용하지 않고, 따로 상수로 정의한 이유가 있을까요?!

여러 곳에서 반복적으로 쓰여서 상수로 분리했습니다!

ssosee · 2025-08-18T15:29:14Z

src/main/java/com/dreamypatisiel/devdevdev/global/config/CustomMySQLFunctionContributor.java

찾아보니, boolean mode 은 필터링/자동완성에 좋고 natural language mode는 랭킹은 좋다고 하는데요.

혹시 boolean mode 만 사용하신 이유가 있을까요?!

where 절에서는 boolean mode 를 사용하고 order by 절에서는 natural language mode 를 사용하면 좋을 것 같다(?) 라는 생각이 들어여 여쭤봅니다! 🙌

구현할 때는 혼합으로 사용한다는 생각을 못했었는데 좋은 의견 감사합니다!

테스트해보니 boolean mode 만을 사용하는 쿼리가 평균적으로 아주 미세하게 좀 더 빠르길래 알아보니, order by 할 때 boolean mode 는 단순 매칭 가중치만 보기 때문에 계산 비용이 상대적으로 낮은 반면, natural language mode는 정규화 등 추가 연산이 들어가서 조금 더 무겁다고 하네요!

대신 조회 결과 정렬에는 다음과 같은 차이가 있습니다!

boolean mode 를 사용할 경우, 단순히 해당 단어가 매칭되었는가만 확인하기 때문에(1:있음, 0:없음) 동일 점수라면 char_length(keyword) asc 만 영향을 줍니다.

반면 natural language mode 를 사용하면 TF-IDF(?) 기반으로 문서 내 등장 횟수, 길이, 전체 데이터에서의 희귀도 등을 반영하여 점수를 연산하므로 좀 더 디테일한? 순위로 보여줄 수 있을 것 같습니다.

성능상 큰 차이는 없는 것으로 보여서 세웅님꼐서 말씀하신대로 혼합하여 사용하면 좋을 것 같습니다!

ssosee · 2025-08-18T16:06:56Z

src/main/java/com/dreamypatisiel/devdevdev/global/utils/HangulUtils.java

HangulUtils 클래스 멋있습니다!
혹시 static 메소드만 사용해서 abstract 으로 정의 하셨나요?!

맞습니다! 외부에서 static 메소드를 호출하기도 하고, 다른 유틸 클래스와의 통일성을 맞추기 위해 추상클래스로 변경했습니다.

ssosee · 2025-08-18T16:08:03Z

src/main/java/com/dreamypatisiel/devdevdev/domain/entity/TechKeyword.java

+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Table(indexes = {
+                @Index(name = "idx__ft__chosung_key", columnList = "chosung_key"),


사소한 부분인데, idx_tech_keyword_01 이런식으로 명명하기로 했던 것 같아요!

ssosee · 2025-08-18T16:10:20Z

src/test/java/com/dreamypatisiel/devdevdev/test/MySQLTestContainer.java

소영님이 작성해주신, MySQLTestContainer 로 h2 의존성에서 벗어났습니다!
감사합니다.!

지금은 TechKeywordService 클래스에서만 MySQL 을 사용하고 나머지 코드에서는 h2를 사용하고 있는데, 혹시 전부 MySQL을 사용하길 원하실까요?!

아뇨 그건 아닙니다!
필요한 곳에서만 자유롭게 사용하면 될것 같아오!

ssosee · 2025-08-18T16:11:32Z

src/test/java/com/dreamypatisiel/devdevdev/test/MySQLTestContainer.java

+            .withPassword("test")
+            .withCommand(
+                "--character-set-server=utf8mb4", 
+                "--collation-server=utf8mb4_unicode_ci", 


저희 서버 utf8mb4_general_ci 로 스키마 생성 되어 있긴한데, 큰 문제는 없겠죠..?

서버 기준으로 변경해두겠습니닷

감사합니다~!

yu-so-young2 added 4 commits August 17, 2025 20:53

fix(keyword): 검색어 자동완성 API

101f66a

test(keyword): 검색어 자동완성 API

4ef52bf

test(keyword): MySQL 테스트 컨테이너 분리(재사용 하기 위함)

fd5b878

fix(keyword): local에서 검색어 자동완성 기능 호출 불가

bb95ce7

yu-so-young2 requested a review from ssosee August 17, 2025 14:04

yu-so-young2 self-assigned this Aug 17, 2025

yu-so-young2 added documentation Improvements or additions to documentation fix 기능 수정 labels Aug 17, 2025

fix(keyword): test 실패 수정

c4aa514

ssosee reviewed Aug 18, 2025

View reviewed changes

fix(keyword): 코드리뷰 반영

8b03c34

ssosee merged commit 92209e4 into develop Aug 19, 2025
1 check passed

yu-so-young2 deleted the DP-554 branch August 20, 2025 05:04

[DP-554] 검색어 자동완성 API (ES → MySQL 마이그레이션) #184

[DP-554] 검색어 자동완성 API (ES → MySQL 마이그레이션) #184

Uh oh!

Conversation

yu-so-young2 commented Aug 17, 2025

📝 작업 내용

🔗 참고할만한 자료(선택)

💬 리뷰 요구사항(선택)

Uh oh!

ssosee left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants