RazorSQL で HCL Domino のデータに接続

Jerod Johnson
Senior Technology Evangelist

RazorSQL データベース管理ツールのウィザードを使用して HCL Domino に接続し、GUI で HCL Domino のデータをクエリします。

CData JDBC Driver for HCL Domino は、IDE のウィザードからデータ管理・分析ツールまで、サードパーティツールからの標準ベースのアクセスを可能にします。この記事では、RazorSQL のウィザードを使用して HCL Domino に接続する方法を説明します。

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

RazorSQL アプリケーションを開き、「Connections」メニューから「Add Connection Profile」->「Other」->「JDBC」を選択します。
表示される「Connection Wizard」で、以下のプロパティを設定します。
- Driver Location：インストールディレクトリ内の lib サブフォルダへのパスを設定します。
- Driver Class：ドライバークラスを cdata.jdbc.domino.DominoDriver に設定します。
- Username：ユーザー名を入力します（このプロパティは JDBC URL 内でも設定できます）。
- Password：パスワードを入力します（このプロパティは JDBC URL 内でも設定できます）。
- JDBC URL：接続パラメータを入力します。JDBC URL は jdbc:domino: で始まり、その後にセミコロンで区切られた接続プロパティが続きます。
  
  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
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  
  一般的な JDBC URL は以下のとおりです。
```
jdbc:domino:URL=http://dominoserver:3002/;DatabaseScope=names;TableTypes=Tables;AuthScheme=OAuthPassword;User=MyUser;Password=MyPassword;
```