オンプレミス データ ゲートウェイでカスタム データ コネクタを使用する

  • [アーティクル]

注意

オンプレミス データ ゲートウェイのドキュメントが、Power BI に固有のコンテンツと、ゲートウェイでサポートされるすべてのサービスに適用される一般的なコンテンツに分割されています。 現在見ているのは、Power BI のコンテンツです。 この記事について、またはゲートウェイのドキュメントの全体的なエクスペリエンスに関してフィードバックを提供するには、記事の一番下までスクロールしてください。

Power BI データ コネクタを使用すると、アプリケーション、サービス、またはデータ ソースからデータに接続してアクセスすることができます。 カスタム データ コネクタを開発して、Power BI Desktop で使用することができます。

Power BI Desktop でカスタム データ コネクタを使用するレポートを作成すると、オンプレミス データ ゲートウェイを使用して Power BI サービスでこれらのレポートを更新することができます。

Power BI 用にカスタム データ コネクタを開発する方法の詳細については、GitHub で DataConnectors SDK に関するページを参照してください。 このサイトには、Power BI と Power Query の開始方法とサンプルについての情報が含まれています。

カスタム コネクタを有効にして使用する

カスタム コネクタの使用を有効にするには、オンプレミス データ ゲートウェイ アプリで [コネクタ] を選択します。 [カスタム データ コネクタ] の [フォルダーからカスタム データ コネクタを読み込む] で、ゲートウェイ サービスを実行しているユーザーがアクセスできるフォルダーを参照して選択します。 既定のユーザーは、NT SERVICE\PBIEgwService です。 ゲートウェイによってそのフォルダー内のカスタム コネクタ ファイルが自動的に読み込まれ、それらはデータ コネクタのリストに表示されます。

Screenshot that shows the Custom data connectors screen in the On-premises data gateway app.

Note

オンプレミス データ ゲートウェイ (個人用モード) をお使いの場合は、Power BI レポートを Power BI サービスにアップロードし、ゲートウェイを使用してそれを更新することができます。

オンプレミス データ ゲートウェイの場合は、カスタム コネクタのデータ ソースを作成する必要があります。 Power BI サービスのゲートウェイの [設定] ページで、このクラスターでのカスタム コネクタの使用を有効にするオプションを選択します。

Screenshot that shows enabling custom connectors on the on-premises gateway Settings page.

このオプションを有効にすると、カスタム コネクタが、このゲートウェイ クラスターに追加できる使用可能なデータ ソース接続として表示されます。 新しいカスタム コネクタを使用するデータ ソースを作成した後、Power BI サービスでそのカスタム コネクタを使用して、Power BI レポートを更新できます。

Screenshot that shows the Data Source list on the Settings page.

考慮事項と制限事項

  • 作成するフォルダーに、バック グラウンドのゲートウェイ サービスがアクセスできることを確認します。 通常、ユーザーの Windows フォルダー下のフォルダーやシステム フォルダーにはアクセスできません。 フォルダーにアクセスできない場合、オンプレミス データ ゲートウェイ アプリにメッセージが表示されます。 この制限は、オンプレミス データ ゲートウェイ (個人用モード) には適用されません。

  • オンプレミス データ ゲートウェイで使用するカスタム コネクタには、カスタム コネクタのコードで TestConnection セクションを実装する必要があります。 Power BI Desktop でカスタム コネクタを使用する場合、このセクションは必要ありません。 このため、Power BI Desktop で動作するコネクタを使用できますが、ゲートウェイでは使用できません。 TestConnection セクションの実装方法の詳細については、TestConnection に関するページを参照してください。

  • カスタム コネクタがネットワーク ドライブ上にある場合、オンプレミス データ ゲートウェイ アプリで完全修飾パスを含めてください。

  • DirectQuery モードで作業する場合に使用できるカスタム コネクタ データ ソースは 1 つだけです。 複数のカスタム コネクタ データ ソースは、DirectQuery で機能しません。

関連するコンテンツ

他にわからないことがある場合は、 Power BI コミュニティで質問してみてください。