Redis LRANGE – 레디스 데이터 저장소에서 목록 값의 모든 요소를 가져오는 방법

이 튜토리얼에서는 키에 저장된 목록(list) 값의 모든 요소를 가져오는 방법을 알아보겠습니다. 이를 위해 레디스(Redis)의 LRANGE 명령어를 사용합니다.

LRANGE 명령어란?

LRANGE 명령어는 지정된 키에 저장된 목록 값에서 특정 오프셋(offset)으로 정의된 하나 이상의 요소를 반환합니다. 이 명령은 start(시작, 포함)와 end(끝, 포함) 오프셋을 인자로 받으며, 두 오프셋 모두 0부터 시작하는 인덱스입니다. 즉, 0은 첫 번째 요소, 1은 두 번째 요소를 의미합니다.

음수 인덱스도 사용할 수 있으며, 이 경우 목록의 끝에서부터 역방향으로 계산됩니다. 예를 들어 -1은 마지막 요소, -2는 끝에서 두 번째 요소를 의미합니다.

범위를 벗어난 오프셋 처리 방식

1. start > end : 결과로 빈 목록이 반환됩니다.
2. end > 목록 크기 : end 오프셋이 목록의 마지막 요소 인덱스로 자동 조정됩니다.

만약 키가 존재하지만 해당 키에 저장된 값이 목록 타입이 아니라면 에러가 반환됩니다.

문법

redis host:post> LRANGE <keyname> <start> <end>

출력 결과

- 지정된 오프셋 범위 내의 요소 목록을 나타내는 응답
- 키가 존재하지만 저장된 값이 목록 타입이 아닌 경우 에러

목록의 전체 요소 가져오기

목록 값의 모든 요소를 한 번에 가져오려면 start 오프셋으로 0, end 오프셋으로 -1을 지정하면 됩니다. 이렇게 하면 첫 번째 요소부터 마지막 요소까지 전체가 반환됩니다.

LRANGE <key name> 0 -1

예제

아래 이미지는 LRANGE 명령어를 사용하여 목록 값의 전체 요소를 조회하는 실제 실행 예시입니다.

참고 자료

1. LRANGE 공식 문서(Commands Docs)

<- List Commands

지금까지 레디스 데이터 저장소에 저장된 목록 값의 모든 요소를 가져오는 방법에 대해 알아보았습니다. 이 글이 도움이 되었다면 댓글로 의견을 남겨주시고, 주변에도 널리 공유해 주세요!