Loading

Data Loader의 일반적인 오류 메시지

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

다음은 Data Loader를 사용하여 레코드를 업데이트하거나 삽입할 때 나타나는 일반적인 Data Loader 오류 목록입니다.

솔루션

 

오류: 행이 머리글보다 큰 경우

원인: 매핑할 머리글이 없는 필드에 데이터가 있습니다.

해결 방법: 각 열을 검토하고 머리글이 있는지 확인합니다. 참고: 문제 셀에 예기치 않게 데이터가 포함될 수 있으므로 데이터 집합 아래의 여러 열과 행을 검토하세요.
 

 

오류: 개체 ID에 대한 액세스 권한이 부족하거나 상호 참조 ID에 대한 액세스 권한이 부족

자세한 내용은 데이터 로더 구성을 검토하세요.

원인: 작업을 수행하는 사용자가 참조되는 레코드 또는 개체에 액세스할 수 없습니다. 예:

  • 참조하는 레코드가 삭제되었습니다.
  • 참조하는 레코드가 없습니다(예: 레코드 ID 필드의 오타로 인한 오류).
  • 참조하는 레코드가 있지만 삽입하거나 업데이트하는 레코드의 소유자와 공유되지 않습니다.
  • 참조하는 레코드가 존재하지만 삽입 또는 업데이트를 실행하는 사용자와 공유되지 않습니다.
  • 레코드에 할당된 레코드 유형에 액세스할 수 없습니다.


해결 방법: 문제가 있는 행을 식별하려면 Data Loader 배치 크기를 1로 줄입니다. 브라우저 URL의 .com/ 뒤에 ID를 붙여 넣고 Salesforce에서 관련 레코드를 열어 해당 행에 대한 ID를 포함하는 열의 각 인스턴스를 확인합니다. 참고: 레코드 유형이나 Lightning의 개체와 같은 일부 ID에는 고유한 URL이 있습니다. 이러한 상황에서 먼저 사용자 인터페이스에서 유사한 레코드를 열어 적절한 URL을 구성합니다.


 

오류: 중복 값 검색됨

원인: 이는 '고유 ID' 필드 내의 중복으로 인해 발생합니다. '고유 ID'는 "고유 ID" 상자를 선택한 사용자 정의 필드에 속합니다. 



해결 방법: '중복 값 검색' 오류가 표시되면 중복 항목을 제거해야 합니다. 파일에서 문제가 되는 행을 식별할 수 있도록 배치 크기를 1로 줄입니다. 대상 개체에 대한 설정 섹션을 열고 설정에서 Data Loader 작업에서 매핑한 각 필드(열)를 검토하고 고유한 속성을 선택한 필드를 식별합니다. Data Loader를 사용하여 중복 값이 포함된 레코드를 쿼리하여 파일에서 중복 레코드의 영향을 받는 필드 값을 식별하고 조정합니다.


 

오류: 잘못된 레코드 유형의 ID 값

원인: 레코드 유형은 이름이 아닌 ID를 입력해야 합니다.

해결 방법: 레코드 유형의 파일 값을 검토하고 해당 레코드 유형 ID를 입력합니다. 자세한 내용은 레코드 유형의 ID 찾기를 참조하세요. 또한 RecordType에 대한 SOAP API 개발자 가이드도 검토하세요.

 

오류: java.lang.OutOfMemoryError: Java heap space(java.lang.OutOfMemoryError로 인해 종료: Java 힙 공간)

원인: Java에 데이터 로드 작업을 수행하도록 시도하는 로컬 시스템에 전체 메모리 자원이 부족합니다.

해결 방법: 자세한 내용은 오류 Data Loader에서 'Java Heap Space' 오류 기사를 참조하십시오.


 

오류: 소유자 ID: 잘못된 유형의 ID 값:

원인

  • 레코드 소유자는 이름이 아닌 ID를 입력해야 합니다.
  • 이 오류는 표시된 ID의 값이 다른 개체에 대해 지정된 레코드와 관련된 룩업 필드에도 나타납니다.


해결 방법:

  • 영향을 받는 행을 찾아 사용자 이름을 ID로 변경합니다. 자세한 내용은 Salesforce 사용자 ID 찾기를 참조하세요.
  • ID를 오른쪽 개체의 오른쪽 레코드의 ID로 변경합니다.


 

오류: System.Exception: SOQL 쿼리가 너무 많음

원인 1: 개체에 대한 트리거가 Apex 관리자의 한계를 초과하고 있습니다.

원인 2: 배치 크기가 더 높은 숫자로 설정됩니다. 레코드가 하나씩 처리되도록 배치 크기를 1로 줄여 보십시오.

