Salesforce オブジェクト接続を設定する

この記事では、Salesforce オブジェクト接続を作成する手順について説明します。

サポートされている認証の種類

Salesforce オブジェクト コネクタでは、コピーとデータフロー Gen2 のそれぞれについて、次の認証タイプがサポートされています。

認証の種類 コピー データフロー Gen2
組織アカウント

Dataflow Gen2 の接続を設定する

Power Query コネクタを使用して、Microsoft Fabric の Dataflow Gen2 を Salesforce オブジェクトに接続できます。 接続を作成するには、次の手順に従います。

  1. 機能、制限事項、および考慮事項を確認して、シナリオがサポートされていることを確認します。
  2. Salesforce オブジェクトの前提条件を満たす
  3. Fabric でデータを取得します
  4. Salesforce オブジェクトに接続します

能力

  • 生産
  • カスタム
    • カスタム ドメイン
    • CNAME レコードのリダイレクト
    • リレーションシップ列

前提条件

Salesforce Objects コネクタを使用するには、Salesforce アカウントのユーザー名とパスワードが必要です。

また、Salesforce API アクセスを有効にする必要があります。 アクセス設定を確認するには、個人用 Salesforce ページに移動し、プロファイル設定を開き、[ API の有効化] チェックボックスがオンになっていることを確認します。 Salesforce 試用版アカウントには API アクセスできないことに注意してください。

データを取得する

Data Factory でデータを取得するには:

  1. Data Factory の左側で [ワークスペース]を選択します。

  2. データファクトリーのワークスペースで 新しい>データフローGen2 を選択して、新しいデータフローを作成します。

    新しいデータフローを作成することを選択したワークスペースを示すスクリーンショット。

  3. Power Query では、リボンの [データ の取得] を選択するか、現在のビューで別のソース からデータを取得 を選択します。

    [データの取得] オプションが強調された Power Query ワークスペースを示すスクリーンショット。

  4. [データ ソース 選択] ページで、検索 を使用してコネクタの名前を検索するか、[コネクタの右側にある [さらに を表示] を選択して、Power BI サービスで使用可能なすべてのコネクタの一覧を表示します。

    検索ボックスとビューの選択が強調された [Data Factory のデータ ソースの選択] ページのスクリーンショット。

  5. その他のコネクタを表示する場合でも、検索 を使用してコネクタの名前を検索することも、カテゴリを選択してそのカテゴリに関連付けられているコネクタの一覧を表示することもできます。

    コネクタの一覧と共に、[さらに表示] を選択した後に表示される [Data Factory のデータ ソースの選択] ページのスクリーンショット。

Salesforce オブジェクトへの接続

Salesforce Objects データに接続するには:

  1. 製品固有のデータ コネクタの一覧から Salesforce オブジェクト を選択し、[ 接続] を選択します。 詳細については、「 データを取得する場所」を参照してください。

  2. Salesforce オブジェクトで、接続に使用する URL を選択します。 Salesforce 運用 URL (https://www.salesforce.com) を使用してサインインする場合は、運用 URL を選択します。

    Salesforce Objects の接続情報を追加する [データ ソースへの接続] ウィンドウのスクリーンショット。

    現時点では、 カスタム URL を選択し、テキスト ボックスに「 https://www.salesforce.com 」と入力し、[ 運用 ] を選択してデータに接続することが必要な場合があります。

    [ カスタム ] を選択し、サインインするカスタム URL を入力することもできます。 このカスタム URL は、 https://contoso.salesforce.comなど、Salesforce 内で作成したカスタム ドメインである可能性があります。 Salesforce にリダイレクトする独自の CNAME レコードを使用している場合は、カスタム URL の選択を使用することもできます。

    また、[ リレーションシップ列を含める] を選択することもできます。 この選択により、他のテーブルとの外部キー リレーションシップを持つ可能性がある列を含めることで、クエリが変更されます。 このボックスがオフの場合、これらの列は表示されません。

  3. この接続を初めて行う場合は、必要に応じてオンプレミスのデータ ゲートウェイを選択します。

  4. [ サインイン ] を選択して Salesforce アカウントにサインインします。 正常にサインインしたら、[ 次へ] を選択します。

  5. [ ナビゲーター ]ダイアログで、読み込む Salesforce オブジェクトを選択します。 次に、[ データの変換 ] を選択してデータを変換します。

制限事項と考慮事項

  • Salesforce Objects コネクタの結果にテーブルがない場合、原因の 1 つとして、ApiVersion を指定するか、Salesforce がサポートするバージョンに更新する必要がある可能性があります。 ApiVersion を指定または更新するには、詳細エディターを使用し、 ApiVersion パラメーターを明示的に追加します。 例えば次が挙げられます。

    Source = Salesforce.Data("https://login.salesforce.com/", [ApiVersion = 54.0])

    Salesforce では ApiVersions が定期的に非推奨になるため、 Salesforce でサポートされている ApiVersion を指定していることを確認してください。

  • Salesforce に対してクエリに含めることができるフィールドの数には制限があります。 制限は、列の種類、計算列の数などによって異なります。 Query is either selecting too many fields or the filter conditions are too complicated エラーが発生した場合は、クエリが制限を超っていることを意味します。 このエラーを回避するには、[クエリの詳細設定の 選択 ] オプションを使用し、実際に必要なフィールドを指定します。

  • Salesforce セッション設定によって、この統合がブロックされる可能性があります。 [ セッションを元の IP アドレスにロックする ] 設定が無効になっていることを確認します。

  • Salesforce API アクセスを有効にする必要があります。 アクセス設定を確認するには、現在のユーザーのプロファイル設定に移動し、[ API の有効化] チェックボックスを検索します。

  • Salesforce 試用版アカウントには API アクセス権がありません。

  • "レコードの作成" 操作と "レコードの更新" 操作では、 Picklist (Multi-Select)型のユーザー設定フィールドはサポートされていません。

  • Lightning URL はサポートされていません。

  • カスタム URL では、salesforce.com ドメインと cloudforce.com ドメインのみがサポートされます。 他のドメインを使用すると、"無効な引数" エラーが発生します。

  • Salesforce では、1 つのアカウントで実行できる同時実行クエリの数が制限されます。 'INVALID_QUERY_LOCATOR' エラー これは Salesforce の制限であり、同じアカウントを使用する Salesforce に対して複数の同時クエリがある場合に発生する可能性があります。 この制限には、Salesforce API を使用するすべてのクライアント アプリケーション (PowerQuery コネクタだけでなく) が含まれます。 このエラーの可能性を減らすには、次の手順を実行します。

    • Salesforce クエリの数が最小限に抑えられていることを確認します。
    • 使用可能なオプション (データフローなど) を使用して、Salesforce のデータをステージングします。
    • 同じアカウントで Salesforce API の他の使用が同時にスケジュールされていないことを確認します。

Salesforce 内部 API の制限の詳細については、「 Salesforce 開発者の制限と割り当てのクイック リファレンス」を参照してください