Salesforce 전송 소개

Salesforce용 BigQuery Data Transfer Service 커넥터를 사용하여 Salesforce Sales Cloud에서 BigQuery로 데이터를 로드할 수 있습니다. BigQuery Data Transfer Service를 사용하면 Salesforce Sales Cloud의 최신 데이터를 BigQuery에 추가하는 반복 전송 작업을 예약할 수 있습니다.

Salesforce 전송을 예약하는 방법을 알아보려면 BigQuery에 Salesforce 데이터 로드를 참고하세요.

데이터 수집 옵션

다음 섹션에서는 Salesforce 데이터 전송을 설정할 때의 데이터 수집 옵션에 대해 자세히 설명합니다.

전체 또는 증분 전송

Salesforce 전송을 설정할 때 전송 구성에서 전체 또는 증분 쓰기 환경설정을 선택하여 데이터가 BigQuery에 로드되는 방법을 지정할 수 있습니다.

전체 데이터 전송을 구성하여 각 데이터 전송 시 Salesforce 데이터 세트의 모든 데이터를 전송할 수 있습니다.

또는 각 데이터 전송 시 전체 데이터 세트를 로드하는 대신 증분 데이터 전송을 구성하여 마지막 데이터 전송 이후 변경된 데이터만 전송할 수 있습니다. 데이터 전송에 증분을 선택한 경우 증분 데이터 전송 중에 BigQuery에 데이터를 쓰는 방법을 정의하려면 추가 또는 삽입/업데이트(upsert) 쓰기 모드를 지정해야 합니다. 다음 섹션에서는 사용 가능한 쓰기 모드를 설명합니다.

추가 쓰기 모드

추가 쓰기 모드는 대상 테이블에 새 행만 삽입합니다. 이 옵션은 기존 레코드를 확인하지 않고 전송된 데이터를 엄격하게 추가하므로 이 모드는 대상 테이블에서 데이터 중복을 유발할 수 있습니다.

추가 모드를 선택하는 경우 워터마크 열을 선택해야 합니다. Salesforce 커넥터가 소스 테이블의 변경사항을 추적하려면 워터마크 열이 필요합니다.

레코드가 생성될 때만 업데이트되고 이후 업데이트에서는 변경되지 않는 워터마크 열을 선택합니다. 예를 들어 CreatedDate 열을 사용할 수 있습니다.

업서트 쓰기 모드

upsert 쓰기 모드는 기본 키를 확인하여 대상 테이블의 행을 업데이트하거나 새 행을 삽입합니다. 기본 키를 지정하여 Salesforce 커넥터가 소스 테이블에 맞춰 대상 테이블을 최신 상태로 유지하는 데 필요한 변경사항을 결정하도록 할 수 있습니다. 데이터 전송 중에 지정된 기본 키가 대상 BigQuery 테이블에 있으면 Salesforce 커넥터가 소스 테이블의 새 데이터로 해당 행을 업데이트합니다. 데이터 전송 중에 기본 키가 없으면 Salesforce 커넥터가 새 행을 삽입합니다.

삽입/업데이트 모드를 선택할 때는 워터마크 열과 기본 키를 선택해야 합니다.

  • Salesforce 커넥터가 소스 테이블의 변경사항을 추적하려면 워터마크 열이 필요합니다.

    행이 수정될 때마다 업데이트되는 워터마크 열을 선택합니다. SystemModstamp 또는 LastModifiedDate 열을 사용하는 것이 좋습니다.

  • 기본 키는 Salesforce 커넥터가 행을 삽입해야 하는지 업데이트해야 하는지 확인하는 데 필요한 테이블의 하나 이상의 열일 수 있습니다.

    테이블의 모든 행에서 고유한 null이 아닌 값이 포함된 열을 선택합니다. 시스템 생성 식별자, 고유 참조 코드 (예: 자동 증분 ID) 또는 불변 시간 기반 시퀀스 ID가 포함된 열을 사용하는 것이 좋습니다.

    데이터 손실이나 데이터 손상을 방지하려면 선택한 기본 키 열에 고유한 값이 있어야 합니다. 선택한 기본 키 열의 고유성에 의문이 있는 경우 추가 쓰기 모드를 대신 사용하는 것이 좋습니다.

증분 수집 동작

데이터 소스의 테이블 스키마를 변경하면 해당 테이블의 증분 데이터 전송이 다음과 같은 방식으로 BigQuery에 반영됩니다.

데이터 소스 변경사항 증분 수집 동작
새 열 추가 대상 BigQuery 테이블에 새 열이 추가됩니다. 이 열의 이전 레코드에는 null 값이 있습니다.
열 삭제 삭제된 열은 대상 BigQuery 테이블에 남아 있습니다. 이 삭제된 열의 새 항목은 null 값으로 채워집니다.
열의 데이터 유형 변경 커넥터는 ALTER COLUMN DDL 문에서 지원되는 데이터 유형 변환만 지원합니다. 다른 데이터 유형 변환은 데이터 전송을 실패하게 합니다.

문제가 발생하면 새 전송 구성을 만드는 것이 좋습니다.
열 이름 변경 원래 열은 대상 BigQuery 테이블에 그대로 유지되고 업데이트된 이름의 새 열이 대상 테이블에 추가됩니다.

데이터 유형 매핑

다음 표는 Salesforce 데이터 유형을 해당하는 BigQuery 데이터 유형에 매핑합니다.

Salesforce 데이터 유형 BigQuery 데이터 유형
_bool BOOLEAN
_int INTEGER
_long INTEGER
_double FLOAT
currency FLOAT
percent FLOAT
geolocation (latitude) FLOAT
geolocation (longitude) FLOAT
date DATE
datetime TIMESTAMP
time TIME
picklist STRING
multipicklist STRING
combobox STRING
reference STRING
base64 STRING
textarea STRING
phone STRING
id STRING
url STRING
email STRING
encryptedstring STRING
datacategorygroupreference STRING
location STRING
address STRING
anyType STRING

가격 책정

Salesforce 전송 가격 정보는 Data Transfer Service 가격 책정을 참고하세요.

다음 단계