이 튜토리얼에서는 redis-cli에서 SMEMBERS 명령어를 사용하여 특정 키에 저장된 세트(Set) 값의 모든 요소를 한 번에 가져오는 방법을 알아봅니다. SMEMBERS는 Redis에서 가장 기본적이면서도 자주 사용되는 세트 관련 명령어 중 하나로, 지정한 키에 저장된 세트의 전체 멤버를 배열 형태로 반환합니다.
문법(Syntax)
redis host:port> SMEMBERS <key name>
<key name> 자리에는 요소를 조회하고자 하는 세트가 저장된 키의 이름을 입력합니다.
반환 값(Output)
- 배열(Array): 해당 세트에 포함된 모든 요소를 담은 배열을 반환합니다.
- 에러(Error): 키가 존재하지만 저장된 값이 세트 타입이 아닌 경우(예: 문자열, 리스트, 해시 등) 에러를 반환합니다.
사용 예시(Example)
아래 예시는 SADD 명령어로 세트를 생성한 뒤, SMEMBERS로 전체 요소를 조회하는 과정을 보여줍니다.
참고 사항
- 키가 존재하지 않으면 에러 대신 빈 배열(empty array)을 반환합니다.
- 세트는 중복을 허용하지 않으므로, 반환되는 각 요소는 항상 고유합니다.
- 요소가 매우 많은 대형 세트를 다룰 때는 전체 데이터를 한 번에 가져오는 SMEMBERS보다 SSCAN 명령어를 사용해 점진적으로 조회하는 것이 성능 면에서 더 안전할 수 있습니다.
- 시간 복잡도는 O(N)으로, N은 세트에 저장된 요소의 개수입니다.
레퍼런스(References)
- Redis 공식 문서 – SMEMBERS Command Docs
지금까지 Redis 데이터스토어에서 세트 값의 모든 요소를 가져오는 방법에 대해 알아보았습니다. 이 글이 도움이 되었다면 아래 댓글로 의견을 남겨주시고, 주변에도 널리 공유해 주세요!