해결 방법: 배치 크기를 줄이면 문제를 완화하는 데 도움이 될 수 있지만 장기적인 해결 방법은 개발자와 협력하여 디버그 로깅을 설정하여 코드를 검토하고 대량화할 수 있는 문제가 있는 Apex를 식별하는 것입니다.

 

오류: 배치 오류로 인해 처리되지 않음: 유효하지 않은 배치: CSV 머리글 구문 분석 실패

원인: 이 오류는 "대량 API 사용" 옵션이 활성화된 경우에만 발생합니다.

해결 방법: 한 개 이상의 필드가 매핑되거나 필드 매핑 단계를 건너뛰지 않아야 합니다. 자세한 내용은 Data Loader 필드 매핑 정의를 참조하세요.


 

오류: 오류: 레코드만 삽입할 경우 이름 열이 매핑되어야 함

원인: 해당 개체의 이름 표준 필드가 CSV 파일에 포함되어 있지 않을 경우 발생합니다.

해결 방법: 파일에 이름 열을 포함하고 각 레코드의 이름을 지정하고 삽입 시 매핑합니다.


 

오류: 'CSV 오류: CSV 파일 형식이 잘못되었습니다. 다른 파일을 선택하세요. 행 번호 읽기 오류: 데이터 열 수가 머리글의 열 수를 초과합니다.

원인: Data Loader 34.0은 쉼표 또는 탭으로 구분된 CSV 파일 사용 기능을 도입했습니다. 최소 1개의 셀에 쉼표로 구분된 파일이 탭 문자를 포함한 경우 Data Loader는 해당 탭을 추가 열로 읽습니다.

해결 방법: 텍스트 편집기를 사용하여 파일을 편집하고 문제의 셀 앞뒤에 따옴표를 추가합니다. 예: "123 Main St."


 

오류: 잘못된 번호(": 잘못된 번호: ")

원인: 숫자 필드를 대상으로 하는 셀(가져오기 파일)에 쉼표를 천 단위 구분 기호로 포함할 경우 이 오류가 반환됩니다.

해결 방법: 숫자 필드 값이 가져오기 파일에 쉼표 없이 입력되었는지 확인합니다. Excel에서 쉼표가 포함된 숫자 데이터를 강조 표시하고 셀 형식 선택...을 마우스 오른쪽 버튼으로 클릭합니다. 숫자 탭을 선택하고 Category: Number(범주: 번호)를 선택한 후 "Use 1000 Separator (,)(1000 구분 기호 사용(,))" 기본 설정이 선택 취소되었는지 확인합니다.


 

오류: 이미 진행 중인 그룹 멤버십 작업

이 오류는 사용자 역할 정보를 업데이트할 때 발생하며, 공유 규칙을 설정한 경우 단일 레코드를 업데이트할 때마다 모든 공유 규칙이 다시 계산되므로 레코드는 업데이트되지 않습니다.

해결 방법:

  • Setup(설정)의 Quick Find(빠른 찾기) 상자에 공유 계산 연기를 입력한 다음 Defer Sharing Calculations(공유 계산 연기)를 선택합니다.
  • 공유 규칙 계산 관련 목록에서 Suspend(일시 중단)를 클릭합니다.
  • 공유 규칙, 역할, 영역 또는 공유 규칙에 참여하는 공개 그룹을 변경합니다.
  • 공유 규칙 계산을 사용하려면 변경 사항을 완료한 후 Resume(재개)을 클릭합니다.


 

오류: AccountAfterInsert: AfterUpdate 실행

원인: 계정 개체에 트리거가 활성화되어 있어 데이터 작업 중에 Apex가 실패합니다.

해결 방법: 배치 크기를 줄이면 문제를 완화하는 데 도움이 될 수 있지만 장기적인 해결 방법은 개발자와 공동으로 디버그 로깅을 설정하여 코드를 검토하고 대량화할 수 있는 문제가 있는 Apex를 식별하는 것입니다. 


 

오류: 해당 사용자 유형에 대한 작업이 유효하지 않음

원인: 이 오류는 할당 중인 사용자가 현재 비활성 상태일 때 발생합니다. 

해결 방법: 할당된 사용자가 '비활성' 상태인지 다시 확인합니다. 비활성 사용자가 소유한 레코드를 편집하려는 경우 시스템 관리자와 협력하여 '감사 필드 만들기'를 활성화할 수 있습니다.

참고: 위의 오류는 일반적인 오류입니다. 목록에 없는 오류가 발생할 수도 있습니다.



Knowledge 기사 번호

000384437

 
로드 중
Salesforce Help | Article