Loading

Data Loader에서 외부 ID를 사용해 관련 레코드 가져오기

게시 일자: Jun 19, 2025
상세 설명
이 기사는 영어 버전을 번역한 것으로, 일부 기계번역이 포함되어 있어 내용은 추후 업데이트될 수 있습니다. 최신 내용은 영어 버전을 참고하시기 바랍니다. 화면 오른쪽 하단의 언어 이름에서 표시 언어를 변경할 수 있습니다.
 

Data Loader에서 업서트 작업을 처리할 때 관련 레코드의 Salesforce 레코드 ID 대신 외부 ID를 사용하여 레코드를 서로 연관시키거나 연결할 수 있습니다.

예를 들면 개체 (B)에 다른 개체 (A)에 대한 조회 필드가 있을 경우, 개체 (A)에서 외부 ID로 표시된 필드의 값을 사용하여 둘을 연관지을 수 있습니다(개체 B를 개체 A의 레코드로). 외부 ID를 사용해 가져오기를 할 수 있나요? 에서 외부 ID와 그 사용 목적에 대해 알아보세요.

솔루션


몇 가지 고려 사항: 

  • 어떤 Data Loader 작업을 수행하든 항상 먼저 데이터를 백업하세요. 내보내기 서비스를 통해 백업 데이터 내보내기를 사용하거나 Data Loader를 통해 적합한 개체에 대한 데이터 내보내기 를 선택할 수 있습니다. 먼저 하나 또는 몇몇의 레코드를 시험적으로 활용해 그에 대응하는 Salesforce 내 레코드를 확인하여 작업이 성공적으로 이뤄지는지 검증하세요. 결과가 올바르다는 것이 확인되면 모든 레코드에 대하여 적절한 삽입, 업데이트, 업서트 작업을 수행합니다. 더 상세한 내용은 Salesforce에서 백업 데이터 내보내기 에서 확인하세요.
 
  • 모든 참조 필드를 외부 ID에 매핑하지 못할 수도 있습니다. 예를 들어 표준 활동 개체의 Related To (WhatId) 및 Name (WhoId) 필드와 사용자 지정 개체의 Owner 필드와 같은 다형 필드는 외부 ID로의 매핑을 허용하지 않습니다. 다형 필드에서 외부 키 활성화하기 기능을 원하신다면 해당 아이디어에 대한 지지 의견을 남길 수 있습니다. 아이디어는 Salesforce의 향후 릴리스에 추가될 수 있습니다. 다형 필드에 대한 자세한 내용은 관계 필드와 다형 필드 이해를 참조하세요.

 


외부 ID를 사용한 관련 레코드 가져오기에 대한 비디오 가이드

Data Loader를 사용해 레코드를 외부 ID를 사용하여 업데이트하는 방법


외부 ID를 사용하여 관련 레코드 가져오기

필드가 외부 ID로 표시된 경우, Salesforce 레코드 ID와 유사하게 ID 값을 사용하여 관련 기록을 서로 일치시키고 연결할 수 있습니다. 외부 ID는 외부 시스템의 고유 레코드 식별자를 저장하는 데 흔히 사용되며, 매번 기존 및 관련 Salesforce 레코드 ID를 통해 가져오기 파일을 준비하지 않더라도 데이터를 수시로 가져올 수 있게 해줍니다.
 

1. 매칭에 사용할 개체 A의 기존 외부 ID 필드를 식별하고(또는 개체 A에서 데이터 유형이 '텍스트'인 새 사용자 지정 필드를 통해 외부 ID 생성), 외부 ID 및 고유 필드 특성을 선택합니다.

참고: 외부 ID 만들기에 대한 자세한 내용은 사용자 지정 필드 만들기 와 사용자 지정 필드 속성 관련 도움말 문서를 참조하세요.

2. Salesforce의 관련 레코드(이 예시에서는 개체 A)에 외부 ID 필드를 채웁니다.

관련 개체 (A) 레코드가 Salesforce에 이미 존재하는 경우 다음을 따릅니다.

- 추후 레코드를 연관시킬 때 매칭 기준으로 간편하게 활용할 수 있도록, 외부 ID 가 고유 값으로 채워져 있는지 확인하세요.

