MicroStrategy Web でHCL Domino ODBC Driver を使用

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

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

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 ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。

HCL Domino をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
多様なアプリケーション、ツールにHCL Domino のデータを連携
ノーコードでの手軽な接続設定
標準 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 アドレス。Domino データベースをホスティングしているサーバーのポートを含めます。例：http://sampleserver:1234/
DatabaseScope：Domino Web UI でのスコープ名。CData 製品は、指定されたスコープに適合するスキーマのフォームとビューを公開します。Domino Admin UI で、サイドバーのScopes メニューを選択してください。このプロパティを既存のスコープ名に設定します

Domino での認証

続いて、認証方法を設定しましょう。Domino では、ログインクレデンシャル（OAuthPassword）またはMicrosoft Entra ID（AzureAD）のいずれかによる認証をサポートしています。

ログインクレデンシャル

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

AuthScheme：OAuthPassword
User：認証するDomino ユーザーのユーザー名
Password：認証するDomino ユーザーに関連付けられたパスワード

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

Microsoft Entra ID（Azure AD）

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

AuthScheme：AzureAD
InitiateOAuth：これをGETANDREFRESH に設定します。InitiateOAuth を使用すると、OAuth 交換の繰り返しやOAuthAccessToken の手動設定を避けることができます
OAuthClientId：カスタムAzure AD アプリケーションの作成時に取得したクライアントID
OAuthClientSecret：カスタムAzure AD アプリケーションの作成時に取得したクライアントシークレット
CallbackURL：カスタムAzure AD アプリケーションの登録時に指定されたリダイレクト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

[CData Domino Sys]
Driver = CData ODBC Driver for Domino
Description = My Description
URL = http://dominoserver:3002/
DatabaseScope = names
TableTypes = Tables
AuthScheme = OAuthPassword
User = MyUser
Password = MyPassword

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

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

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

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

DSN Data Source を選択します。
DSN プロパティを、以前構成したDSN（CData Domino 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」をクリックして、ライブ接続するオプションを選択してクエリを保存し、新しいドシエを作成するオプションを選択します。
ビジュアライゼーションを選択して表示するフィールドを選択し、フィルタを適用してHCL Domino のデータの新しいビジュアライゼーションを作成します。データ型は、動的なメタデータ検出によって自動的に検出されます。可能であれば、フィルタと集計によって生成された複雑なクエリはHCL Domino にプッシュダウンされ、サポートされていない操作（SQL 関数とJOIN 操作を含む）は、ドライバーに組み込まれたCData SQL エンジンによってクライアント側で管理されます。
ドシエの設定が完了したら、「File」->「Save」とクリックします。