MicroStrategy Desktop で CData ODBC Driver for ApprovalMax を使用

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
CData ODBC Driver for ApprovalMax を使用して MicroStrategy Desktop でApprovalMax のデータに接続する方法を紹介します。

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

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

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

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

まず、Profile 接続プロパティをディスク上の ApprovalMax プロファイルの場所に設定します（例：C:\profiles\ApprovalMax.apip）。次に、ProfileSettings 接続プロパティを ApprovalMax の接続文字列に設定します（以下を参照）。

ApprovalMax API プロファイル設定

ApprovalMax Public API では、OAuth 2.0 の認可コードフローで認証を行います。自分のデータに接続するだけでなく、他のユーザーが各自のデータに接続できるようにすることも可能です。

まず、ApprovalMax に OAuth アプリケーションを登録する必要があります。ApprovalMax Developer Portal（https://developer.approvalmax.com/applications）にサインインし、新しいアプリケーションを作成します。OAuth アプリケーションには Client ID と Client Secret が割り当てられます。また、Redirect URI（Callback URL）を少なくとも1つ登録しておく必要があります。

Public API を利用するには、ApprovalMax の Premium サブスクリプション（または有効なトライアル）が必要です。

以下の接続プロパティを設定すると、接続できるようになります。

  • AuthScheme：OAuth に設定します。
  • InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使うと、OAuthAccessToken を取得するプロセスを管理できます。
  • OAuthClientId：ApprovalMax Developer Portal のアプリケーション設定に表示される Client ID に設定します。
  • OAuthClientSecret：ApprovalMax Developer Portal のアプリケーション設定に表示される Client Secret に設定します。
  • CallbackURL：アプリケーション設定で登録した Redirect URI に設定します。
  • Scope：（オプション）デフォルトの OAuth スコープを上書きします。デフォルト値の openid offline_access https://www.approvalmax.com/scopes/public_api/read は、このプロファイルのすべてのテーブルへの読み取り専用アクセスを許可し、リフレッシュトークンを有効にします。スコープを絞り込む際は、最小権限の原則に従ってください。

OAuth の Authorization URL は https://identity.approvalmax.com/connect/authorize、Token URL は https://identity.approvalmax.com/connect/token です。グラントタイプは authorization_code と refresh_token の両方に対応しています。

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

Windows

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

Linux

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

/etc/odbc.ini


[CData API Sys]
Driver = CData ODBC Driver for ApprovalMax
Description = My Description
Profile = C:\profiles\ApprovalMax.apip
AuthScheme = OAuth
InitiateOAuth = GETANDREFRESH
OAuthClientId = your_client_id
OAuthClientSecret = your_client_secret
CallbackURL = your_callback_url

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

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

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

  1. MicroStrategy Desktop を開き、新しいドシエを作成します。
  2. データセットパネルで「New Data」をクリックし、「Databases」を選択して、インポートオプションとして「Type a Query」を選択します。
  3. 新しいデータソースを追加し、「DSN data sources」を選択します。
  4. 以前に設定した DSN（通常は CData API Sys）を選択し、Version メニューで「Generic DBMS」を選択します。
  5. DSN の User と Password プロパティを設定し（またはプレースホルダー値を使用）、データソースに名前を付けます。 ApprovalMax 用の新しいデータソースを作成
  6. 新しいデータベースインスタンスを選択してテーブルを表示します。「Available Tables」セクションでテーブルを表示するには、検索アイコンを手動でクリックする必要がある場合があります。
  7. ApprovalMax のデータ 用の SQL クエリを作成し（以下を参照）、「Execute SQL」をクリックしてクエリをテストします。 
    
SELECT * FROM UserProfiles
    ApprovalMax からデータをクエリ 注意：ライブ接続を作成するため、SELECT * クエリを実行し、MicroStrategy 製品にネイティブのフィルタリングや集計機能を利用できます。
  8. 「Finish」をクリックし、ライブ接続を選択します。
  9. ビジュアライゼーションを選択し、表示するフィールドを選択し（データ型は動的メタデータ検出により自動的に検出されます）、フィルタを適用してApprovalMax のデータの新しいビジュアライゼーションを作成します。可能な場合、フィルタや集計によって生成された複雑なクエリは ApprovalMax にプッシュダウンされ、サポートされていない操作（SQL 関数や JOIN 操作を含む場合があります）はドライバーに組み込まれた CData SQL エンジンによってクライアント側で管理されます。 ApprovalMax のデータ を可視化
  10. ドシエの設定が完了したら、「File -> Save」をクリックします。

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

はじめる準備はできましたか？

API Driver で ApprovalMax のライブデータに接続

ApprovalMax に接続

この記事の内容

関連記事