이 튜토리얼에서는 Redis 데이터스토어에 키로 저장된 부동 소수점 값을 나타내는 문자열을 지정한 값만큼 증가시키는 방법을 알아보겠습니다. 이를 위해 Redis의 INCRBYFLOAT 명령어를 사용합니다.
INCRBYFLOAT 명령어란?
INCRBYFLOAT 명령어는 키에 저장된 부동 소수점 숫자를 나타내는 문자열을 지정한 값만큼 증가시키는 데 사용됩니다. 이 명령어의 주요 특징은 다음과 같습니다.
- 키가 존재하지 않는 경우: 증가 연산을 수행하기 전에 해당 키가 먼저 생성되고 값이 0으로 설정됩니다.
- 잘못된 데이터 타입인 경우: 키가 존재하지만 저장된 값이 문자열 타입이 아니라면 오류가 반환됩니다.
- 유효하지 않은 값인 경우: 저장된 문자열 값이 배정밀도(double precision) 부동 소수점 숫자로 표현할 수 없는 형태라면 오류가 반환됩니다.
문법
redis host:post> INCRBYFLOAT <keyname> <increment>
- <keyname>: 증가시킬 값이 저장된 키의 이름입니다.
- <increment>: 기존 값에 더할 증가량(부동 소수점 숫자)입니다. 음수도 사용할 수 있습니다.
출력 결과
- (string) reply, representing the value of the key after the increment operation.
증가 연산 수행 후 키에 저장된 최종 값을 문자열 형태로 반환합니다.
사용 예제
예를 들어, SET mykey 10.50으로 값을 설정한 후 INCRBYFLOAT mykey 0.1을 실행하면 10.6이 반환되고, 키의 값도 10.6으로 갱신됩니다. 소수점 계산 시 정확도를 유지해야 하는 카운터나 점수 집계 등에 유용하게 활용할 수 있습니다.
참고 자료
- INCRBYFLOAT 공식 문서 (Redis Docs)
지금까지 Redis 데이터스토어에 저장된 부동 소수점 값을 나타내는 문자열을 증가시키는 INCRBYFLOAT 명령어에 대해 알아보았습니다. 이 글이 도움이 되었다면 댓글로 의견을 남겨주시고, 주변에도 공유해 주세요!