Power BI Report Builder でリアルタイムのHubDB のデータを Power BI Service に可視化

CData Power BI Connector は、Microsoft Power BI とのセルフサービス統合を提供します。CData Power BI Connector for HubDB を使用すると、Power BI レポートをリアルタイムのHubDB のデータにリンクできます。スケジュール更新やオンデマンド更新を設定することで、ダッシュボードを通じてHubDB のデータを監視し、分析がリアルタイムのHubDB のデータを反映するようにできます。この記事では、Power BI Connector を使用して Microsoft Power BI Desktop でリアルタイムのHubDB のデータを可視化する方法を詳しく説明します。

DSN の作成と設定

Power BI Connector をインストールすると、Power BI がデータソースに接続するために使用する CData PBI HubDB という名前の DSN（データソース名）が作成されます。必要な接続プロパティを入力して DSN を設定します。

Microsoft ODBC データソースアドミニストレーターを使用して、新しい DSN を作成するか、既存の DSN を設定（および名前変更）できます。スタートメニューから「ODBC データソース」と入力します。Power BI Desktop のインストールに対応するビット数（32 ビットまたは 64 ビット）の ODBC アドミニストレーターを実行してください。

HubDBデータソースへの接続には、パブリックHubSpotアプリケーションを使用したOAuth認証とプライベートアプリケーショントークンを使用した認証の2つの方法があります。

カスタムOAuthアプリを使用する

すべてのOAuthフローでAuthSchemeを"OAuth"に設定する必要があります。特定の認証ニーズ（デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン）に必要な接続プロパティについては、ヘルプドキュメントを確認してください。

アプリケーションを登録し、OAuthクライアント認証情報を取得するには、以下の手順を実行してください。

1. HubSpotアプリ開発者アカウントにログインします。
   • アプリ開発者アカウントである必要があります。標準のHubSpotアカウントではパブリックアプリを作成できません。
2. 開発者アカウントのホームページで、アプリタブをクリックします。
3. アプリを作成をクリックします。
4. アプリ情報タブで、ユーザーが接続する際に表示される値を入力し、必要に応じて変更します。これらの値には、パブリックアプリケーション名、アプリケーションロゴ、アプリケーションの説明が含まれます。
5. 認証タブで、「リダイレクトURL」ボックスにコールバックURLを入力します。
   • デスクトップアプリケーションを作成する場合は、http://localhost:33333のようなローカルにアクセス可能なURLに設定します。
   • Webアプリケーションを作成する場合は、ユーザーがアプリケーションを承認した際にリダイレクトされる信頼できるURLに設定します。
6. アプリを作成をクリックします。HubSpotがアプリケーションとそれに関連する認証情報を生成します。
7. 認証タブで、クライアントIDとクライアントシークレットを確認します。これらは後でドライバーを設定する際に使用します。

8. スコープの下で、アプリケーションの意図する機能に必要なスコープを選択します。

   テーブルにアクセスするには、最低限以下のスコープが必要です：

   • hubdb
   • oauth
   • crm.objects.owners.read
9. 変更を保存をクリックします。
10. 統合に必要な機能にアクセスできる本番ポータルにアプリケーションをインストールします。
    • 「インストールURL（OAuth）」の下で、完全なURLをコピーをクリックして、アプリケーションのインストールURLをコピーします。
    • コピーしたリンクをブラウザで開きます。アプリケーションをインストールする標準アカウントを選択します。
    • アプリを接続をクリックします。結果のタブは閉じて構いません。

プライベートアプリを使用する

HubSpotプライベートアプリケーショントークンを使用して接続するには、AuthSchemeプロパティを"PrivateApp"に設定します。

以下の手順に従ってプライベートアプリケーショントークンを生成できます：

