RapidMiner からHCL Domino のデータに連携

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

HCL Domino をRapidMiner Studio の標準コンポーネント及びデータソース構成ウィザードと統合します。

この記事では、CData JDBC Driver for Domino をRapidMiner のプロセスと簡単に統合する方法を示します。この記事では、CData JDBC Driver for Domino を使用してHCL Domino をRapidMiner のプロセスに転送します。

RapidMiner のHCL Domino にJDBC Data Source として接続する

以下のステップに従ってHCL Domino へのJDBC 接続を確認できます。

HCL Domino 用の新しいデータベースドライバーを追加します。［Connections］->［Manage Database Drivers］とクリックします。
表示されるウィザードで［Add］ボタンをクリックし、接続に名前を入力します。
JDBC URL のプレフィックスを入力します。
```
jdbc:domino:
```
インストールディレクトリのlib サブフォルダにあるcdata.jdbc.domino.jar ファイルにパスを入力して下さい。
ドライバークラスを入力します。
```
cdata.jdbc.domino.DominoDriver
```
新しいHCL Domino 接続を作成します。［Connections］->［Manage Database Connections］とクリックします。
接続の名前を入力します。
データベースシステムの場合は、以前構成したHCL Domino ドライバーを選択します。
Host ボックスで接続文字列を入力します。
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 と同じです。

ビルトイン接続文字列デザイナ

JDBC URL の構成については、HCL Domino JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
```
java -jar cdata.jdbc.domino.jar
```
接続プロパティを入力し、接続文字列をクリップボードにコピーします。

以下は一般的な接続文字列です。
```
URL=http://dominoserver:3002/;DatabaseScope=names;TableTypes=Tables;AuthScheme=OAuthPassword;User=MyUser;Password=MyPassword;
```
必要であればユーザー名とパスワードを入力します。

プロセス内の様々なRapidMiner オペレーターとのHCL Domino 接続を使用できます。HCL Domino を取得するには、［Operators］ビューから［Retrieve］をドラッグします。 A Retrieve operation to select data.(Salesforce is shown.) ［Retrieve］オペレータを選択した状態で、［repository entry］の横にあるフォルダアイコンをクリックして［Parameters］ビューで取得するテーブルを定義できます。表示されるRepository ブラウザで接続ノードを展開し、目的のサンプルセットを選択できます。