gin_fuzzy_search_limit

GIN index scan이 반환하는 결과 집합 크기의 soft limit을 정한다. 기본값은 0으로, 제한이 없다.

full text search에서 아주 흔한 단어를 검색하면 결과가 수십만 row에 달해 사실상 쓸모가 없는데도 scan 비용은 그대로 치러야 한다. 이 파라미터를 0보다 크게 설정하면 GIN index scan이 대략 그 개수 근처에서 결과 반환을 멈춰 이런 부담을 줄일 수 있다. “soft” limit이라는 이름대로 정확히 그 개수를 보장하는 것이 아니라 근사적인 상한이며, 어떤 row가 제외될지도 결정적이지 않다.

일반적인 환경에서는 기본값 0을 유지하고, 검색어 빈도 편차가 큰 검색 서비스처럼 결과 폭주가 실제 문제인 경우에만 고려할 만한 파라미터다.

출처: PostgreSQL 18 문서