더 나은 인프라 선택을 위한 독립 가이드 THE INFRASTRUCTURE EDIT
OPERATIONS / NODEPICK GUIDE

Redis SCAN으로 센 키가 중복되면 버그인가요?

SCAN은 점진 순회이며 모든 호출을 합쳤을 때 중복이 없다고 보장하지 않습니다. 반환 개수를 단순 합산하면 고유 키 수와 달라질 수 있습니다. 순회 중 자료가 바뀌는 경우의 보장도 따로 읽어야 합니다.

노드픽 에디토리얼작성·업데이트 2026-11-04
Redis SCAN으로 센 키가 중복되면 버그인가요?의 주제를 표현한 AI 콘셉트 이미지
AI 제작 콘셉트 이미지입니다. 특정 시설·제품의 실사진이 아닙니다.
먼저 기억할 핵심
  • SCAN 반복에서는 같은 요소가 다시 나올 수 있습니다
  • 커서와 처리 중복을 애플리케이션에서 관리합니다
  • 운영 조회의 부하와 일관성 요구를 구분합니다

SCAN 반복에서는 같은 요소가 다시 나올 수 있습니다

SCAN은 점진 순회이며 모든 호출을 합쳤을 때 중복이 없다고 보장하지 않습니다. 반환 개수를 단순 합산하면 고유 키 수와 달라질 수 있습니다. 순회 중 자료가 바뀌는 경우의 보장도 따로 읽어야 합니다.

커서와 처리 중복을 애플리케이션에서 관리합니다

커서를 이어가며 완료 조건을 확인하고 고유 개수가 필요하면 중복 제거 방식을 준비합니다. 키에 작업을 적용한다면 같은 요소에 두 번 적용해도 안전한지 검토합니다. COUNT를 정확한 반환 개수 보장으로 생각하지 않습니다.

운영 조회의 부하와 일관성 요구를 구분합니다

큰 데이터에서 편리하다고 KEYS 전체 조회로 바꾸면 응답을 막을 수 있습니다. 필요한 것은 대략 현황인지 특정 시점의 정확한 수인지 먼저 정합니다. 시험 데이터로 순회와 중복 처리를 검증한 뒤 운영 범위를 정합니다.

서버 운영 실행 전 점검표

  • SCAN 반복에서는 같은 요소가 다시 나올 수 있습니다
  • 커서와 처리 중복을 애플리케이션에서 관리합니다
  • 운영 조회의 부하와 일관성 요구를 구분합니다
조건을 넣어 직접 계산하기 →

이 가이드의 근거 문서

출처 확인일: 2026-11-04. 공식 문서에 기반한 편집 가이드이며 직접 수행한 벤치마크가 아닙니다. 비용 사례는 명시된 가정에 한합니다.

  1. Redis 공식 문서 ↗
오류 제보 방법

함께 읽으면 좋은 가이드