將 Salesforce 資料載入 BigQuery

Salesforce Classic

擷取「myDomain」詳細資料

如要找出 myDomain，請按照下列步驟操作：

1. 登入 Salesforce 平台。
2. 點選 [設定]。
3. 在搜尋列中搜尋「我的網域」。
4. 在搜尋結果中，依序點選「網域管理」>「我的網域」。

在「我的網域詳細資料」部分中，myDomain 會顯示為「目前的我的網域 URL」的前置字元。舉例來說，如果「我的網域」網址為 example.my.salesforce.com，則要使用的 myDomain 值為 example。

擷取 ClientId 和 ClientSecret 詳細資料

如要找出 ClientId 和 ClientSecret 值，請按照下列步驟操作：

1. 登入 Salesforce 平台。
2. 點選 [設定]。
3. 在搜尋列中搜尋「應用程式」。
4. 在搜尋結果的「建構」部分，依序點選「建立」>「應用程式」。
5. 按一下「已連結的應用程式名稱」。
6. 在「連結的應用程式」詳細資料頁面，按一下「管理取用者詳細資料」。
7. 使用其中一種已註冊的方法驗證身分。系統最多會顯示消費者詳細資料頁面五分鐘，之後會再次提示您驗證身分。
8. 在「消費者詳細資料」頁面中，「消費者金鑰」就是你的 ClientId 值。「Customer Secret」是您的 ClientSecret 值。

Salesforce Lightning Experience

擷取「myDomain」詳細資料

如要找出 myDomain，請按照下列步驟操作：

1. 登入 Salesforce 平台。
2. 點選 [設定]。

1. 在搜尋列中搜尋「我的網域」。
2. 在搜尋結果中，依序點選「公司設定」「我的網域」。

在「我的網域詳細資料」部分中，myDomain 會顯示為「目前的我的網域 URL」的前置字元。舉例來說，如果「我的網域」網址為 example.my.salesforce.com，則要使用的 myDomain 值為 example。

擷取 ClientId 和 ClientSecret 詳細資料

1. 登入 Salesforce 平台。
2. 點選 [設定]。
3. 在搜尋列中搜尋「應用程式」。
4. 在搜尋結果中，依序點選「應用程式」「應用程式管理工具」。
5. 找出已連結的應用程式，然後按一下「查看」。
6. 按一下「管理取用者詳細資料」。
7. 使用其中一種已註冊的方法驗證身分。系統最多會顯示消費者詳細資料頁面五分鐘，之後會再次提示您驗證身分。
8. 在「消費者詳細資料」頁面中，「消費者金鑰」就是你的 ClientId 值。「Customer Secret」是您的 ClientSecret 值。

主控台

1. 前往 Google Cloud 控制台的「資料移轉」頁面。

   前往「資料移轉」

2. 按一下 add「建立移轉作業」。

3. 在「Source type」(來源類型) 部分，「Source」(來源) 請選取「Salesforce」。

4. 在「Data source details」(資料來源詳細資料) 部分執行下列操作：

   • 在「My Domain」(我的網域)，輸入您的 Salesforce My Domain。
   • 在「Client ID」(用戶端 ID)，輸入與 Salesforce 連結的應用程式用戶端金鑰。
   • 在「Client secret」(用戶端密鑰)，輸入與 Salesforce 連結的應用程式用戶端密鑰。

   • 在「Salesforce objects to transfer」(要移轉的 Salesforce 物件) 部分點選「Browse」(瀏覽)，選取要移轉至 BigQuery 目的地資料集的物件。您也可以在這個欄位手動輸入要移轉資料的物件。

     

5. 在「Destination settings」(目的地設定) 部分，「Dataset」(資料集) 請選取您為了儲存資料而建立的資料集。

6. 在「Transfer config name」(轉移設定名稱) 部分，「Display name」(顯示名稱) 請輸入資料移轉作業名稱。

7. 在「Schedule options」(排程選項) 專區：

   • 在「Repeat frequency」(重複執行頻率) 清單中，選取選項，指定這項資料移轉作業的執行頻率。如要指定自訂重複頻率，請選取「Custom」(自訂)。如果選取「On-demand」(隨選)，系統會在您手動觸發移轉作業時執行該作業。
   • 視情況選取「Start now」(立即開始) 或「Start at set time」(在所設時間開始執行)，並提供開始日期和執行時間。

8. 選用：在「Notification options」(通知選項) 專區，執行下列操作：

   • 如要啟用電子郵件通知，請點選「Email notification」(電子郵件通知) 切換按鈕。啟用這個選項之後，若移轉失敗，移轉作業管理員就會收到電子郵件通知。
   • 如要針對這項移轉作業啟用 Pub/Sub 移轉作業執行通知，請點選「Pub/Sub notifications」(Pub/Sub 通知) 切換按鈕。您可以選取主題名稱，也可以點選「Create a topic」(建立主題) 來建立主題。

9. 按一下「儲存」。

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 連結應用程式的消費者金鑰。
  • connector.authentication.oauth.clientSecret：Salesforce 連線應用程式的 OAuth 用戶端密鑰或消費者密鑰。
  • connector.authentication.oauth.myDomain：Salesforce 我的網域。 舉例來說，如果網域網址為 example.my.salesforce.com，則值為 example。
  • 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.authentication.oauth.myDomain":"MyDomainName",}'

API

請使用 projects.locations.transferConfigs.create 方法，並提供 TransferConfig 資源的執行個體。