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 옵션에 지정한 필드 | 문자열 | Y | Redis 리스트 키 |
| 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) field | key 옵션에 지정한 필드가 입력 행에 없습니다. | 입력 행에 해당 필드가 있는지 확인합니다. |
| missing 필드명(value) field | value 옵션에 지정한 필드가 입력 행에 없습니다. | 입력 행에 해당 필드가 있는지 확인합니다. |
설명
파이프로 들어온 행마다 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
예상 결과:
| queue | job | length |
|---|---|---|
| queue:jobs | job-1003 | 1 |
결과 해석: length는 push 직후 리스트에 들어 있는 요소 수입니다.