Redis ZSCORE 명령어 – 정렬된 집합(Sorted Set)에서 요소의 점수 조회하는 방법

이 튜토리얼에서는 Redis에 저장된 정렬된 집합(sorted set) 값에서 특정 요소의 점수(score)를 조회하는 방법을 알아봅니다. 이를 위해 Redis의 ZSCORE 명령어를 사용합니다.

ZSCORE 명령어는 지정된 키(key)에 저장된 정렬된 집합 값에서 특정 요소의 점수를 반환하는 데 사용됩니다. 요소가 정렬된 집합에 존재하지 않거나 키 자체가 존재하지 않으면 nil을 반환하며, 키는 존재하지만 해당 키에 저장된 값이 정렬된 집합 데이터 타입이 아닌 경우에는 에러가 반환됩니다. 참고로 ZSCORE 명령어는 시간 복잡도 O(1)로 동작하므로 매우 빠른 성능을 제공합니다. Redis ZSCORE 명령어의 기본 문법은 다음과 같습니다.

문법 :-

redis host:post> ZSCORE <keyname> <element>

반환값(출력) :-

- (string) 응답 : 정렬된 집합에 저장된 요소의 점수를 문자열(double 형식)로 나타냅니다.
- (nil) : 요소가 정렬된 집합에 존재하지 않거나 키가 존재하지 않는 경우.
- Error : 키는 존재하지만 저장된 값이 정렬된 집합 타입이 아닌 경우.

예제 :-

활용 팁

• 리더보드 구현 시 특정 사용자의 점수를 실시간으로 확인할 때 유용하게 활용할 수 있습니다.
• 요소의 점수를 변경하고 싶다면 ZADD 명령어를 사용하여 기존 요소의 점수를 갱신할 수 있습니다.

참고 자료 :-

1. ZSCORE 공식 문서(Redis Docs)

지금까지 Redis 데이터 스토어에 저장된 정렬된 집합 값에서 요소의 점수를 조회하는 방법에 대해 알아보았습니다. 이 글이 도움이 되셨다면 댓글로 의견을 남겨주시고, 주변에도 널리 공유해 주세요.