이 튜토리얼에서는 Redis 데이터 저장소에 저장된 해시(hash) 값 내 특정 필드에 저장된 숫자를 증가시키는 방법을 알아봅니다. 이를 위해 redis-cli에서 HINCRBY 명령어를 사용합니다.
HINCRBY 명령어는 키에 저장된 해시 값에서 지정한 필드의 숫자를 지정한 증가값(increment)만큼 증가시키는 데 사용됩니다. 동작 방식은 다음과 같습니다.
- 필드가 해시 값 안에 존재하지 않으면, 새로운 필드가 생성되고 증가값이 초기 값으로 설정됩니다.
- 키 자체가 존재하지 않으면, 주어진 필드만을 멤버로 가지는 새로운 해시가 생성됩니다.
- 증가값은 64비트 부호 있는 정수(signed integer)로 제한되므로 양수와 음수 모두 사용할 수 있습니다.
- 음수를 인자로 전달하면 필드 값이 오히려 감소(decrement)합니다.
단, 키가 존재하지만 해당 키에 저장된 값이 해시 타입이 아닌 경우에는 에러가 반환됩니다.
문법(Syntax)
redis host:post> HINCRBY <keyname> <field> <increment>
예를 들어 다음과 같이 사용할 수 있습니다.
redis host:post> HINCRBY user:1001 visit_count 1
redis host:post> HINCRBY product:500 stock -3
출력(Output)
- (integer) 응답: 해당 필드에 저장된 새로운 값을 정수 형태로 반환합니다.
- 에러: 키가 존재하지만 저장된 값이 해시 타입이 아닐 경우 WRONGTYPE 에러가 반환됩니다.
예제(Example)
참고 자료(References)
- HINCRBY 공식 문서(Redis 공식 Command Docs)
지금까지 Redis 데이터 저장소에 저장된 해시 값의 특정 필드 숫자를 증가시키는 방법에 대해 알아보았습니다. 조회수 카운터, 재고 관리, 좋아요 수 집계 등 원자적(atomic)으로 숫자를 늘리거나 줄여야 하는 상황에서 HINCRBY 명령어를 유용하게 활용하실 수 있습니다. 이 글이 도움이 되었다면 댓글로 의견을 남겨주시고, 주변에도 널리 공유해 주세요!