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) field | key 옵션에 지정한 필드가 입력 행에 없습니다. | 입력 행에 해당 필드가 있는지 확인합니다. |
설명
파이프로 들어온 행마다 key 필드의 값을 키로 Redis DEL 명령을 실행하고, 삭제된 키 수를 deleted 필드로 추가합니다. 쿼리 시작 시 접속을 한 번 맺고 모든 행에 재사용합니다.
존재하지 않는 키는 오류가 아니라 deleted=0으로 기록됩니다. 삭제는 되돌릴 수 없으므로 대상 키를 먼저 조회로 확인한 뒤 실행하는 것이 좋습니다.
사용 예
예시: 만료된 세션 키 삭제
상황: 사용자 ID에 해당하는 세션 키를 삭제합니다.
예상 결과:
| session_key | deleted |
|---|---|
| session:1001 | 1 |
결과 해석: deleted가 0이면 이미 없는 키입니다.