1. HubDBアカウントで、メインナビゲーションバーの設定アイコン（歯車）をクリックします。
2. 左サイドバーメニューで、統合 > プライベートアプリに移動します。
3. プライベートアプリを作成をクリックします。
4. 基本情報タブで、アプリケーションの詳細（名前、ロゴ、説明）を設定します。
5. スコープタブで、プライベートアプリケーションがアクセスできるようにしたい各スコープに対して読み取りまたは書き込みを選択します。
6. テーブルにアクセスするには、最低限hubdbとcrm.objects.owners.readが必要です。
7. アプリケーションの設定が完了したら、右上のアプリを作成をクリックします。
8. アプリケーションのアクセストークンに関する情報を確認し、作成を続行をクリックし、その後トークンを表示をクリックします。
9. コピーをクリックして、プライベートアプリケーショントークンをコピーします。

接続するには、PrivateAppTokenを取得したプライベートアプリケーショントークンに設定します。

HubDB のデータの取得

データソースの設定が完了したら、以下の手順に従って HubDB テーブルからデータセットにデータを読み込みます。

読み込むテーブルとビューを選択

1. Power BI Report Builder を開き、Blank Report を選択します。
2. Data Sources -> Add Data Source をクリックします。
3. Connection Type で ODBC を選択し、「Build」をクリックします。
4. 「Use user or system data source name」をクリックし、CData PBI HubDB Sys を選択します。
5. Connection Properties で Test Connection をクリックし、接続が成功することを確認します。
6. Data Source Properties ウィンドウで Test Connection をクリックし、OK をクリックします。
7. データソースの設定が完了したら、DataSets を設定します。DataSets -> Add Dataset をクリックします。先ほど設定したデータソースを選択し、Query Designer をクリックします。
8. レポートを生成するテーブルの SQL コマンドを入力し、「Run」（!）をクリックします。テーブル名は DSN の CData Connection Manager の Metadata タブで確認できます。
9. 「Validate Query」をクリックします。ウィンドウの左側にカラム名が表示されます。これで、用途に応じて任意のレポートを生成できます。

データビジュアライゼーションの作成

HubDB のデータを Power BI Report Builder に読み込んだ後、Fields ペインからキャンバスにフィールドをドラッグして、レポートビューでデータビジュアライゼーションを作成できます。以下の手順に従ってチャートを作成します：

1. Insert -> Chart -> Insert Chart に移動し、Chart Type を選択して OK をクリックします。
2. Values、Category Groups、Series Groups を選択します。Filters ペインにフィールドをドラッグすることで、ページ、レポート、または単一のビジュアライゼーションにフィルターを適用できます。フィールド値でフィルターするには、Filters ペインに表示されている値の1つを選択します。

PowerBI.com でデータ更新を設定

Power BI Gateway を使用して自動データ更新を設定するには、以下の手順に従います。ゲートウェイにより、Power BI クラウドサービスがお使いのマシンの DSN に接続できるようになります。

ゲートウェイモードの選択

ゲートウェイをインストールする際に、ゲートウェイモードを選択する必要があります：

• Gateway (personal mode)：PowerBI.com への発行とレポートの更新のみが必要な場合は、パーソナルモードでゲートウェイを使用します。ゲートウェイは Windows ユーザーアカウントで実行されます。
• （推奨） Gateway (Standard mode - formerly Enterprise)：ゲートウェイを必要とする他の Azure サービスを使用している場合は、デフォルトゲートウェイを使用します。複数のユーザーがゲートウェイにアクセスする必要がある場合も、デフォルトゲートウェイが必要です。 デフォルトゲートウェイ経由で接続するには、システム DSN が必要です（システム DSN はシステム全体でアクセスできますが、ユーザー DSN は特定のユーザーアカウントに制限されます）。コネクタインストールの最後のステップで設定された CData Power BI Salesforce システム DSN を使用できます。

Gateway (Personal Mode) の設定

パーソナルモードでゲートウェイを介して発行するには、カスタムコネクタにアクセスできるインストール済みゲートウェイが必要です。

1. CData Power BI Connector インストーラーを実行します。まだダウンロードしていない場合は、Power BI Gateway (Personal Mode) をダウンロードしてください。
2. オンプレミスデータゲートウェイ（personal mode）オプションを選択します。
3. ゲートウェイにサインインします。
4. ゲートウェイ設定の Connectors セクションで、「custom data connectors」オプションを有効にします。カスタムデータコネクタの .pqx ファイルへの代替パスもここで指定できます。

   注意：CData Power BI Connector は .pqx ファイルをデフォルトフォルダにインストールします。パス："Your User Home\Documents\Power BI Desktop\Custom Connectors."

