[query] eq or eq or eq…는 왜 위험할까? Azure Search recursion 에러

Azure AI Search를 사용해 특정 사용자(evIUserId), 특정 카테고리(csagId)에 해당하는 데이터를 조회해야 했다.
문제는 단순 조회가 아니라 한 번에 들어오는 ID 개수가 매우 많았다는 점이다.

• evlUserId: 최대 2,800개
• csagId: 최대 2,800개
• 필드 타입: Edm.String (단일 string)

“여러 값 중 하나라도 일치하면 조회”라는 조건 자체는 흔했지만
막상 실제 데이터 규모로 돌리니 예상치 못한 에러가 튀어나왔다🥲🥲

내가 생각을 짧게 한 탓이다..ㅎ

 

 

💭 고민

“OR로 묶으면 되겠지?”

처음에는 단순하게 생각했다.

 

그래서 필터를 이런 식으로 만들었다.

(evlUserId eq 'u1' or evlUserId eq 'u2' or evlUserId eq 'u3' or ...)

 

값이 수백 개가 넘자 바로 아래와 같은 에러가 발생했다.

recursion depth exceeded allowed limit parameter name: $filter

• 파이썬 에러가 아니라 Azure Search 내부 파서 에러였고
• “왜” 안 되는지 공식 문서에서 바로 답을 찾기 어려웠기 때문이다.

“쿼리는 맞는 것 같은데… 왜 터지지?”라는 생각이 들었다.

 

🛠️ 시도

1️⃣ 처음 사용하던 코드 (문제의 원인)

if key in keyword_keys:
    i_v = [value.strip() for value in value.split(",") if value.strip()]
    con = [f"{key} eq '{v}'" for v in i_v]
    filters.append(f"({' or '.join(con)})")

이런 식으로 짰었다.

논리적으로는 맞을 수도 있지만..

 

Azure Search는 $filter 안에서 OR 조건을 재귀적으로 파싱 하는데

개수가 많아지면 내부 제한을 초과해 버린다

 

2️⃣ 대안 탐색: search.in() 사용

찾아보니 Azure Search에는 다중 값을 비교하기 위한 공식 함수가 있더라!

search.in(field, 'A,B,C', ',')

 

요렇게 바꿔줬다.

 

 

📈 변화 / 결과

• recursion depth 에러 ❌ → 완전히 해결
• 쿼리 가독성 ↑
• Azure Search가 의도한 방식으로 필터링 가능
• 실제 운영 데이터(수천 개 ID)에서도 안정적으로 동작

무엇보다
👉 “왜 안 됐는지”를 설명할 수 있게 됐다는 게 가장 컸다!!(good)

 

 

 

이 에러는 논리 문제가 아닌, 구조 문제였다.

값이 많아질수록 OR은 위험하고, 어떻게 보면 단순무식한? 쿼리다.

다중 값 비교는 search.in()과 같이 다른 방식을 활용하는 것이 훨씬 더 좋아 보인다.

 

근데 이게 최선일까? 싶긴 하다..ㅎㅎㅎ;;

찾아보면 더 좋은 게 있을 거 같은데..

그건 미래의 내가 찾을 거다 ㅋㅋ