AI로 번역했습니다. 아직 커뮤니티의 검토를 거치지 않았습니다. 영어로 읽기

블로그 · 2023년 9월 15일 · Steve Simpson · 통합

Salesforce Bulk API 단계: 하역장에서 데이터 가져오기

소개:

이 글에서는 대량의 데이터 세트를 Salesforce로 효율적으로 가져오도록 설계된 강력한 도구, Salesforce Bulk API를 살펴봅니다. 호출당 200개 레코드로 제한되는 REST API와 달리, Bulk API는 간소화된 과정으로 수백만 개의 레코드를 삽입할 수 있게 해 줍니다.

섹션 1: Bulk API 과정 이해하기

Salesforce Bulk API는 대량의 데이터를 매끄럽게 가져오기 위해 다섯 단계로 작동합니다.

다이어그램: 외부 클라이언트가 REST API로 호출당 200개씩 1,000,000개 레코드를 적재하려면 API 호출이 5,000번 필요하다 다이어그램: 외부 클라이언트와 Salesforce 사이의 Bulk API 다섯 단계. 작업 열기, 파일 업로드, 처리 시작, 상태 확인, 성공과 실패 다운로드

  1. 작업 열기(1단계): 작업을 열어 과정을 시작하면 고유한 작업 ID를 받습니다. 하역장에 들어갈 수 있는 번호표를 받는 것과 비슷합니다.
  2. 파일 업로드(2단계): 작업 ID로 CSV 형식의 데이터 파일을 업로드하기 시작할 수 있습니다. 각 파일에는 크기 제한 안에서 최대 10,000개 레코드를 담을 수 있습니다. 같은 작업 ID 아래 여러 파일을 업로드할 수 있습니다.
  3. 처리 시작(3단계): 업로드가 끝나면, 비유하자면 “커다란 파란 버튼”을 눌러 Salesforce에 데이터 처리를 시작하라고 알립니다. 그러면 Salesforce가 업로드된 파일을 처리하기 시작합니다.
  4. 작업 상태 확인(4단계): 처리 중에 작업 ID로 작업 상태를 물어볼 수 있습니다. 이 단계로 데이터 가져오기의 진행 상황을 지켜볼 수 있습니다.
  5. 결과 다운로드(5단계): 처리가 끝나면 결과를 다운로드할 수 있습니다. 새로 삽입되거나 업데이트된 레코드의 Salesforce ID가 담긴 성공 레코드, 또는 발생한 오류의 세부 정보가 담긴 실패 레코드 중에서 고를 수 있습니다.

섹션 2: Postman으로 Bulk API 시연하기

Bulk API 과정을 보여 드리기 위해 Postman으로 Salesforce 샌드박스와 상호작용하겠습니다.

  1. 인증: 먼저 인증해서 액세스 토큰을 받습니다.
  2. 새 작업 만들기: 작업 생성 요청을 보내 새 작업을 시작합니다. 그러면 작업 ID를 받습니다.
  3. 데이터 업로드: URL에 작업 ID를 넣고 데이터를 업로드합니다. 이 예에서는 “Bart Buildings”라는 새 계정을 만듭니다.
  4. 처리 시작: 작업 ID와 “Upload Complete” 상태를 담은 요청을 보내 Salesforce에 처리를 시작하라고 알립니다.
  5. 작업 상태 확인: 작업 ID로 상태를 확인하며 진행 상황을 지켜봅니다. 작업이 끝나면 다음 단계로 넘어갈 수 있습니다.
  6. 성공 레코드 다운로드: 작업 ID로 성공 레코드를 다운로드해 새로 만든 레코드의 Salesforce ID를 가져옵니다.

Postman 스크린샷, 1단계: Bulk API 수집 작업을 만드는 POST, 응답에 새 작업 ID가 보인다 Postman 스크린샷, 2단계: CSV 데이터를 작업에 업로드하는 PUT, 201 Created를 반환한다 Postman 스크린샷, 3단계: 작업 상태를 UploadComplete로 설정해 처리를 시작하는 PATCH Postman 스크린샷, 4단계: 작업 상태를 확인하는 GET, JobComplete가 보인다 Postman 스크린샷, 5단계: 성공한 결과를 CSV로 다운로드하는 GET, 새 레코드 ID가 보인다

섹션 3: 결론

Salesforce Bulk API는 최소한의 API 호출로 대량의 데이터 세트를 Salesforce에 가져오는 효율적인 방법입니다. 간단한 다섯 단계로 수백만 개의 레코드를 효율적으로 삽입하고, 업데이트하고, 삭제까지 할 수 있습니다. 레코드 하나든 수백만 개든, Bulk API는 데이터 가져오기에 빠르고 믿을 수 있는 해법을 줍니다.

계속 지켜봐 주세요

Salesforce Bulk API를 함께 살펴봐 주셔서 감사합니다. Salesforce의 강력한 기능을 활용하는 더 유익한 콘텐츠를 기대해 주십시오!

www.SteveTechArc.com과 YouTube 채널 @SteveTechArc (opens in a new tab)에 함께하십시오. 구독하고 Salesforce와 그것을 다른 시스템과 통합하는 방법에 대한 이해를 넓히십시오.

동료 아키텍트와 아키텍트의 길을 걷는 분들에게 통합 지식을 나누며 세상을 바꾸는 데 힘을 보탭니다!

AI의 도움을 받은 대본

STA 1.7