레디스 클라이언트

다운로드 1
업데이트 2026. 11. 18.

redis-lpush-batch

입력 행마다 값 필드의 값을 키 필드의 Redis 리스트 앞쪽에 push(LPUSH)합니다.

문법

redis-lpush-batch profile=STRING key=STRING value=STRING

옵션

profile=STRING
필수 옵션. Redis 접속 프로파일 이름. Redis 클라이언트 (Standalone) 또는 Redis 클라이언트 (Sentinel) 타입의 프로파일을 지정합니다. 예: profile=my_redis
key=STRING
필수 옵션. Redis 리스트 키가 담긴 입력 필드명. 예: key=queue
value=STRING
필수 옵션. LPUSH할 값이 담긴 입력 필드명. 예: value=job

입력 필드

필드타입필수설명
key 옵션에 지정한 필드문자열YRedis 리스트 키
value 옵션에 지정한 필드문자열Y리스트에 넣을 값

출력 필드

필드타입이름설명
length정수리스트 길이push 이후 리스트 길이
_error문자열에러해당 행의 LPUSH 실패 에러 메시지. 성공 시 없음

입력 행의 모든 필드가 그대로 전달되며, length 또는 _error 필드가 추가됩니다.

오류 코드

파싱 오류

오류 메시지원인해결
사용 가능한 Redis 프로파일이 없습니다.profile 옵션에 지정한 이름의 프로파일이 없거나 현재 계정에 사용 권한이 없습니다.프로파일 이름을 확인하고 해당 프로파일의 사용 권한을 부여합니다.
profile 옵션을 지정해야 합니다.profile 옵션이 없거나 비어 있습니다.profile=프로파일명 을 지정합니다.
key 옵션을 지정해야 합니다.key 옵션이 없거나 비어 있습니다.key=필드명 을 지정합니다.
value 옵션을 지정해야 합니다.value 옵션이 없거나 비어 있습니다.value=필드명 을 지정합니다.

런타임 오류

오류 메시지원인해결
(출력 행의 _error 필드)Redis 접속 실패, 인증 실패, 타임아웃, WRONGTYPE 등 행 처리 오류가 발생했습니다. 쿼리는 중단되지 않고 해당 행에 _error 필드가 추가됩니다. 접속에 실패하면 모든 행에 같은 오류가 기록됩니다._error 필드의 메시지를 확인하고 접속 정보와 키 타입을 점검합니다.
missing 필드명(key) fieldkey 옵션에 지정한 필드가 입력 행에 없습니다.입력 행에 해당 필드가 있는지 확인합니다.
missing 필드명(value) fieldvalue 옵션에 지정한 필드가 입력 행에 없습니다.입력 행에 해당 필드가 있는지 확인합니다.

설명

파이프로 들어온 행마다 value 필드의 값을 문자열로 변환해 key 필드가 가리키는 Redis 리스트의 앞쪽에 넣고, push 이후의 리스트 길이를 length 필드로 추가합니다. 쿼리 시작 시 접속을 한 번 맺고 모든 행에 재사용합니다.

리스트 키가 없으면 새로 만들어집니다. 리스트가 아닌 타입의 키에는 WRONGTYPE 오류가 해당 행의 _error로 기록되고 쿼리는 계속됩니다. 행 순서대로 앞쪽에 쌓이므로 나중에 들어온 값이 리스트 맨 앞에 위치합니다.

사용 예

예시: 작업 큐에 작업 등록

상황: 큐 queue:jobs에 작업 ID를 등록하고 큐 길이를 확인합니다.

json "{}"
| eval queue="queue:jobs", job="job-1003"
| redis-lpush-batch profile=my_redis key=queue value=job

예상 결과:

queuejoblength
queue:jobsjob-10031

결과 해석: length는 push 직후 리스트에 들어 있는 요소 수입니다.