Loading

Data Cloud: 수집 API 데이터 스트림에서 벌크 작업 중 간헐적인 실패 이해하기

게시 일자: Dec 4, 2025
상세 설명

Salesforce 수집 API를 사용할 때, 특히 스트리밍과 벌크 작업을 전환할 때 간헐적으로 데이터 스트림 오류가 발생할 수 있습니다. 이러한 오류는 벌크 작업을 위해 스트리밍 작업이 취소되었음을 나타냅니다. 오류가 발생한 것에 대해 우려할 수 있지만, 이는 일반적으로 양호한 상태이며 데이터 스트림에 영향을 미치지 않습니다.

솔루션

Salesforce의 수집 API 컨텍스트에서는 대규모 데이터 업로드 또는 삭제와 같은 벌크 작업을 원활하게 수행하기 위해 스트리밍 작업이 중단되는 경우가 있습니다. 일반적으로 이러한 작업은 문제 없이 취소되지만, 취소에 예상보다 오랜 시간이 걸리면 오류 상태가 반환되어 데이터 스트림 기록에 "실패" 표시가 나타나게 됩니다.
작동 방식은 다음과 같습니다.

  • 벌크 작업이 시작되면 진행 중인 스트리밍 작업이 취소됩니다. 이 취소를 통해 벌크 작업을 실행하고 완료한 다음 스트리밍 작업을 다시 시작할 수 있습니다.

  • 취소 프로세스가 너무 오래 걸리면 시스템에서 오류를 기록하여 "Cancelled Task(취소된 작업)"로 표시합니다. 그러나 벌크 작업이 완료된 후 스트리밍 작업이 재개되므로 이러한 표시가 실제 실패를 나타내는 것은 아닙니다.

  • 오류 상태가 표시되어도 벌크 작업은 예상대로 완료되며 데이터 스트림은 데이터 손실 없이 중단 지점부터 다시 시작됩니다.

이는 예상되는 동작이며 일반적으로 직접적인 개입이 필요하지 않습니다. 그러나 Salesforce는 벌크 작업 중과 같이 의도적으로 취소된 작업이 오류로 잘못 표시되지 않도록 UI를 개선하는 옵션을 모색하고 있습니다.

Knowledge 기사 번호

002630830

 
로드 중
Salesforce Help | Article