NetBeans IDE でHCL Domino のデータに仮想RDB として連携

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData JDBC Driver for Domino は、JDBC をサポートするIDE にリアルタイムHCL Domino のデータへの仮想DB 連携を実現します。JDBC 標準では、ビルトインのデータアクセスウィザードや、迅速な開発をサポートするその他のツールを使用できます。この記事では、NetBeans でHCL Domino に接続する方法を説明します。接続を作成してロード していきます。

NetBeans にHCL Domino のJDBC データソースを作成

JDBC データソースを作成するには、［Service］ウィンドウの［Database］ノードを展開し、［Drivers］ノードを右クリックして［New Driver］を選択します。［New Driver］ウィザードが表示されたら、以下の情報を入力します：

• Driver File(s)：［Add］をクリックして、ファイルエクスプローラダイアログが表示されたらcdata.jdbc.domino.jar ファイルを選択。ドライバーのJAR はインストールディレクトリの［lib］サブフォルダ内にあります。
• Driver Class：［Find］をクリックしてJAR 内のドライバークラスを検索し、cdata.jdbc.domino.DominoDriver をメニューから選択。
• Name：ドライバーの名前を入力。

接続パラメータを定義

下記の手順に従って、必要な接続プロパティを定義します：

1. ［Service］ウィンドウで、［Database］ノードを右クリックし［New Connection］をクリックします。

2. ［New Connection］ウィザードで次の接続プロパティを入力します：

   • Driver Name：CData JDBC Driver for Domino を選択。
   • User Name：ユーザーネームを入力。JDBC URL でも定義できます。
   • Password：パスワードを入力。JDBC URL でも定義できます。

   • JDBC URL：JDBC URL を指定。

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

     以下は一般的なJDBC URL です：
     jdbc:domino:Server=https://domino.corp.com;Database=names.nsf;Port=3002;SSLClientCertType=PEMKEY_FILE;SSLClientCert=full_path_of_certificate.pem;SSLServerCert=*

リアルタイムHCL Domino のデータをクエリ

HCL Domino に接続するには、［Database］ノードにある接続を右クリックし［Connect］をクリックします。接続が確立されたら、展開してスキーマ情報を見ることができます。

［Data Views］ウィンドウにテーブルをロードするには、テーブルを右クリックしてから［View Data］をクリックします。。