Redis SCARD 명령어 – Redis에서 집합(Set) 크기 확인하는 방법

이 튜토리얼에서는 redis-cli에서 SCARD 명령어를 사용하여 키에 저장된 집합(Set) 값의 크기, 즉 요소 개수를 확인하는 방법을 알아봅니다.

SCARD는 Redis의 집합 자료형 전용 명령어로, 지정한 키에 저장된 집합에 몇 개의 멤버가 있는지 정수 형태로 반환합니다. 대용량 데이터를 다룰 때도 O(1) 시간 복잡도로 즉시 결과를 얻을 수 있어 매우 효율적입니다.

문법

redis host:port> SCARD <key name>

반환값

(integer) 집합에 포함된 요소의 개수
(integer) 0, 키가 존재하지 않는 경우
Error, 키가 존재하지만 저장된 값이 집합(Set)이 아닌 경우

사용 예제

예를 들어, 'myset'이라는 키에 세 개의 멤버가 저장되어 있다면 다음과 같이 실행할 수 있습니다.

redis host:port> SADD myset "apple" "banana" "cherry"
(integer) 3
redis host:port> SCARD myset
(integer) 3

만약 해당 키가 존재하지 않으면 0이 반환되며, 키에 문자열 같은 다른 자료형이 저장되어 있다면 WRONGTYPE 에러가 발생하니 주의해야 합니다.

참고 자료

1. SCARD 공식 문서 (Redis Docs)

지금까지 Redis 데이터 저장소에 저장된 집합 값의 크기를 확인하는 SCARD 명령어 사용법을 살펴보았습니다. 이 글이 도움이 되었다면 댓글로 의견을 남겨주시고, 주변에도 널리 공유해 주세요!