Salesforce 전송 예약

콘솔

1. Google Cloud 콘솔에서 BigQuery 페이지로 이동합니다.

   BigQuery로 이동

2. 데이터 전송 > 전송 만들기를 클릭합니다.

3. 소스 유형 섹션의 소스에서 Salesforce를 선택합니다.

4. 전송 구성 이름 섹션의 표시 이름에 전송 이름을 입력합니다.

5. 일정 옵션 섹션에서 다음을 수행합니다.

   • 반복 빈도 목록에서 이 전송 실행 빈도를 지정하는 옵션을 선택합니다. 커스텀 반복 빈도를 지정하려면 커스텀을 선택합니다. 주문형을 선택하면 이 전송은 수동으로 전송을 트리거할 때 실행됩니다.

   • 해당하는 경우 지금 시작 또는 설정 시간에 시작을 선택하고 시작 날짜와 실행 시간을 제공합니다.

6. 대상 설정 섹션의 데이터 세트에서 데이터를 저장하기 위해 만든 데이터 세트를 선택합니다.

7. 데이터 소스 세부정보 섹션에서 다음을 수행합니다.

   • 커스텀 도메인에 해당하는 경우 커스텀 로그인 도메인을 입력합니다. Salesforce 로그인 URL이 login.salesforce.com 또는 test.salesforce.com이면 이 필드를 비워 둡니다.

   • Salesforce URL에 Salesforce 로그인 URL이 끝나는 서픽스를 선택합니다. my.salesforce.com 또는 sandbox.my.salesforce.com을 선택하면 이 값은 커스텀 도메인 필드에 제공한 커스텀 도메인에 서픽스를 추가합니다.

     예를 들어 커스텀 도메인 mydomain을 제공하고 my.salesforce.com을 선택한 경우 로그인 URL은 mydomain.my.salesforce.com입니다.

   • 사용자 이름에 Salesforce 계정의 사용자 이름을 입력합니다.

   • 비밀번호에 Salesforce 계정의 비밀번호를 입력합니다.

   • 보안 토큰에 Salesforce 계정의 보안 토큰을 입력합니다.

   • 클라이언트 ID에 Salesforce 연결 애플리케이션 고객 키를 입력합니다.

   • 클라이언트 보안 비밀번호에 Salesforce 연결 애플리케이션 고객 보안 비밀을 입력합니다.

   • 전송할 Salesforce 객체에서 찾아보기를 클릭하여 BigQuery 대상 데이터 세트로 전송할 객체를 선택합니다.

     • 이 필드에 전송에 포함할 객체를 수동으로 입력할 수도 있습니다.

     

8. 서비스 계정 목록에서 Google Cloud 프로젝트와 연결된 서비스 계정을 선택합니다. 선택한 서비스 계정에는 이 전송을 실행하는 데 필요한 역할이 있어야 합니다.

   제휴 ID로 로그인한 경우 서비스 계정이 전송을 만드는 데 필요합니다. Google 계정으로 로그인한 경우 전송에 사용되는 서비스 계정은 선택사항입니다.

   데이터 전송에서 서비스 계정을 사용하는 방법에 대한 자세한 내용은 서비스 계정 사용을 참조하세요.

9. 선택사항: 알림 옵션 섹션에서 다음을 수행합니다.

   • 이메일 알림을 사용 설정하려면 이메일 알림 전환 버튼을 클릭합니다. 이 옵션을 사용 설정하면 전송 실행이 실패할 때 전송 관리자에게 이메일 알림이 발송됩니다.
   • 이 전송에 Pub/Sub 전송 실행 알림을 사용 설정하려면 Pub/Sub 알림 전환 버튼을 클릭합니다. 주제 이름을 선택하거나 주제 만들기를 클릭하여 주제를 만들 수 있습니다.

10. 저장을 클릭합니다.

bq

bq mk 명령어를 입력하고 전송 생성 플래그 --transfer_config를 지정합니다.

bq mk \
    --transfer_config \
    --project_id=PROJECT_ID \
    --data_source=DATA_SOURCE \
    --display_name=NAME \
    --target_dataset=DATASET \
    --params='PARAMETERS'

각 항목의 의미는 다음과 같습니다.

• PROJECT_ID(선택사항): Google Cloud 프로젝트 ID입니다. 특정 프로젝트를 지정하는 --project_id가 입력되지 않으면 기본 프로젝트가 사용됩니다.
• DATA_SOURCE: 데이터 소스 — salesforce입니다.
• NAME: 전송 구성의 표시 이름입니다. 전송 이름은 나중에 수정해야 할 경우를 대비해 간편하게 전송을 식별할 수 있는 값이면 됩니다.
• DATASET. 전송 구성의 대상 데이터 세트입니다.

• PARAMETERS: JSON 형식으로 생성된 전송 구성의 매개변수입니다. 예를 들면 --params='{"param":"param_value"}'입니다. Salesforce 전송에 대한 매개변수는 다음과 같습니다.

  • connector.authentication.oauth.clientId: Salesforce 연결 애플리케이션의 ClientId 또는 고객 키입니다.
  • connector.authentication.oauth.clientSecret: Salesforce 연결 애플리케이션의 OAuth 클라이언트 보안 비밀번호 또는 고객 보안 비밀입니다.
  • connector.customDomainName(선택사항): Salesforce 커스텀 로그인 도메인(해당되는 경우)입니다. 기본 로그인 도메인 login.Salesforce.com을 사용하려면 비워 둡니다.
  • connector.authentication.username: Salesforce 계정의 사용자 이름입니다.
  • connector.authentication.password: Salesforce 계정의 비밀번호입니다.
  • connector.authentication.securityToken: Salesforce 계정의 보안 토큰입니다.
  • assets: BigQuery로 전송할 Salesforce 객체의 경로입니다.

예를 들어 다음 명령어는 필요한 모든 매개 변수를 사용하여 기본 프로젝트에 Salesforce 전송을 만듭니다.

bq mk \
    --transfer_config \
    --target_dataset=mydataset \
    --data_source=salesforce \
    --display_name='My Transfer' \
    --params='{"assets":["Account"],
        "connector.authentication.oauth.clientId": "1234567890",
        "connector.authentication.oauth.clientSecret":"ABC12345",
        "connector.customDomainName":"MyDomainName",
        "connector.authentication.username":"[email protected]",
        "Connector.authentication.password":"abcdef1234",
        "connector.authentication.securityToken":"a1hghbb44lnl465lbl75b",}'

API

projects.locations.transferConfigs.create 메서드를 사용하고 TransferConfig 리소스의 인스턴스를 지정합니다.