이 튜토리얼에서는 Redis의 LINSERT 명령어를 사용하여 키에 저장된 목록(list) 값에서 피벗(pivot) 요소 앞 또는 뒤에 새로운 요소를 삽입하는 방법을 알아봅니다.
LINSERT 명령어란?
LINSERT 명령어는 지정된 키에 저장된 목록 값에서 특정 요소(피벗)를 기준으로 BEFORE(앞) 또는 AFTER(뒤) 위치에 새로운 요소를 삽입합니다.
명령어 실행 결과는 다음과 같이 반환됩니다.
- 키가 존재하지 않으면 빈 목록으로 간주되어 0을 반환합니다.
- 키는 존재하지만 목록 안에 피벗 요소가 없으면 -1을 반환합니다.
- 삽입이 성공하면 목록의 전체 길이(요소 개수)를 반환합니다.
기본 문법
redis host:port> LINSERT <키 이름> [BEFORE|AFTER] <피벗 요소> <새로운 요소>
반환값 정리
- (integer) : 삽입 성공 후 목록의 전체 요소 개수 - -1 : 키는 존재하지만 목록에 피벗 요소가 없는 경우 - 0 : 키가 존재하지 않는 경우 - Error : 키는 존재하지만 해당 키에 저장된 값이 목록 타입이 아닌 경우
사용 예제
위 예제에서 확인할 수 있듯이, LINSERT 명령어는 BEFORE 옵션을 사용하면 피벗 요소 바로 앞에, AFTER 옵션을 사용하면 피벗 요소 바로 뒤에 새 요소를 추가합니다. 이 명령어는 Redis 목록(List) 자료구조에서 중간 위치에 데이터를 삽입해야 할 때 유용하게 활용됩니다.
참고 자료
- Redis 공식 문서 – LINSERT 명령어
지금까지 Redis 데이터 저장소에 저장된 목록 값에서 피벗 요소를 기준으로 앞 또는 뒤에 새로운 요소를 삽입하는 방법을 살펴보았습니다. 이 글이 도움이 되었다면 댓글로 의견을 남겨주시고, 주변에도 널리 공유해 주세요!