Redis에서 키 만료 시간 확인하기 – TTL & PTTL 명령어 완벽 가이드

이 튜토리얼에서는 Redis의 TTL 명령어와 PTTL 명령어를 사용하여 키(key)의 남은 만료 시간(timeout)을 조회하는 방법을 알아봅니다.

초 단위 만료 시간 조회 – TTL

키의 남은 만료 시간을 초 단위로 확인하려면 redis-cli에서 TTL 명령어를 사용합니다. 반환되는 초(second) 값은 해당 키가 데이터 저장소에서 삭제되기까지 남은 수명(time to live)을 의미합니다.

기본 문법

redis host:port> TTL <key name>

반환 값

-2 : 키가 존재하지 않는 경우
-1 : 키는 존재하지만 만료 시간이 설정되지 않은 경우
(integer) <남은 시간(초)>

사용 예시

밀리초 단위 만료 시간 조회 – PTTL

키의 남은 만료 시간을 밀리초(millisecond) 단위로 확인하려면 redis-cli에서 PTTL 명령어를 사용합니다. PTTL은 TTL 명령어와 거의 동일하게 동작하며, 유일한 차이점은 TTL이 초 단위 값을 반환하는 반면 PTTL은 밀리초 단위 값을 반환한다는 점입니다. 더 정밀한 시간 측정이 필요할 때 유용합니다.

기본 문법

redis host:port> PTTL <key name>

반환 값

-2 : 키가 존재하지 않는 경우
-1 : 키는 존재하지만 만료 시간이 설정되지 않은 경우
(integer) <남은 시간(밀리초)>

사용 예시

참고 자료

1. Redis 공식 문서 – TTL Command Docs
2. Redis 공식 문서 – PTTL Command Docs

지금까지 Redis 데이터 저장소에서 키의 남은 만료 시간을 확인하는 방법을 살펴보았습니다. 이 글이 도움이 되었다면 댓글로 의견을 남겨주시고, 주변에도 널리 공유해 주세요!