Redis HKEYS 명령어 – 해시에 저장된 모든 필드 이름 조회 방법

이 튜토리얼에서는 redis-cli에서 HKEYS 명령어를 사용하여 특정 키에 저장된 해시(hash) 값에 포함된 모든 필드의 이름을 조회하는 방법을 알아보겠습니다.

HKEYS 명령어는 지정한 키가 존재하지 않으면 빈 리스트(empty list)를 반환하고, 키는 존재하지만 해당 키에 저장된 값이 해시 데이터 타입이 아닌 경우에는 오류(error)를 반환합니다.

문법(Syntax)

redis host:post> HKEYS <keyname>

반환값(Output)

- (array) reply : 해시에 포함된 필드 이름들의 목록
- 빈 리스트 : 키가 존재하지 않는 경우
- 오류 : 키는 존재하지만 저장된 값이 해시 타입이 아닌 경우

예제(Example)

HKEYS 명령어 활용 팁

HKEYS는 해시 구조에서 어떤 필드들이 정의되어 있는지 빠르게 파악할 때 유용합니다. 다만, 해시에 저장된 필드 수가 매우 많은 경우 전체 필드를 한 번에 가져오므로 성능에 영향을 줄 수 있습니다. 대량의 데이터를 다룰 때는 HSCAN 명령어를 사용해 점진적으로 조회하는 것을 고려하는 것이 좋습니다.

참고 자료(References)

1. HKEYS 공식 문서 (Redis Command Docs)

지금까지 Redis 데이터 스토어에 저장된 해시 값에 포함된 모든 필드의 이름을 조회하는 방법에 대해 알아보았습니다. 이 글이 도움이 되었다면 댓글로 의견을 남겨주시고, 주변에도 공유해 주세요!