MicroStrategy Web でHCL Domino ODBC Driver を使用

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

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

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

CData ODBC ドライバとは？

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

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

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

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

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

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

Domino への接続

Domino のデータに接続するには、以下のプロパティを設定してください。

• URL: Domino データベースをホスティングしているサーバーのホスト名、またはIP を入力します。サーバーのポート番号を含めてください。例えば、http://sampleserver:1234/。
• DatabaseScope: Domino Web UI 内のスコープ名を入力します。ドライバーは、ここで指定したスコープによって制御されるスキーマの、フォームとビューを公開します。Domino Admin UI で、サイドバーからScopes メニューを選択します。このプロパティを、既存のスコープ名に設定します。

Domino での認証

Domino は、ログインクレデンシャルまたはAzure Active Directory OAuth アプリケーションを使用した認証をサポートしています。

ログインクレデンシャル

ログインクレデンシャルで認証するには、以下のプロパティを設定してください：

• AuthScheme: これを"OAuthPassword" に設定します
• User: 認証するDomino ユーザーのユーザー名
• Password: 認証するDominoユ ーザーに関連付けられたパスワード

ドライバーはログインクレデンシャルを使用して、自動的にOAuth トークン交換を実行します。

AzureAD

この認証方法は、Azure Active Directory をIdP として使用してJWTトークンを取得します。Azure Active Directory にカスタムのアプリケーションを作成し、それをIdP として設定する必要があります。そのためには、ヘルプドキュメントの指示に従ってください。その後、以下のプロパティを設定します。

• AuthScheme: これを"AzureAD" に設定します
• InitiateOAuth: これをGETANDREFRESH に設定します。InitiateOAuth を使用すると、OAuth 交換の繰り返しやOAuthAccessToken の手動設定を避けることができます。
• OAuthClientId: カスタムOAuth アプリケーションのセットアップ時に取得したクライアントID
• OAuthClientSecret: カスタムOAuth アプリケーションのセットアップ時に取得したクライアントシークレット
• CallbackURL: アプリ登録時に定義したリダイレクトURI。例えば、https://localhost:33333
• AzureTenant: データにアクセスするために使用されるMicrosoft Online テナント。companyname.microsoft.com 形式の値またはテナントID のいずれかを指定してください。

  テナントID は、Azure ポータルのAzure Active Directory > プロパティページに表示されているディレクトリID と同じです。

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

Windows

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

Linux

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

/etc/odbc.ini

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

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

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

1. MicroStrategy Web を開き、プロジェクトを選択します。
2. 「Add External Data」をクリックし、「Databases」を選択して「Import Option」として「Select Tables」を選びます。
3. 「Import from Tables」ウィザードでクリックして新しいデータソースを追加します。
• DSN Data Source を選択します。
• DSN プロパティを、以前構成したDSN（CData Domino Sys）に設定します。
• Version プロパティをGeneric DBMS に設定します。
• User プロパティとPassword プロパティを設定（もしくはフィラー値を使用）します。
• Data Source Name を設定します。

4. データソースを作成したらカタログオプションをクリックして編集し、以下のクエリを設定して「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
         

5. テーブルをペインにドラッグします。 Note：ライブ接続を作成するので、テーブル全体をインポートして、MicroStrategy 製品に固有のフィルタリングおよび集計機能を利用できます。
6. 「Finish」をクリックして、ライブ接続するオプションを選択してクエリを保存し、新しいドシエを作成するオプションを選択します。
7. ビジュアライゼーションを選択して表示するフィールドを選択し、フィルタを適用してHCL Domino のデータの新しいビジュアライゼーションを作成します。データ型は、動的なメタデータ検出によって自動的に検出されます。可能であれば、フィルタと集計によって生成された複雑なクエリはHCL Domino にプッシュダウンされ、サポートされていない操作（SQL 関数とJOIN 操作を含む）は、ドライバーに組み込まれたCData SQL エンジンによってクライアント側で管理されます。
8. ドシエの設定が完了したら、「File」->「Save」とクリックします。

おわりに

このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。

CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。

Note：ODBC Driver を使用して接続するには、3- または 4-Tier Architecture が必要です。