MicroStrategy Web でTypeform ODBC Driver を使用

古川えりか
コンテンツスペシャリスト

CData ODBC Driver を使用してMicroStrategy Web からTypeform のデータに接続

MicroStrategy は、データドリブンイノベーションを可能にする分析およびモバイルプラットフォームです。MicroStrategy とCData ODBC Driver for API を組み合わせると、MicroStrategy からデータベースと同じ感覚でリアルタイムTypeform のデータにアクセスできるようになり、より高度なレポートと分析が行えます。この記事では、MicroStrategy Web に外部データとしてTypeform を追加し、Typeform のデータの簡単なビジュアライゼーションを作成する方法について説明します。

CData ODBC ドライバーは、ドライバーに組み込みの最適化されたデータ処理により、MicroStrategy でリアルタイムTypeform のデータとやり取りする上で最高のパフォーマンスを提供します。MicroStrategy からTypeform に複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作をTypeform に直接プッシュし、サポートされていない操作（主にSQL 関数とJOIN 操作）は、組み込みのSQL エンジンを利用してクライアント側で処理します。ビルトインの動的メタデータクエリを使用すると、ネイティブのMicroStrategy データ型を使用してTypeform のデータをビジュアライズおよび分析できます。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。

Typeform をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
多様なアプリケーション、ツールにTypeform のデータを連携
ノーコードでの手軽な接続設定
標準 SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてTypeform の接続を設定、2.MicroStrategy Web 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData ODBC ドライバのインストールとTypeform への接続設定

まずは、本記事右側のサイドバーからAPI ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

Typeform への接続に関する情報と、Windows およびLinux 環境でのDSN の設定手順を以下で説明します。（ODBC Driver for API は、接続されたMicroStrategy Intelligence Server をホストしているマシンにインストールする必要があります。）

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

TypeForm API プロファイル設定

TypeForm への認証にはOAuth 標準を使用します。

TypeForm に認証するには、まずTypeForm でOAuth アプリケーションを登録および設定する必要があります：https://admin.typeform.com/account#/section/tokens。アプリにはclient ID とclient secret が割り当てられ、接続文字列で設定できます。OAuth アプリケーションの設定の詳細については、https://developer.typeform.com/get-started/ をご参照ください。

使用シナリオによって異なるリダイレクトURI が必要です：

CData デスクトップアプリケーション：CData デスクトップアプリケーション（Sync、API Server、ArcESB）は/src/oauthCallback.rst でOAuth トークンを受け入れます。ホストとポートはアプリケーションが使用するデフォルトポートと同じです。例えば、http://localhost:8019/ でCData Sync にアクセスする場合、リダイレクトURI はhttp://localhost:8019/src/oauthCallback.rst になります。
CData クラウドアプリケーション：CData クラウドアプリケーションはデスクトップ版と同様です。https://1.2.3.4/ でConnect AI にアクセスする場合、リダイレクトはhttps://1.2.3.4/src/oauthCallback.rst を使用します。
デスクトップアプリケーション：デスクトップアプリケーションを使用する場合、URI はhttps://localhost:33333 を推奨します。
Web アプリケーション：ドライバーを使用してWeb アプリケーションを開発する場合、https://my-website.com/oauth のような独自のURI を使用します。

以下の接続プロパティを設定すると、接続の準備が整います：

AuthScheme：OAuth に設定します。
InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。
OAuthClientId：アプリ設定で指定されているClient Id を設定します。
OAuthClientSecret：アプリ設定で指定されているClient Secret を設定します。
CallbackURL：アプリ設定で指定したRedirect URI を設定します。

DSN を構成する際にはMax Rows 接続プロパティも設定できます。これにより返される行数が制限されるため、レポートやビジュアライゼーションを作成するときのパフォーマンスを向上させることができます。

Windows

接続プロパティが未設定の場合は、まずODBC DSN（データソース名）で設定します。これはドライバーインストール時の最後の手順にあたります。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。

Linux

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

/etc/odbc.ini

[CData API Sys]
Driver = CData ODBC Driver for API
Description = My Description
Profile = C:\profiles\TypeForm.apip
Authscheme = OAuth
OAuthClientId = your_client_id
OAuthClientSecret = your_client_secret
CallbackUrl = your_callback_url

これらの設定ファイルの使用方法については、オンラインのヘルプドキュメントを参照してください。

MicroStrategy Web を使用してTypeform のデータに接続し、ビジュアライズする

MicroStrategy Developer でデータベースインスタンスを作成してプロジェクトに接続すると、MicroStrategy Web からTypeform のデータのデータインポートを実行できます。もしくは、ODBC Driver を使用して新しいデータソースを作成することもできます。^*

MicroStrategy Web を開き、プロジェクトを選択します。
「Add External Data」をクリックし、「Databases」を選択して「Import Option」として「Select Tables」を選びます。
「Import from Tables」ウィザードでクリックして新しいデータソースを追加します。

DSN Data Source を選択します。
DSN プロパティを、以前構成したDSN（CData API Sys）に設定します。
Version プロパティをGeneric DBMS に設定します。
User プロパティとPassword プロパティを設定（もしくはフィラー値を使用）します。
Data Source Name を設定します。

データソースを作成したらカタログオプションをクリックして編集し、以下のクエリを設定して「OK」をクリックします。
- 以下は、データソースで使用可能なテーブルを取得するためのSQL ステートメントです。
```
SELECT
  CatalogName NAME_SPACE,
  TableName TAB_NAME
FROM
  SYS_TABLES
    
```
- 以下は、選択したテーブルのカラムを取得するためのSQL ステートメントです。
```
SELECT DISTINCT
  CatalogName NAME_SPACE,
  TableName TAB_NAME,
  ColumnName COL_NAME,
  DataTypeName DATA_TYPE,
  Length DATA_LEN,
  NumericPrecision DATA_PREC,
  NumericScale DATA_SCALE
FROM
  SYS_TABLECOLUMNS
WHERE
  TableName IN (#TABLE_LIST#)
ORDER BY
  1,2,3
    
```
テーブルをペインにドラッグします。 Note：ライブ接続を作成するので、テーブル全体をインポートして、MicroStrategy 製品に固有のフィルタリングおよび集計機能を利用できます。
「Finish」をクリックして、ライブ接続するオプションを選択してクエリを保存し、新しいドシエを作成するオプションを選択します。
ビジュアライゼーションを選択して表示するフィールドを選択し、フィルタを適用してTypeform のデータの新しいビジュアライゼーションを作成します。データ型は、動的なメタデータ検出によって自動的に検出されます。可能であれば、フィルタと集計によって生成された複雑なクエリはTypeform にプッシュダウンされ、サポートされていない操作（SQL 関数とJOIN 操作を含む）は、ドライバーに組み込まれたCData SQL エンジンによってクライアント側で管理されます。
ドシエの設定が完了したら、「File」->「Save」とクリックします。