Redis HLEN 명령어 – 해시에 포함된 필드 개수 확인하기

이 튜토리얼에서는 redis-cli에서 HLEN 명령어를 사용하여 특정 키에 저장된 해시(hash) 값에 포함된 필드의 개수를 확인하는 방법을 알아봅니다.

HLEN 명령어란?

Redis의 해시는 하나의 키 아래에 여러 개의 필드(field)와 값(value) 쌍을 저장할 수 있는 자료구조입니다. HLEN 명령어는 지정한 키에 저장된 해시가 몇 개의 필드를 가지고 있는지 반환하며, 시간 복잡도는 O(1)로 매우 빠르게 동작합니다.

문법

redis host:port> HLEN <key name>

반환 값

• (integer) : 해시에 포함된 필드의 개수
• 0 : 해당 키가 존재하지 않는 경우
• 오류(Error) : 키는 존재하지만 저장된 값이 해시가 아닌 경우

예제

아래 예제는 HSET 명령어로 여러 필드를 추가한 뒤, HLEN을 실행하여 해시에 포함된 필드의 개수를 확인하는 과정을 보여줍니다.

활용 팁

HLEN은 키가 존재하지 않아도 오류 대신 0을 반환하므로, 애플리케이션에서 해시의 크기를 안전하게 조회할 때 유용하게 사용할 수 있습니다. 다만 키에 해시가 아닌 문자열이나 리스트 등 다른 타입의 값이 저장되어 있다면 WRONGTYPE 오류가 발생하므로 주의해야 합니다.

참고 자료

1. Redis 공식 문서 – HLEN Command Docs

지금까지 Redis 데이터 스토어에 저장된 해시 값에 포함된 필드의 개수를 확인하는 HLEN 명령어의 사용법을 살펴보았습니다. 이 글이 도움이 되었다면 댓글로 의견을 남겨주시고, 주변에도 널리 공유해 주세요!