こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
Power BI を使えば、データを美しいビジュアルに可視化したり、重要な情報を整理してダッシュボード化できます。CData Connect Server と組み合わせることで、可視化やダッシュボードなどのためにHubDB データを使用できます。この記事では、CData Connect Server を使用してHubDB の仮想データベースを作成し、HubDB データを使ったレポートをPower BI で作成する方法を説明します。
HubDB データの仮想データベースを作成する
CData Connect Server は、シンプルなポイントアンドクリックインターフェースを使用してデータソースに接続し、データを取得します。まずは、右側のサイドバーのリンクからConnect Server をインストールしてください。
- Connect Server にログインし、「CONNECTIONS」をクリックします。
- 一覧から「HubDB」を選択します。
-
HubDB に接続するために必要な認証プロパティを入力します。
HubDBデータソースへの接続には、パブリックHubSpotアプリケーションを使用したOAuth認証とプライベートアプリケーショントークンを使用した認証の2つの方法があります。
カスタムOAuthアプリを使用する
すべてのOAuthフローでAuthSchemeを"OAuth"に設定する必要があります。特定の認証ニーズ(デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン)に必要な接続プロパティについては、ヘルプドキュメントを確認してください。
アプリケーションを登録し、OAuthクライアント認証情報を取得するには、以下の手順を実行してください。
- HubSpotアプリ開発者アカウントにログインします。
- アプリ開発者アカウントである必要があります。標準のHubSpotアカウントではパブリックアプリを作成できません。
- 開発者アカウントのホームページで、アプリタブをクリックします。
- アプリを作成をクリックします。
- アプリ情報タブで、ユーザーが接続する際に表示される値を入力し、必要に応じて変更します。これらの値には、パブリックアプリケーション名、アプリケーションロゴ、アプリケーションの説明が含まれます。
- 認証タブで、「リダイレクトURL」ボックスにコールバックURLを入力します。
- デスクトップアプリケーションを作成する場合は、http://localhost:33333のようなローカルにアクセス可能なURLに設定します。
- Webアプリケーションを作成する場合は、ユーザーがアプリケーションを承認した際にリダイレクトされる信頼できるURLに設定します。
- アプリを作成をクリックします。HubSpotがアプリケーションとそれに関連する認証情報を生成します。
- 認証タブで、クライアントIDとクライアントシークレットを確認します。これらは後でドライバーを設定する際に使用します。
スコープの下で、アプリケーションの意図する機能に必要なスコープを選択します。
テーブルにアクセスするには、最低限以下のスコープが必要です:
- hubdb
- oauth
- crm.objects.owners.read
- 変更を保存をクリックします。
- 統合に必要な機能にアクセスできる本番ポータルにアプリケーションをインストールします。
- 「インストールURL(OAuth)」の下で、完全なURLをコピーをクリックして、アプリケーションのインストールURLをコピーします。
- コピーしたリンクをブラウザで開きます。アプリケーションをインストールする標準アカウントを選択します。
- アプリを接続をクリックします。結果のタブは閉じて構いません。
プライベートアプリを使用する
HubSpotプライベートアプリケーショントークンを使用して接続するには、AuthSchemeプロパティを"PrivateApp"に設定します。
以下の手順に従ってプライベートアプリケーショントークンを生成できます:
- HubDBアカウントで、メインナビゲーションバーの設定アイコン(歯車)をクリックします。
- 左サイドバーメニューで、統合 > プライベートアプリに移動します。
- プライベートアプリを作成をクリックします。
- 基本情報タブで、アプリケーションの詳細(名前、ロゴ、説明)を設定します。
- スコープタブで、プライベートアプリケーションがアクセスできるようにしたい各スコープに対して読み取りまたは書き込みを選択します。
- テーブルにアクセスするには、最低限hubdbとcrm.objects.owners.readが必要です。
- アプリケーションの設定が完了したら、右上のアプリを作成をクリックします。
- アプリケーションのアクセストークンに関する情報を確認し、作成を続行をクリックし、その後トークンを表示をクリックします。
- コピーをクリックして、プライベートアプリケーショントークンをコピーします。
接続するには、PrivateAppTokenを取得したプライベートアプリケーショントークンに設定します。
- 「 Test Connection」をクリックします。
- 「Permission」->「 Add」とクリックし、適切な権限を持つ新しいユーザー(または既存のユーザー) を追加します。
仮想データベースが作成されたら、Power BI からHubDB に接続して可視化することができます。
Power BI Connector のダウンロードと接続設定
次に、Connect Server とPower BI Desktop を連携するためのコネクタをインストールします。Connect Server の「CLIENTS」ページにある「Power BI Desktop」の「Download」をクリックすると、ダウンロードが開始します。完了したら、実行ファイルをクリックして製品をインストールしてください。
インストールが完了すると、以下の「DSN Configuration」画面が表示されます。この画面にCData Connect Server への接続に必要となる次の情報を入力します。
- Auth Sceme:Basic
- User:Connect Server で設定したユーザー名
- Password:上記ユーザーのパスワード
- URL:https://<Connect Server のURL>/rest.rsc/
- Default Catalog:Connect Server で設定したコネクション名(HubDB1 など)
- (オプション)SSL Server Cert:サーバー側でSSL を設定していない場合のみ「*」
以上の設定が完了したら、「Test Connection」をクリックして接続をテストします。「The connection test was successful」などと表示されれば、接続テストは成功です。ここから実際にPower BI でデータを取得していきます。
Power BI からHubDB テーブルをクエリ
以下のステップを実行して、HubDB データを取得します。
-
「Power BI Desktop」を開いて「データを取得」画面を表示します。検索ボックスに「cdata connect」と入力すると「CData Connect」が表示されるので、これを選択して「接続」をクリックします。
- PowerBI Connector の設定画面が表示されるので、「Data Source Name」に「Power BI Connect」と入力して「OK」をクリックします。
- ユーザー名とパスワードを入力するよう求められるので、CData Connect Server で設定したユーザー名とパスワードを入力して、「接続」をクリックします。
- 「ナビゲーター」画面で取得したいテーブルを選択します。
- 「読み込み」をクリックして、Power BI にデータをインポートします。
HubDB データの可視化を作成
Power BI にデータを接続したら、「フィールド」ペインのフィールドをキャンバスにドラッグすることで、レポートビューにデータを可視化できます。図表の種類と、ビジュアライズするディメンションおよびメジャーを選択します。
「更新」をクリックしてデータの変更をレポートに同期します。
データアプリケーションからHubDB データへのSQL アクセス
以上で、CData Connect Server を使用してPower BI からHubDB データに接続できるようになりました。これで、HubDB データを複製することなく多くのデータをインポートしたり、新しい可視化やレポートを作成することができます。
オンプレミスのBI やレポート、ETL、その他のデータアプリケーションから、240を超えるSaaS、ビッグデータ、NoSQL データソース(HubDB を含む)への直接のSQL データにアクセスするには、CData Connect Server のページにアクセスして無料トライアルをダウンロードしてください。