SSAS でHubDB データに連携するOLAP Cube を作成

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

SQL Server Analysis Services (SSAS) は、意思決定支援やビジネスアナリティクスで使われる解析エンジンです。ビジネスレポートおよび、Power BI やExcel、 Reporting Services レポート、その他のデータ可視化ツールのようなクライアントアプリケーションに、エンタープライズレベルのセマンティックデータを提供します。HubDB 用のCData ADO.NET プロバイダーと合わせれば、HubDB を使って、より深く速いデータ分析のためのキューブを作成できます。

この記事では、Analysis Services プロジェクトをVisual Studio で作成し、HubDB の多次元モデルを構築および配置する方法を説明します。これには、アクセス可能なSSAS インスタンスと、ADO.NET プロバイダーのインストールが必要です。

HubDB 用のJDBC データソースの設定

まず、Visual Studio で新しい多元的なAnalysis Service とデータマイニングプロジェクトを作成します。次に、プロジェクト内でHubDB 用のデータソースを作成します。

1. ［Solution Explorer］ の［Data Source］ を右クリックし、［New Data Source］ を選択します。
2. 既存または新規の接続に基づいて、データソースを作成することを選択し、［New］ をクリックします。
3. ［Connection Manager］ のHubDB 用CData ADO.NET プロバイダーを選択し、必要な接続プロパティに入力後、［Next］ をクリックします。

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

   接続を構成する際に、Max Rows プロパティを定めることも可能です。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。

4. インパーソネーションを［Inherit］ に設定し、［Next］ をクリックします。
5. データソースに名称(CData HubDB Source) を入力し、［Finish］ をクリックします。

データソースビューの作成

データソースの次に、データソースビューを作成します。

1. ［Solution Explorer］ で［Data Source Views］ を右クリックし、［New Data Source View］ を選択します。
2. 先ほど作成したデータソース(CData HubDB Source) を選択し、［Next］ をクリックします。
3. 基になるデータソースのパターンに一致する外部キーを選択し、［Next］ をクリックします。
4. HubDB の表を選択、ビューに追加し、［Next］ をクリックします。
5. ビューに名前を付け、［Finish］ をクリックします。

スキームに一致する外部キーに基づいて、基礎的なデータとのリレーションが検出されます。［Data Source View］ をダブルクリックすることで、これらのリレーションを確認・編集することができます。

［Data Source View］ へのセカンダリデータソースの追加はサポートされないことに注意してください。複数のデータソースを利用する場合、SSAS は、すべてのソースがADO.NET プロバイダーでは使用できないOpenRowset 経由のリモートクエリをサポートすることを必要とします。

HubDB 用のキューブを作成する

プロジェクトを処理してHubDB をSSAS に展開するための最後のステップはキューブの作成です。

1. ［Solution Explorer］ の［Cubes］ を右クリックし、［New Cube］ を選択します。
2. ［Use existing tables］ を選択し、［Next］ をクリックします。
3. メジャーグループテーブルに使用するテ－ブルを選択し、［Next］ をクリックします。
4. キューブに含ませたいメジャーを選択し、［Next］ をクリックします。
5. 使用可能なテーブルに基づいて作成するディメンションを選択し、［Next］ をクリックします。
6. すべての選択内容を確認し、［Finish］ をクリックします。

プロジェクトを処理する

データソースと、データソースビュー、キューブを作成すると、SSASにキューブを展開する準備が完了します。ターゲットサーバーとデータベースを構成するために、プロジェクトを右クリックしプロパティを選択します。デプロイメントに移動し、ターゲットセクションでサーバーとデータベースのプロパティを設定します。

ターゲットサーバーとデータベースを構成した後、プロジェクトを右クリックして［Process］ を選択します。このステップの一部として、プロジェクトの構成・デプロイが必要となる場合があります。プロジェクトを構成・デプロイし、［Process Database］ウィザードにある［Run］ をクリックします。

SSAS インスタンスにHubDB 用のOLAP キューブが作成され、分析、レポート、表示の準備が完了します。HubDB 用のCData ADO.NET プロバイダーの30日の無償評価版をダウンロードして、SSAS データをご利用ください。