redis-lrange
Redis 리스트에서 지정한 범위의 요소를 요소마다 한 행으로 조회합니다.
문법
redis-lrange profile=STRING key=STRING [start=INT] [stop=INT]
옵션
- profile=STRING
- 필수 옵션. Redis 접속 프로파일 이름. Redis 클라이언트 (Standalone) 또는 Redis 클라이언트 (Sentinel) 타입의 프로파일을 지정합니다. 예: profile=my_redis
- key=STRING
- 필수 옵션. LRANGE할 Redis 리스트 키. 예: key=queue:jobs
- start=INT
- 선택 옵션. 시작 인덱스. 음수는 끝에서부터 센다. (기본값: 0)
- stop=INT
- 선택 옵션. 종료 인덱스. 해당 인덱스를 포함한다. (기본값: -1, 마지막 요소)
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| key | 문자열 | 키 | Redis 리스트 키 |
| index | 정수 | 인덱스 | 반환된 범위 안에서의 0부터 시작하는 위치 |
| value | 문자열 | 값 | 리스트 요소 |
| _error | 문자열 | 에러 | 명령 실패에 대한 에러 메시지. 성공 시 없음 |
오류 코드
파싱 오류
| 오류 메시지 | 원인 | 해결 |
|---|---|---|
| 사용 가능한 Redis 프로파일이 없습니다. | profile 옵션에 지정한 이름의 프로파일이 없거나 현재 계정에 사용 권한이 없습니다. | 프로파일 이름을 확인하고 해당 프로파일의 사용 권한을 부여합니다. |
| profile 옵션을 지정해야 합니다. | profile 옵션이 없거나 비어 있습니다. | profile=프로파일명 을 지정합니다. |
| key 옵션을 지정해야 합니다. | key 옵션이 없거나 비어 있습니다. | key=키 를 지정합니다. |
| start, stop 옵션은 정수여야 합니다. | start 또는 stop 값이 정수가 아닙니다. | 정수를 지정합니다. 예: start=0 stop=9 |
런타임 오류
| 오류 메시지 | 원인 | 해결 |
|---|---|---|
| (출력 행의 _error 필드) | Redis 접속 실패, 인증 실패, 타임아웃, WRONGTYPE 등 명령 실행 오류가 발생했습니다. 쿼리는 중단되지 않고 key와 _error만 담긴 한 행이 출력됩니다. | _error 필드의 메시지를 확인하고 접속 정보와 키 타입을 점검합니다. |
설명
Redis의 LRANGE 명령으로 리스트 요소를 조회해 요소마다 한 행으로 출력합니다. index는 리스트 전체 위치가 아니라 반환된 범위 안의 순번이므로, start를 지정해도 0부터 시작합니다. 파이프 입력을 받지 않는 시작 명령입니다.
리스트 키가 없거나 범위에 요소가 없으면 행이 출력되지 않습니다. 리스트가 아닌 타입의 키에는 WRONGTYPE 오류가 _error 필드로 출력됩니다. 리스트가 매우 크면 전체 요소를 한 번에 가져오므로 start와 stop으로 범위를 제한하는 것이 좋습니다.
사용 예
예시: 작업 큐 앞쪽 10건 조회
상황: 리스트 queue:jobs의 앞쪽 10개 요소를 확인합니다.
예상 결과:
| key | index | value |
|---|---|---|
| queue:jobs | 0 | job-1003 |
| queue:jobs | 1 | job-1002 |
결과 해석: LPUSH로 넣은 요소는 앞쪽에 쌓이므로 index 0이 가장 최근에 넣은 값입니다.