레디스 클라이언트

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

redis-del-batch

입력 행마다 키 필드의 키를 Redis 접속 프로파일에서 삭제합니다.

문법

redis-del-batch profile=STRING key=STRING

옵션

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

입력 필드

필드타입필수설명
key 옵션에 지정한 필드문자열Y삭제할 Redis 키

출력 필드

필드타입이름설명
deleted정수삭제 수삭제된 키 수. 키가 없으면 0
_error문자열에러해당 행의 DEL 실패 에러 메시지. 성공 시 없음

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

오류 코드

파싱 오류

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

런타임 오류

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

설명

파이프로 들어온 행마다 key 필드의 값을 키로 Redis DEL 명령을 실행하고, 삭제된 키 수를 deleted 필드로 추가합니다. 쿼리 시작 시 접속을 한 번 맺고 모든 행에 재사용합니다.

존재하지 않는 키는 오류가 아니라 deleted=0으로 기록됩니다. 삭제는 되돌릴 수 없으므로 대상 키를 먼저 조회로 확인한 뒤 실행하는 것이 좋습니다.

사용 예

예시: 만료된 세션 키 삭제

상황: 사용자 ID에 해당하는 세션 키를 삭제합니다.

json "{}"
| eval session_key="session:1001"
| redis-del-batch profile=my_redis key=session_key

예상 결과:

session_keydeleted
session:10011

결과 해석: deleted가 0이면 이미 없는 키입니다.