Lambda로 SQS 업무를 묶어 처리한다면 실패한 항목만 다시 받도록 응답하기

한 장의 그림으로 이해하기

문서 작업장의 가상 예시입니다. 종이 세 장은 SQS 메시지 묶음, 체크 표시 두 장은 처리 성공, 찢어지고 X가 있는 한 장은 처리 실패에 대응합니다. 작업자가 성공한 문서를 선반에 남기고 실패한 문서만 수리대로 가져가는 동작은 부분 배치 응답으로 재처리 대상을 구분하는 뜻입니다. 곡선 화살표는 실패 항목의 재시도를 나타냅니다. 표준 큐에서 올바른 설정과 실패 ID 응답을 갖춘 경우를 단순화했으며 실제 측정값이나 내부 저장 구조가 아닙니다. 함수 전체 예외와 FIFO의 미처리 항목 반환, 별도의 중복 업무 방지 처리는 그림에서 생략했습니다.
내용의 흐름을 표현한 설명용 그림입니다. 실제 제품 화면이나 실행 결과가 아닙니다.
그림 크게 보기 ↗ (새 탭)

업무·자동화 · 판정 관망

그림을 글로 풀면

묶음 안의 결과를 나누어 돌려주기

부분 배치 응답을 설정하고 실패 ID를 반환하면 성공 항목의 불필요한 재처리를 줄일 수 있습니다.

대상
SQS와 Lambda로 AI 문서 업무를 처리하는 개발자
무엇이 바뀜
함수 오류 한 건과 묶음 전체의 결과를 구분합니다.
왜 중요한가
성공 문서까지 다시 처리하면 결과 저장이 겹칠 수 있습니다.
지금 할 일
이벤트 소스 설정과 함수의 실패 ID 응답을 함께 확인하세요.
한계·미확인
표준 큐의 가상 예시. 함수 전체 예외·FIFO 예외 확인 필요. AWS 실행 없음.
공식 출처
docs.aws.amazon.com
확인일
2026-10-18

재작업대로 보낼 문서를 먼저 구분하기

가상의 문서 분류 업무에서 한 묶음의 일부만 처리에 실패했다고 생각해 봅니다. 그림의 작업자는 성공한 문서를 선반에 남기고 실패한 문서를 다시 가져갑니다. AINOW는 전체 호출의 성공 여부와 개별 업무의 결과를 따로 기록하고, 어떤 항목을 다시 처리할지 식별자로 연결하는 점검을 제안합니다.

설정과 함수 응답이 함께 맞아야 합니다

AWS 문서는 SQS 배치 처리 중 오류가 나면 기본적으로 성공한 메시지를 포함한 묶음 전체가 다시 보일 수 있다고 설명합니다. 부분 배치 응답을 사용하려면 이벤트 소스 매핑의 FunctionResponseTypes에 ReportBatchItemFailures를 지정하고, 함수가 batchItemFailures 안에 실패한 메시지 ID를 itemIdentifier로 반환하도록 구현해야 합니다. 설정만 켜고 응답을 그대로 두는 것으로는 충분하지 않습니다.

전체 예외와 FIFO는 따로 점검하기

함수가 예외를 던져 종료되면 전체 배치가 실패로 간주됩니다. FIFO 큐에서는 첫 실패 뒤 처리를 멈추고 실패 항목과 아직 처리하지 않은 항목을 함께 반환해야 순서를 지킬 수 있습니다. AINOW는 작은 시험 묶음으로 성공·실패·미처리 기록을 대조한 뒤 적용하는 절차를 제안합니다. 이번에는 실제 Lambda 호출, 재전달 또는 중복 저장 방지 시험을 수행하지 않았습니다.

참고 원문: AWS 공식 문서 — Lambda의 SQS 오류 처리와 부분 배치 응답 · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-18

AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.

이 글의 검증 카드

자료 버전
2026-10-18 Lambda SQS 상시 문서 확인. ReportBatchItemFailures·batchItemFailures·itemIdentifier, 예외 및 FIFO 조건. AWS 실행 없음
확인일
2026-10-18
검증 상태
개발자 주장
한계·주의
표준 큐의 가상 예시. 함수 전체 예외·FIFO 예외 확인 필요. AWS 실행 없음.

함께 더 정확하게

질문·오류 제보

그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.

공개된 질문·제보

    아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.