#目的

Salesforce コネクタは、Salesforce オルグからデータを抽出します: 標準およびカスタム sObjects (Account、Contact、Opportunity、Lead、Case、カスタム *__c オブジェクト)、SOQL クエリ、SOSL 検索、sObject メタデータ、オルグ API 制限、およびレポート一覧。

7 種類のエンドポイント で、分析に最も役立つ Salesforce REST API サーフェスをカバーしています。

コネクタは、Salesforce API から 生の JSON を返します。 OVHcloud Data Platform は、入れ子になったオブジェクトを列に平坦化し、結果をレイクハウスに保存します。 手動でスキーマを定義する必要はありません。

#1. API アクセス用の External Client App を作成する

コネクタは OAuth 2.0 クライアント資格情報フロー で認証されます。これは、Salesforce オルグに構成された External Client App (またはレガシーコネクテッドアプリ) が必要です。

#ステップ

1. Salesforce で Setup (歯車アイコン、右上) を開きます。
2. クイック検索ボックスで App Manager を検索します。
3. New External Client App (右上) をクリックします。 レガシーのオルグで "New Connected App" しか表示されない場合は、その場合でも問題ありません。 Connected App を選択し、OAuth 設定で "Client Credentials Flow" を有効にします。
4. 次を入力します:
   • App name: 任意の説明的な名前 (例: DPE Data Platform)
   • Contact email: メールアドレス
5. OAuth セクションで:
   • ☑️ Enable OAuth
   • Callback URL: https://login.salesforce.com/services/oauth2/success (Client Credentials 用には未使用ですが、必要です)
   • OAuth scopes: 少なくとも Manage user data via APIs (api) を追加します
6. アプリを Save します。
7. 新しく作成したアプリを開く → Policies タブ → Edit をクリックします。
8. Client Credentials Flow を有効にし、Run As ユーザーを選択します (通常は Developer オルグの管理者ユーザー)。
9. Save をクリックします。

#資格情報を取得する

1. アプリページに戻り、Settings タブ → OAuth Settings を開きます。
2. Consumer Key and Secret をクリックします。 Salesforce はメール確認を求めます。
3. Consumer Key (あなたの client_id) と Consumer Secret (あなたの client_secret) をコピーします。

#インスタンス URL を見つける

• Salesforce の右上プロファイルメニューに、My Domain URL が表示されます。
• または: Setup → Quick Find → My Domain → "Current My Domain URL" の下の値。

形式: https://<something>.my.salesforce.com (例: Developer Edition の場合は https://orgfarm-XXXXXX-dev-ed.develop.my.salesforce.com)。

#2. プラットフォーム上でコネクタを構成する

OVHcloud Data Platform UI で、新しい Salesforce ソースに接続し、次の内容を入力します:

保存: コネクタは、これらをアクセストークンと交換するように自動的に設定します。 各実行時にトークンは保存されません。 データを抽出するたびに交換が行われます。

#3. 利用可能なエンドポイント

抽出したい各エンドポイントタイプごとに 1 つのテーブルを追加できます。 同じエンドポイントタイプを複数回追加できます (例: 1 つの sobject_recordsごとに sObject)。

#データ抽出

#メタデータ

#4. クイック例: アカウントを抽出する

1. エンドポイントタイプ: sobject_records
2. sObject 名: Account
3. フィールドフィルタ (オプション): Id, Name, Industry, AnnualRevenue, CreatedDate
4. 最大アイテム数: 100 (または空白のままにしてすべてを抽出します)

コネクタは、Salesforce から生の JSON を返します。 プラットフォームは、入れ子になったフィールドを平坦化します (Salesforce の応答には、attributes オブジェクトが含まれており、type と url があり、これは attributes.type / attributes.url 列になります) そして、結果をレイクハウスに読み込みます。

#5. ベストプラクティス

#大きな sObject に fields_filter を使用する

fields_filter が空の場合、コネクタは sObject をイントラスペクトし、すべてのクエリ可能なフィールドを選択します。 一部の標準 sObject には 50–100+ のフィールドがあり、抽出が遅くなり、結果のテーブルが非常に広くなります。 分析には、実際に必要な 5–20 のフィールドをリストします。

#where_clause を使用して増分抽出を行う

LastModifiedDate > LAST_N_DAYS:1 のようなフィルタを追加して、最近変更されたレコードのみを取得します。 Salesforce SOQL 日付リテラルのような LAST_N_DAYS:N, TODAY, YESTERDAY, THIS_WEEK は、特に便利です。

フィルタを入力する際に、先頭の WHERE キーワードを付けるか付けないかは任意です。 どちらも動作します。

#可能な場合は sobject_records を soql_query より優先する

sobject_records はシンプルです (フィールド + オプションの WHERE を入力) そして、内部的には同じように動作します。 soql_query は、次の場合に予約します:

• サブクエリ (例: SELECT Id, (SELECT Id FROM Contacts) FROM Account)
• 集計 (SELECT COUNT(Id) FROM Case GROUP BY Status)
• クロスオブジェクト結合

#sobjects_list を使用して利用可能な sObject を発見する

sobjects_list を一度実行します: これは、オルグ内のすべての sObject のフルカタログを返し、__c で終わるすべてのカスタムオブジェクトを含みます。 これを使用して、sobject_name に入力する正確な API 名を確定します。

#新しいテーブルを設定する際は max_items を低く設定する

新しいテーブルを設定する際に max_items: 10 を使用し、出力が正しく見えるようになったら、値を上げたりクリアしたりします。

#6. 制限事項

• 読み取り専用です。 コネクタはレコードを作成、更新、または削除しません。 抽出のみを行います。
• REST API v60.0: 文書化されたすべての sObjects とクエリをカバーするには十分に最新です。 新しい Salesforce Spring '26 の機能は、一般的な REST エンドポイントを介してアクセス可能ですが、専用のコネクタエンドポイントを介して公開されることはありません。
• Bulk API 2.0 はサポートされていません: 単一クエリ抽出が数百万行を超える場合、Bulk の方が効率的です。 このバージョンではサポートされていません。
• ストリーミング / プラットフォームイベント / Pub/Sub はありません: これはバッチ抽出コネクタであり、リアルタイムイベントリスナーではありません。
• レポートは一覧表示されますが、実行されません。 reports_list エンドポイントは、レポートのカタログを返し、その結果を返すわけではありません。 レポートデータを取得するには、soql_query を介して同等の SOQL クエリを複製します。
• オルグレベルの API クォータが適用されます。 Salesforce は、オルグごとに 1 日あたりの API リクエスト制限を強制します (エディションごとに異なります)。 抽出は、その制限にカウントされます。 現在の使用量については、limits エンドポイントを参照してください。
• エラーはサイレントに処理されません。 クエリに SOQL 構文エラーがある場合、Run As ユーザーが見ることができないフィールドを参照している場合、または権限の問題に遭遇した場合、抽出は Salesforce エラーメッセージとともに失敗します。

#さらに詳しく

当社のソリューションのトレーニングや技術的なサポートが必要な場合は、営業担当者にお問い合わせください。または、当社の専門家がプロジェクトを分析するために見積もりを依頼するには、Professional Services ページをご覧ください。

Data Platform の開発チームと直接やり取りし、質問をしたり、フィードバックを送信したりするには、専用の Discord チャネル をご利用ください。

OVHcloud サービスについてサポートが必要な場合は、Help Centre でリクエストを作成してください。

ユーザーコミュニティ に参加してください。