한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
업무·자동화 · 판정 관망
그림을 글로 풀면
묶음 안의 결과를 나누어 돌려주기
부분 배치 응답을 설정하고 실패 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 실행 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.