TIBCO Data Virtualization で HCL Domino のデータ にリアルタイムアクセスする方法

CData TIBCO DV Adapter for HCL Domino を使って、TIBCO Data Virtualization Studio でHCL Domino のデータソースを作成し、TDV Server からHCL Domino のデータにリアルタイムでアクセスする方法を解説します。

TIBCO Data Virtualization（TDV）は、複数の多様なデータソースへのアクセスを一元管理するエンタープライズデータ仮想化ソリューションです。CData TIBCO DV Adapter for HCL Domino と組み合わせることで、TIBCO Data Virtualization 内からHCL Domino のデータに直接フェデレーテッドアクセスが可能になります。この記事では、アダプターのデプロイと HCL Domino に基づく新しいデータソースの作成手順を解説します。

CData TIBCO DV Adapter は、最適化されたデータ処理機能が組み込まれており、HCL Domino のデータ とのインタラクションにおいて比類のないパフォーマンスを発揮します。HCL Domino に対して複雑な SQL クエリを発行すると、アダプターはフィルタや集計などサポートされている SQL 操作を直接 HCL Domino にプッシュします。組み込みの動的メタデータクエリにより、ネイティブのデータ型を使用してHCL Domino のデータを操作・分析できます。

HCL Domino TIBCO DV Adapter のデプロイ

  1. コンソールで、TDV Server のインストールディレクトリ内の bin フォルダに移動します。現在のバージョンのアダプターがインストールされている場合は、先にアンデプロイする必要があります。

    .\server_util.bat -server localhost -user admin -password ******** -undeploy -version 1 -name Domino

  2. CData TIBCO DV Adapter をローカルフォルダに解凍し、解凍した場所から JAR ファイル（tdv.domino.jar）をサーバーにデプロイします。

    .\server_util.bat -server localhost -user admin -password ******** -deploy -package /PATH/TO/tdv.domino.jar

新しい JAR ファイルが正しくロードされるように、サーバーの再起動が必要な場合があります。再起動は、C:\Program Files\TIBCO\TDV Server <version>\bin にある composite.bat スクリプトを実行して行えます。サーバーを再起動した後は、TDV Studio への再認証が必要です。

再起動コマンドの例

.\composite.bat monitor restart
アダプターをデプロイしたら、TDV Studio で HCL Domino 用の新しいデータソースを作成できます。

TDV Studio で HCL Domino データソースを作成する

CData TIBCO DV Adapter for HCL Domino を使用すると、HCL Domino 用のデータソースを簡単に作成し、データソースをイントロスペクトしてリソースを TDV に追加できます。

データソースの作成

  1. データソースを追加するフォルダを右クリックし、New -> New Data Source を選択します。
  2. アダプター（例：HCL Domino）が表示されるまでスクロールし、Next をクリックします。
  3. データソースに名前を付けます（例：CData HCL Domino Source）。

  4. 必要な接続プロパティを入力します。

    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 と同じです。

  5. Create & Close をクリックします。

データソースのイントロスペクト

データソースを作成したら、右クリックして Open を選択することでデータソースをイントロスペクトできます。ダッシュボードで Add/Remove Resources をクリックし、データソースの一部として含めるテーブル、ビュー、ストアドプロシージャを選択します。Next をクリックし、Finish をクリックして、選択した HCL Domino のテーブル、ビュー、ストアドプロシージャをリソースとして追加します。

After creating and introspecting the data source, you are ready to work with HCL Domino のデータ in TIBCO Data Virtualization just like you would any other relational data source. You can create views, query using SQL, publish the data source, and more.

データソースを作成してイントロスペクトしたら、他のリレーショナルデータソースと同様に TIBCO Data Virtualization でHCL Domino のデータを操作できるようになります。ビューの作成、SQL によるクエリ、データソースの公開など、さまざまな操作が可能です。

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

詳細：

TIBCO DV アダプタ

この記事の内容

関連記事