Amazon QuickSight でHubDB データに連携するインタラクティブなダッシュボードを作成

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

Amazon QuickSight は、ユーザーがインタラクティブなダッシュボードを作成できるサービスです。Amazon QuickSight とCData Connect Server を一緒に使うことで、簡単にHubDB データに連携する可視化、ダッシュボードを作成することができます。この記事では、Connect Server を経由してAmazon QuickSight からHubDB に連携するダッシュボードを作成する方法を説明します。

CData Connect Server は、HubDB データの仮想インターフェースを提供し、Amazon QuickSight からリアルタイムHubDB データに直接連携することができます。Amazon QuickSight に簡単にHubDB データをインポートすることで、レスポンシブなダッシュボードをAWS エコシステム上で作成することができます。

HubDB の仮想MySQL データベースを作成

CData Connect Server は、直観的なPoint-and-click インターフェースでデータソースへの接続およびAPI エンドポイント作成を行います。

1. Connect Server にログインして、Databases をクリックします。
2. 利用できるデータソースアイコンから"HubDB" を選択します。
3. HubDB に接続するために必要なプロパティを入力します。

   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を取得したプライベートアプリケーショントークンに設定します。

4. Test Database をクリックします。
5. Permission -> Add をクリックして、新しいユーザーを追加し、適切な権限を指定します。

これで、HubDB の仮想データベースが作成でき、Amazon QuickSight からの可視化が可能になりました。

QuickSight にHubDB データをインポートして、インタラクティブダッシュボードを作成

次の手順で、HubDB の仮想データベースをCData Connedct Server に作成し、データをインポートして可視化を作成します。

1. Amazon QuickSight にログインして「データセット」をクリックします。
2. 次に「新しいデータセット」をクリックし、SQL Server をデータソースとして選択します。以下のように、CData Connect Server インスタンスの接続情報を入力していきます。
   • データソース名：任意
   • 接続タイプ：パブリックネットワーク
   • データベースサーバー: 接続するCData Connect Server インスタンスのURL。例：CONNECT_SERVER_URL
   • ポート：インスタンス接続用のポート。1433 など。
   • データベース名：仮想データベース名、例： HubDB1
   • ユーザー名：Connect Server で接続許可を与えたユーザー名
   • パスワード：Connect Server ユーザーのパスワード
   • SSL：インスタンス側でSSL を設定している場合にはオンに、設定していない場合はオフにしてください。
   「接続を検証」をクリックして接続をテストし、問題がなければ「データソースを作成」をクリックして接続を確立します。
3. テーブルの選択画面で、「カスタムSQL を使用」を選択します。
4. 次の画面で、「データの編集/プレビュー」を選択します。
5. カスタムSQL を入力、およびデータをプレビューできる画面が表示されるので、「スキーマエクスプローラー」から可視化したいスキーマおよびテーブルを選択して、以下の形式でカスタムクエリを作成します。

   SELECT <カラム名> FROM [<スキーマ名>].[<テーブル名>]。例えば、SELECT * FROM [HubDB1].[NorthwindProducts] などです。

6. プレビューでデータを確認できたら、「保存して視覚化」ボタンを押して、データをロードします。
7. あとは、フィールドとタイプを選択して自在に可視化を作成できます。

SaaS アプリケーションからHubDB データにSQL アクセスを実現

このようにAmazon QuickSight からHubDB データに連携ができました。これで簡単に可視化やダッシュボード作成が可能です。他にも多くのSaaS に対応するCData Connect Server の詳細をこちらから ご覧ください。