복사 작업에서 Salesforce 구성
이 문서에서는 Azure 데이터 팩터리의 복사 작업을 사용하여 Salesforce간에 데이터를 복사하는 방법을 간략하게 설명합니다.
지원되는 구성
복사 작업 아래의 각 탭을 구성하려면 각각 다음 섹션으로 이동합니다.
일반
일반 설정 탭을 구성하려면 일반 설정 지침을 참조하세요.
Source
복사 작업의 원본 탭에서 Salesforce에 대해 지원되는 속성은 다음과 같습니다.
다음 속성은 필수입니다.
- 연결: 연결 목록에서 Salesforce 연결을 선택합니다. 연결이 없으면 새로 만들기를 선택하여 새 Salesforce 연결을 만듭니다.
- 쿼리 사용: 개체 API, 보고서 또는 SOQL 쿼리에서 선택합니다.
개체 API를 선택하는 경우:
- 개체 API: 데이터를 검색할 Salesforce 개체 이름을 지정합니다 드롭다운 목록에서 이름을 선택합니다.
보고서를 선택하는 경우:
보고서 ID: 데이터를 검색할 Salesforce 보고서의 ID를 지정합니다. 대상에서는 지원되지 않습니다. 보고서를 사용할 때는 제한 사항이 있습니다.
SOQL 쿼리를 선택하는 경우:
SOQL 쿼리: 사용자 지정 쿼리를 사용하여 데이터를 읽습니다. SOQL(Salesforce 개체 쿼리 언어) 쿼리는 제한 사항이 있는 경우에만 사용할 수 있습니다. 대량 API 2.0 쿼리 이해하기. SOQL 쿼리를 지정하지 않으면 개체 API 또는 보고서 ID에 지정된 Salesforce 개체의 모든 데이터가 검색됩니다.
고급에서 다음 필드를 지정할 수 있습니다.
- 삭제된 개체 포함: 기존 레코드를 쿼리할지(선택되지 않음) 또는 삭제된 레코드를 포함한 모든 레코드를 쿼리할지(선택됨) 지정합니다.
- 추가 열: 데이터 열을 추가하여 원본 파일의 상대 경로 또는 정적 값을 저장하세요. 식은 정적 값에 대해 지원됩니다.
대상
복사 작업의 대상 탭에서 Salesforce에 대해 지원되는 속성은 다음과 같습니다.
다음 속성은 필수입니다.
- 연결: 연결 목록에서 Salesforce 연결을 선택합니다. 연결이 없으면 새로 만들기를 선택하여 새 Salesforce 연결을 만듭니다.
- 개체 API: 데이터를 쓸 Salesforce 개체 이름을 지정합니다. 드롭다운 목록에서 이름을 선택합니다.
고급에서 다음 필드를 지정할 수 있습니다.
쓰기 동작: 작업에 대한 쓰기 동작을 지정합니다. 허용되는 값은 Insert 및 Upsert입니다. 드롭다운 목록에서 동작을 선택할 수 있습니다.
Upsert을 선택하는 경우.
외부 ID 필드: Upsert 작업의 외부 ID 필드 이름입니다. 지정된 필드는 Salesforce 개체에서 외부 ID 필드로 정의되어야 합니다. 해당하는 입력 데이터에서 NULL 값을 가질 수 없습니다.
null 값 무시: 쓰기 작업 중 입력 데이터에서 null 값을 무시할지 여부를 지정합니다.
- 선택될 경우, upsert 또는 업데이트 작업을 수행할 때 대상 개체의 데이터를 변경하지 않고 유지합니다. 삽입 작업을 수행할 때 정의된 기본 값을 삽입합니다.
- 선택되지 않을 경우, Upsert나 업데이트 작업을 수행할 때 대상 개체의 데이터를 NULL로 업데이트합니다. 삽입 작업을 수행할 때 NULL 값을 삽입합니다.
쓰기 일괄 처리 크기: 각 일괄 처리에서 Salesforce에 기록되는 데이터의 행 수를 지정합니다. 이 값을 10,000에서 200,000으로 설정하는 것이 좋습니다. 각 일괄 처리에 행이 너무 적어 복사 성능이 저하됩니다. 각 일괄 처리에 행이 너무 많으면 API 시간 제한이 발생할 수 있습니다.
최대 동시 연결: 작업 실행 중 데이터 저장소에 설정된 동시 연결의 상한입니다. 동시 연결을 제한하려는 경우에만 값을 지정합니다.
매핑
매핑 탭 구성의 경우 매핑 탭에서 매핑 구성을 참조하세요.
설정
설정 탭을 구성하려면 설정 탭에서 기타 설정 구성으로 이동합니다.
표 요약
다음 표에는 Salesforce의 복사 활동에 대한 자세한 정보가 포함되어 있습니다.
원본 정보
이름 | 설명 | 값 | 필수 | JSON 스크립트 속성 |
---|---|---|---|---|
Connection | 원본 데이터 저장소에 대한 연결입니다. | <Salesforce 연결> | 예 | connection |
연결 형식 | 연결 형식입니다. Salesforce 개체를 선택합니다. | SalesforceObject | 예 | / |
쿼리 사용 | Salesforce에서 데이터를 읽는 방법입니다. | • 개체 API • 보고서 • SOQL 쿼리 |
예 | / |
개체 API의 경우 | ||||
API 개체 | 데이터를 검색할 Salesforce 개체 이름을 지정합니다. | < 개체 이름 > | 예 | objectApiName |
보고서의 경우 | ||||
보고서 ID | 데이터를 검색할 Salesforce 보고서의 ID입니다. 대상에서는 지원되지 않습니다. 보고서를 사용할 때는 제한 사항이 있습니다. | <보고서 ID> | 예 | reportId |
SOQL 쿼리의 경우 | ||||
SOQL 쿼리 | 사용자 지정 쿼리를 사용하여 데이터를 읽습니다. SOQL(Salesforce 개체 쿼리 언어) 쿼리는 제한 사항이 있는 경우에만 사용할 수 있습니다. 대량 API 2.0 쿼리 이해하기. SOQL 쿼리를 지정하지 않으면 개체 API 또는 보고서 ID에 지정된 Salesforce 개체의 모든 데이터가 검색됩니다. | < SOQL 쿼리 > | 예 | query |
삭제된 개체 포함 | 기존 레코드를 쿼리할지, 아니면 삭제된 항목을 포함하여 모든 레코드를 쿼리할지 여부를 나타냅니다. | 선택되거나 선택되지 않음(기본값) | 아니요 | includeDeletedObjects: true 또는 false(기본값) |
추가 열 | 데이터 열을 추가하여 원본 파일의 상대 경로 또는 정적 값을 저장하세요. 식은 정적 값에 대해 지원됩니다. | • 이름 • 값 |
아니요 | additionalColumns: • 이름 • 값 |
대상 정보
이름 | 설명 | 값 | 필수 | JSON 스크립트 속성 |
---|---|---|---|---|
Connection | 대상 데이터 저장소에 대한 연결입니다. | <Salesforce 연결> | 예 | connection |
API 개체 | 데이터를 쓸 Salesforce 개체 이름을 지정합니다. | < 개체 이름 > | 예 | objectApiName |
쓰기 동작 | 작업의 쓰기 동작입니다. 허용되는 값은 Insert 및 Upsert입니다. 드롭다운 목록에서 동작을 선택할 수 있습니다. | • 삽입 • Upsert |
아니요(기본값: 삽입) | writeBehavior: 삽입 upsert |
외부 ID 필드 | Upsert 작업의 외부 ID 필드 이름입니다. 지정된 필드는 Salesforce 개체에서 외부 ID 필드로 정의되어야 합니다. 해당하는 입력 데이터에서 NULL 값을 가질 수 없습니다. | < 외부 ID 필드 > | "Upsert"에서 예 | externalIdFieldName |
null 값 무시 | 쓰기 작업 중에 입력 데이터에서 NULL 값을 무시할지 여부를 나타냅니다. | 선택되거나 선택되지 않음(기본값) | 아니요 | ignoreNullValues: true 또는 false(기본값) |
쓰기 일괄 처리 크기 | 각 일괄 처리에서 Salesforce에 작성된 데이터의 행 수입니다. 이 값을 10,000에서 200,000으로 설정하는 것이 좋습니다. 각 일괄 처리에 행이 너무 적어 복사 성능이 저하됩니다. 각 일괄 처리에 행이 너무 많으면 API 시간 제한이 발생할 수 있습니다. | <행 개수> (정수) |
아니요(기본값: 100,000) | writeBatchSize |
최대 동시 연결 수 | 작업 실행 중 데이터 저장소에 설정된 동시 연결의 상한입니다. 동시 연결을 제한하려는 경우에만 값을 지정합니다. | <최대 동시 연결 수> | 아니요 | maxConcurrentConnections |
Salesforce Bulk API 2.0 제한
Salesforce Bulk API 2.0을 사용하여 데이터를 쿼리하고 수집합니다. Bulk API 2.0에서는 일괄 처리가 자동으로 만들어집니다. 24시간 동안 최대 15,000개의 일괄 처리를 제출할 수 있습니다. 일괄 처리가 제한을 초과하면 오류가 발생합니다.
Bulk API 2.0에서는 수집 작업만 일괄 처리를 사용합니다. 쿼리 작업은 그렇지 않습니다. 자세한 내용은 Bulk API 2.0 개발자 가이드에서 요청 처리 방법을 참조하세요.
자세한 내용은 Salesforce 개발자 제한 사항의 일반 제한 사항 섹션을 참조하세요.