MicroStrategy Desktop で CData ODBC Driver for HubDB を使用

MicroStrategy は、データドリブンなイノベーションを可能にする分析およびモビリティプラットフォームです。CData ODBC Driver for HubDB と組み合わせることで、MicroStrategy からリアルタイムのHubDB のデータにデータベースのようにアクセスでき、レポートや分析の機能を拡張できます。本記事では、MicroStrategy Desktop で HubDB をデータソースとして追加し、HubDB のデータ の簡単なビジュアライゼーションを作成する手順を説明します。

CData ODBC Driver は、ドライバーに組み込まれた最適化されたデータ処理により、MicroStrategy でリアルタイムのHubDB のデータを操作する際に比類のないパフォーマンスを発揮します。MicroStrategy から HubDB に複雑な SQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされている SQL 操作を HubDB に直接プッシュし、サポートされていない操作（多くの場合 SQL 関数や JOIN 操作）は組み込みの SQL エンジンを使用してクライアント側で処理します。動的なメタデータクエリ機能が組み込まれているため、ネイティブの MicroStrategy データ型を使用してHubDB のデータを可視化・分析できます。

ODBC データソースとして HubDB に接続

HubDB への接続に関する情報と、Windows および Linux 環境での DSN 設定手順を以下に説明します。

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

DSN を設定する際に、Max Rows 接続プロパティも設定することをお勧めします。これにより返される行数を制限でき、レポートやビジュアライゼーションを設計する際のパフォーマンス向上に特に効果的です。

Windows

まだ設定していない場合は、ODBC DSN（データソース名）で接続プロパティを指定してください。これはドライバーインストールの最後のステップです。Microsoft ODBC データソースアドミニストレーターを使用して ODBC DSN を作成・設定できます。

Linux

Linux 環境で CData ODBC Driver for HubDB をインストールする場合、ドライバーのインストール時にシステム DSN が事前定義されます。システムデータソースファイル（/etc/odbc.ini）を編集して、必要な接続プロパティを定義することで DSN を変更できます。

/etc/odbc.ini

[CData HubDB Sys]
Driver = CData ODBC Driver for HubDB
Description = My Description
AuthScheme = OAuth
OAuthClientID = MyOAuthClientID
OAuthClientSecret = MyOAuthClientSecret
CallbackURL = http://localhost:33333

これらの設定ファイルの使用方法の詳細については、ヘルプドキュメント（インストール版およびオンライン版）を参照してください。

MicroStrategy Desktop を使用して HubDB のデータに接続して可視化

MicroStrategy エンタープライズ製品で HubDB に接続するだけでなく、MicroStrategy Desktop でも HubDB に接続できます。以下の手順に従って、HubDB のデータ をデータセットとして追加し、HubDB のデータ のビジュアライゼーションとレポートを作成してください。

1. MicroStrategy Desktop を開き、新しいドシエを作成します。
2. データセットパネルで「New Data」をクリックし、「Databases」を選択して、インポートオプションとして「Type a Query」を選択します。
3. 新しいデータソースを追加し、「DSN data sources」を選択します。
4. 以前に設定した DSN（通常は CData HubDB Sys）を選択し、Version メニューで「Generic DBMS」を選択します。
5. DSN の User と Password プロパティを設定し（またはプレースホルダー値を使用）、データソースに名前を付けます。
6. 新しいデータベースインスタンスを選択してテーブルを表示します。「Available Tables」セクションでテーブルを表示するには、検索アイコンを手動でクリックする必要がある場合があります。
7. HubDB のデータ 用の SQL クエリを作成し（以下を参照）、「Execute SQL」をクリックしてクエリをテストします。

   SELECT * FROM NorthwindProducts
   

   注意：ライブ接続を作成するため、SELECT * クエリを実行し、MicroStrategy 製品にネイティブのフィルタリングや集計機能を利用できます。
8. 「Finish」をクリックし、ライブ接続を選択します。
9. ビジュアライゼーションを選択し、表示するフィールドを選択し（データ型は動的メタデータ検出により自動的に検出されます）、フィルタを適用してHubDB のデータの新しいビジュアライゼーションを作成します。可能な場合、フィルタや集計によって生成された複雑なクエリは HubDB にプッシュダウンされ、サポートされていない操作（SQL 関数や JOIN 操作を含む場合があります）はドライバーに組み込まれた CData SQL エンジンによってクライアント側で管理されます。
10. ドシエの設定が完了したら、「File -> Save」をクリックします。

MicroStrategy Desktop で CData ODBC Driver for HubDB を使用すると、HubDB のデータ の堅牢なビジュアライゼーションとレポートを簡単に作成できます。その他の例については、MicroStrategy で HubDB に接続や MicroStrategy Web で HubDB に接続に関する記事もご覧ください。