MicroStrategy Desktop で CData ODBC Driver for HCL Domino を使用

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

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

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

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

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

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

/etc/odbc.ini

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

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

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

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

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

   SELECT * FROM ByName
   

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

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