#目的

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 (またはレガシーの Connected App) が必要です。

#ステップ

1. Salesforce で Setup (歯車アイコン、右上) を開きます。
2. Quick Find ボックスで App Manager を検索します。
3. New External Client App (右上) をクリックします。レガシーのオルグで "New Connected App" しか表示されない場合は、その場合でも問題ありません。Connected App を選択し、OAuth Settings で "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 (例: https://orgfarm-XXXXXX-dev-ed.develop.my.salesforce.com on a Developer Edition)。

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

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

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

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

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

#データ抽出

#メタデータ

#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. ベストプラクティス

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

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

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

フィルタを追加して、最近変更されたレコードのみを取得します。Salesforce の SOQL 日付リテラルである LastModifiedDate > LAST_N_DAYS:1、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 で利用可能な sObjects を発見する

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 エラーメッセージとともに失敗します。

#さらに詳しく

当社のソリューションを実装するためのトレーニングや技術的なアシスタンスが必要な場合は、営業担当者にお問い合わせください、またはこのリンクをクリックして見積もりを取得し、プロフェッショナルサービスの専門家にプロジェクトのカスタム分析を依頼してください。

専用Discordチャネルで、Data Platformを構築するチームと直接質問したり、フィードバックを送信したり、交流したりしてください。

OVHcloudサービスについてサポートが必要な場合は、ヘルプセンターでリクエストを作成してください。

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