Gateway (Standard Mode) の設定

ゲートウェイを介して発行するには、カスタムコネクタにアクセスできるインストール済みゲートウェイと、PowerBI.com から Salesforce 用 DSN への設定済み接続が必要です。

ゲートウェイのセットアップ

以下の手順に従って、お使いのマシンでゲートウェイを設定します：

1. CData Power BI Connector インストーラーを実行します。まだダウンロードしていない場合は、Power BI Gateway (Standard Mode) をダウンロードしてください。
2. オンプレミスデータゲートウェイ（推奨）オプションを選択します。
3. ゲートウェイにサインインします。
4. ゲートウェイに名前を付け、回復キーを指定します。
5. Connectors セクションで、ゲートウェイが CData Power BI Connector を検索するフォルダを選択します。この記事では "C:\Users\PBIEgwService\Documents\Power BI Desktop\Custom Connectors\" を使用します。または、CData Connector の .pqx ファイル（"C:\Users\USERNAME\Documents\Power BI Desktop\Custom Connectors\" にあります）を設定したフォルダにコピーします。

   注意：サービス用に設定されたアカウント（NT SERVICE\PBIEgwService）が、ゲートウェイ用に選択したフォルダにアクセスできる必要があります。必要に応じて、ゲートウェイインストーラーの Service Settings セクションでサービスアカウントを変更できます。

6. Connectors セクションのリストに CData.HubDB エントリが表示されていることを確認します。

PowerBI.com から Salesforce データに接続

1. ゲートウェイにデータソースを追加します：PowerBI.com にログインし、Settings メニューから Manage Gateways を選択してゲートウェイを選択します。
2. 「Allow user's custom data connectors to refresh through this gateway cluster」を選択します。
3. Apply をクリックして変更を保存します。
4. ゲートウェイにデータソースを追加するオプションをクリックします。
5. Data Source Settings セクションで、データソースの名前を入力します。Data Source Type メニューで CData Power BI Connector for HubDB を選択します。
6. Data Source Name ボックスにシステム DSN を入力します：CData PBI HubDB Sys。

PowerBI.com に発行

更新可能なレポートと基になるデータセットを発行できるようになりました。以下の手順に従って発行し、データセットのデータ更新設定を完了します。

1. Power BI Desktop Report Builder で、Home リボンの「Publish」をクリックしてレポートを発行します。
2. PowerBI.com で、レポートがアップロードされるワークスペースを選択し、ファイル名を入力します。
3. 「Open HubDB in Power BI」をクリックして、ブラウザの Power BI Service でレポートを開きます。

発生したエラーと解決策

「Unable to render paginated report」のようなエラーメッセージが表示された場合は、以下の手順に従ってエラーを解決できます。

Power BI Service でデータソースを作成

1. 「Update data source credentials」をクリックします。
2. 「Continue」をクリックします。
3. Gateway Connection セクションで、ゲートウェイを使用するオプションを有効にし、ゲートウェイを選択します。データソースをゲートウェイに手動で追加する必要がある場合があります：
   1. Actions 列の下でゲートウェイを展開します。
   2. 「Manually add to gateway」リンクをクリックします。
4. Add to gateway をクリックします（以下のスクリーンショットを参照）。匿名認証はサポートされていないため、Authentication で Basic を選択します。Power BI Service アカウントのユーザー名とパスワードを入力します。
5. データソースが正常に作成されたら、「Maps to」で Connection name を選択し、変更を適用します。
6. Power BI Report Builder に戻り、「Open HubDB in Power BI」をクリックします。これで、Power BI Service（Online）で作成したレポートを確認できます。

これで、Power BI Report Builder と CData Power BI Connector を使用して、リアルタイムのHubDB のデータ上に構築された Power BI レポートが完成しました。HubDB 用 CData Power BI Connector の詳細については、CData Power BI Connector for HubDB ページで無料トライアルをダウンロードしてご確認ください。ご質問がある場合は、サポートチームまでお問い合わせください。