기존 레코드에 외부 ID 필드가 채워져 있지 않을 경우, 다음과 같이 원하는 값으로 대량 업데이트할 수 있습니다.​

A) 보고서 작성 이후 보고서 내보내기 를 하거나 Data Loader를 사용해 데이터 내보내기 를 해서 모든 개체 A 레코드를 포함하는 .CSV 파일을 만듭니다. 

참고: 보고서 또는 내보내기 파일의 개체 A 레코드에 Salesforce ID가 포함되어야 합니다.

B) 준비된 내보내기 파일을 외부 ID 필드에 대해 원하는 고유 값으로 채운 다음 Salesforce ID와 외부 ID 필드를 매핑하여 기존 레코드에 대한 업데이트를 수행합니다.

관련 개체 (A) 레코드가 Salesforce에 아직 존재하지 않는 경우 다음을 따릅니다.
 

개체 A 레코드에 대한 고유 식별자 역할을 할 데이터가 포함된 열을 식별한 다음 식별해냈거나 1단계에서 레코드를 삽입할 때 만들어 둔 외부 ID 필드로 이를 매핑합니다. 개체 A 가져오기 파일에서 매핑하도록 선택한 고유 값은 개체 B 가져오기 파일에 이미 포함되어 있거나 외부 시스템의 파일에 포함되어 있는 것이 가장 바람직합니다.
 

3. 새 레코드에 대해 삽입을 수행하거나 개체 A의 기존 레코드를 업데이트합니다. 필수 필드와 외부 ID 열을 1단계 개체 A 레코드의 외부 ID 필드에 매핑하여(업데이트 또는 업서트 작업을 위해서 Salesforce ID를 포함하고 매핑해야 함) 개체 A의 모든 레코드에 대해 Salesforce의 고유 외부 ID 값을 채웁니다.

더 자세한 내용은 Data Loader를 사용해 데이터 삽입, 업데이트, 삭제하기 도움말 자료에서 확인하세요.


4. 매칭에 사용할 관련 개체 A 레코드에 대응하는 외부 ID 값을 사용해 개체 B 파일을 준비한 다음, 아래와 같은 방법을 통해 개체 B에서 개체 A로의 조회 필드를 채웁니다.
 

  • 개체 B에 대한 .CSV 파일로 이동해 1~3단계에서 개체 A의 레코드에 대해 설정한 외부 ID 값에 매치되는 고유 데이터가 포함된 기존 열을 선택하거나, 혹은 'External ID'라는 이름으로 새로운 열을 만들어 수동으로 채워넣어서(Excel의 vlookup 함수를 사용해도 됨) 개체 A 레코드에 설정한 외부 ID 값을 가져옵니다.

5. Data Loader에서:

a. Upsert를 클릭합니다.
b. 해당하는 개체(이 예에서는 개체 B)를 선택합니다.
c. 찾아보기를 클릭합니다.
d. Object B의 가져오기 파일을 선택합니다.
e. 다음을 클릭합니다.


6. 2단계: '관련 개체 선택'에서 개체 A 드롭다운에 대한 외부 ID 필드를 선택하여, 개체 B 레코드를 가져올 때 관련 개체 A 레코드를 매치할 수 있습니다.


7. 3단계: '매핑'에서 이름 구문 [ObjectName]:[ExternalIDField__c]을 사용해 Salesforce 필드를 마우스로 끌어다가 개체 A의 레코드에 대한 외부 ID 값을 포함하고 있는 개체 B 파일의 열에 매핑합니다(여기서는 이름 구문 [ObjectName]이 '개체 A'이며 [ExternalIDField__c]는 1단계에서 개체 A의 외부 ID 필드의 API 이름임). 
 

  • 이렇게 생성한 외부 ID를 사용하여 개체 B 레코드를 개체 A 레코드와 간편하게 연관지으면 개체 A의 레코드를 가져오거나, 새로운 ID를 내보내거나, Excel에서 둘을 매치하고 하위 레코드를 가져오는 과정을 거치지 않아도 됩니다.
Knowledge 기사 번호

000383207

 
로드 중
Salesforce Help | Article