Redis LTRIM 명령어 완벽 가이드 – 데이터 저장소의 기존 리스트 트리밍 방법

이번 튜토리얼에서는 Redis 데이터 저장소에 특정 키로 저장된 기존 리스트 값을 트리밍(잘라내기)하는 방법을 알아보겠습니다. 이 작업을 위해 LTRIM 명령어를 사용합니다.

LTRIM 명령어란?

LTRIM 명령어는 기존 리스트 값을 잘라내어, 결과적으로 지정한 범위의 요소만 남도록 만드는 명령어입니다. 범위는 start(시작 인덱스)와 end(끝 인덱스) 오프셋으로 정의되며, 두 값 모두 포함(inclusive)됩니다.

인덱스는 0부터 시작합니다. 즉, 0은 첫 번째 요소, 1은 두 번째 요소를 의미합니다. 또한 음수를 사용하면 리스트 끝에서부터 오프셋을 지정할 수 있습니다. 예를 들어 -1은 마지막 요소, -2는 뒤에서 두 번째 요소를 나타냅니다.

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

1. start > end : 결과는 빈 리스트가 되며, 해당 키는 삭제됩니다.
2. end > 리스트 크기 : 마지막 요소의 인덱스가 end 오프셋으로 간주되어 정상적으로 처리됩니다.

키가 존재하지만 해당 키에 저장된 값이 리스트 타입이 아닌 경우에는 에러가 반환됩니다.

문법

redis host:port> LTRIM <keyname> <start> <stop>

• keyname: 트리밍할 리스트가 저장된 키 이름
• start: 시작 인덱스 (포함)
• stop: 종료 인덱스 (포함)

반환값

- 성공 시: (string) OK
- 실패 시: 키가 존재하지만 값이 리스트 타입이 아닌 경우 에러 반환

사용 예시

예를 들어, mylist 키에 5개의 요소가 저장되어 있을 때 LTRIM mylist 0 2를 실행하면 처음 세 개의 요소만 남게 됩니다. 이처럼 LTRIM은 대량의 데이터 중 최근 항목만 유지하고 싶을 때 유용하게 활용됩니다.

참고 자료

1. LTRIM 공식 문서

지금까지 Redis 데이터 저장소에 저장된 기존 리스트 값을 트리밍하는 방법에 대해 알아보았습니다. 도움이 되었다면 댓글로 의견을 남겨주시고, 주변에도 널리 공유해 주세요!

<- 리스트 명령어 목록