Salesforce データを BigQuery に読み込む

Salesforce Classic

myDomain の詳細を取得する

myDomain を確認する手順は次のとおりです。

1. Salesforce プラットフォームにログインします。
2. [Setup] をクリックします。
3. 検索バーで「My Domain」を検索します。
4. 検索結果で、[Domain Management] > [My Domain] をクリックします。

[My Domain Details] セクションの [Current My Domain URL] に、myDomain がプレフィックスとして表示されます。たとえば、マイドメインの URL が example.my.salesforce.com の場合、使用する myDomain の値は example です。

ClientId と ClientSecret の詳細を取得する

ClientId と ClientSecret の値を確認する手順は次のとおりです。

1. Salesforce プラットフォームにログインします。
2. [Setup] をクリックします。
3. 検索バーで「Apps」を検索します。
4. 検索結果の [Build] セクションで、[Create] > [Apps] をクリックします。
5. [Connected App Name] をクリックします。
6. [Connected Apps] の詳細ページで、[Manage Consumer Details] をクリックします。
7. 登録済みのいずれかの方法で本人確認を行います。本人確認を再度行うよう求められるまで、最大 5 分間、お客様の詳細ページを表示できます。
8. [Consumer Details] ページの [Consumer Key] が ClientId の値です。[Customer Secret] は ClientSecret の値です。

Salesforce Lightning Experience

myDomain の詳細を取得する

myDomain を確認する手順は次のとおりです。

1. Salesforce プラットフォームにログインします。
2. [Setup] をクリックします。

1. 検索バーで「My Domain」を検索します。
2. 検索結果で、[Company Settings] > [My Domain] をクリックします。

[My Domain Details] セクションの [Current My Domain URL] に、myDomain がプレフィックスとして表示されます。たとえば、マイドメインの URL が example.my.salesforce.com の場合、使用する myDomain の値は example です。

ClientId と ClientSecret の詳細を取得する

1. Salesforce プラットフォームにログインします。
2. [Setup] をクリックします。
3. 検索バーで「Apps」を検索します。
4. 検索結果で [Apps] > [App Manager] をクリックします。
5. 接続済みのアプリを見つけて、[View] をクリックします。
6. [Manage Consumer Details] をクリックします。
7. 登録済みのいずれかの方法で本人確認を行います。本人確認を再度行うよう求められるまで、最大 5 分間、お客様の詳細ページを表示できます。
8. [Consumer Details] ページの [Consumer Key] が ClientId の値です。[Customer Secret] は ClientSecret の値です。

コンソール

1. Trusted Cloud コンソールの [データ転送] ページに移動します。

   [データ転送] に移動

2. [add転送を作成] をクリックします。

3. [ソースタイプ] セクションの [ソース] で、[Salesforce] を選択します。

4. [データソースの詳細] セクションで、次のようにします。

   • [My Domain] に Salesforce の My Domain を入力します。
   • [クライアント ID] に、Salesforce 接続アプリケーションのコンシューマ キーを入力します。
   • [クライアント シークレット] に、Salesforce 接続アプリケーションのコンシューマ シークレットを入力します。

   • [Salesforce objects to transfer] で、[参照] をクリックして、BigQuery 宛先データセットに転送するオブジェクトを選択します。このフィールドには、データ転送に含めるオブジェクトを手動で入力することもできます。

     

5. [転送先の設定] セクションの [データセット] で、データを保存するために作成したデータセットを選択します。

6. [転送構成名] セクションの [表示名] に、データ転送の名前を入力します。

7. [スケジュール オプション] セクションで:

   • [繰り返しの頻度] リストで、この転送の実行頻度を指定するオプションを選択します。カスタムの繰り返しの頻度を指定するには、[カスタム] を選択します。[オンデマンド] を選択した場合、手動で転送をトリガーすると、この転送が実行されます。
   • 必要に応じて、[すぐに開始] を選択するか、[設定した時刻に開始] を選択して開始日と実行時間を指定します。

8. 省略可: [通知オプション] セクションで、次のようにします。

   • メール通知を有効にするには、[メール通知] をクリックします。このオプションを有効にすると、転送の実行が失敗した場合、転送管理者にメール通知が送信されます。
   • この転送の Pub/Sub 転送実行通知を有効にするには、[Pub/Sub 通知] をクリックします。トピック名を選択するか、[トピックを作成する] をクリックしてトピックを作成します。

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（省略可）: Trusted Cloud by S3NS プロジェクト 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 My Domain。たとえば、ドメインの URL が 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 リソースのインスタンスを指定します。