CData Connect AI を使用して Databricks でリアルタイムの HCL Domino データに接続・クエリ

Mohsin Turki
Technical Marketing Engineer

CData Connect AI を使用して、リアルタイムのHCL Domino のデータを Databricks に統合し、レプリケーションなしで直接クエリと分析を実現します。

Databricks は、データエンジニアリング、機械学習、アナリティクスを大規模に統合する AI クラウドネイティブプラットフォームです。データウェアハウスのパフォーマンスとデータレイクの柔軟性を兼ね備えた強力なデータレイクハウスアーキテクチャを提供しています。 Databricks を CData Connect AI と統合すると、複雑な ETL パイプラインやデータの複製を必要とせず、HCL Domino のデータにリアルタイムでアクセスでき、運用の効率化とインサイトまでの時間短縮を実現できます。

この記事では、CData Connect AI を使用して Databricks から HCL Domino へのセキュアなライブ接続を設定する方法を説明します。設定が完了すると、標準 SQL を使用して Databricks ノートブックから直接HCL Domino のデータにアクセスでき、データエコシステム全体でリアルタイム分析を統合できます。

概要

シンプルなステップの概要は以下のとおりです：

ステップ 1 - 接続と設定： CData Connect AI で HCL Domino ソースへの接続を作成し、ユーザー権限を設定して、 Personal Access Token（PAT）を生成します。
ステップ 2 - Databricks からクエリ： Databricks に CData JDBC ドライバーをインストールし、ノートブックに接続情報を設定して、 SQL クエリでリアルタイムのHCL Domino のデータにアクセスします。

前提条件

始める前に、以下を準備してください：

アクティブな HCL Domino アカウント
CData Connect AI アカウント。ログインまたは無料トライアルにサインアップできます。
Databricks アカウント。こちらからサインアップまたはログインできます。

ステップ 1：CData Connect AI で HCL Domino 接続を設定

1.1 HCL Domino への接続を追加

CData Connect AI は、利用可能なデータソースに接続するためのシンプルなポイント＆クリックインターフェースを提供しています。

Connect AI にログインし、左側の Sources をクリックして、右上の Add Connection をクリック

Add Connection パネルから 「HCL Domino」 を選択

HCL 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 と同じです。
右上の Save & Test をクリック
HCL Domino Connection ページで Permissions タブに移動し、お好みに応じてユーザーベースの権限を更新します。

1.2 Personal Access Token（PAT）を生成

REST API、OData API、または仮想 SQL Server 経由で Connect AI に接続する場合、 Personal Access Token（PAT）が Connect AI への接続認証に使用されます。PAT は、セキュアなトークンベースの認証としてログイン認証情報の代わりに機能します。アクセスの粒度を維持するため、サービスごとに個別の PAT を作成することをお勧めします。

Connect AI アプリの右上にある歯車アイコン（）をクリックして Settings ページを開く
Settings ページで Access Tokens セクションに移動し、 Create PAT をクリック
PAT に名前を付けて Create をクリック
注意：Personal Access Token は作成時にのみ表示されるので、必ずコピーして安全な場所に保存してください。

ステップ 2：Databricks で HCL Domino データに接続・クエリ

以下の手順に従って、Databricks から HCL Domino への接続を確立します。 CData JDBC Driver for Connect AI をインストールし、JAR ファイルをクラスターに追加して、ノートブックを設定し、 SQL クエリでリアルタイムのHCL Domino のデータにアクセスします。

2.1 CData JDBC Driver for Connect AI をインストール

CData Connect AI で、左側の Integrations ページをクリック。 JDBC または Databricks を検索し、Download をクリックして、お使いの OS 用のインストーラーを選択します。
ダウンロード後、インストーラーを実行して指示に従います：
- Windows の場合：セットアップファイルを実行し、インストールウィザードに従います。
- Mac/Linux の場合：アーカイブを解凍し、フォルダを /opt または /Applications に移動します。実行権限があることを確認してください。

インストール後、インストールディレクトリで JAR ファイルを見つけます：

Windows：

C:\Program Files\CData\CData JDBC Driver for Connect AI\lib\cdata.jdbc.connect.jar

Mac/Linux：

/Applications/CData/CData JDBC Driver for Connect AI/lib/cdata.jdbc.connect.jar

2.2 Databricks に JAR ファイルをインストール

Databricks にログイン。左側のナビゲーションペインで Compute をクリック。コンピュートクラスターを開始または作成します。
実行中のクラスターをクリックし、Libraries タブに移動して、右上の Install New をクリック。
Install Library ダイアログで DBFS を選択し、 cdata.jdbc.connect.jar ファイルをドラッグ＆ドロップ。Install をクリック。

2.3 Databricks ノートブックで HCL Domino データをクエリ

ノートブックスクリプト 1 - JDBC 接続を定義：

以下のスクリプトをノートブックセルに貼り付けます：

driver = "cdata.jdbc.connect.ConnectDriver"
url = "jdbc:connect:AuthScheme=Basic;User=your_username;Password=your_pat;URL=https://cloud.cdata.com/api/;DefaultCatalog=Your_Connection_Name;"

以下を置き換えます：
- your_username - CData Connect AI のユーザー名
- your_pat - CData Connect AI の Personal Access Token（PAT）
- Your_Connection_Name - Sources ページの Connect AI データソース名
スクリプトを実行します。

ノートブックスクリプト 2 -HCL Domino のデータから DataFrame を読み込み：

2 番目のスクリプト用に新しいセルを追加します。ノートブック右側のメニューから Add cell below をクリック。
以下のスクリプトを新しいセルに貼り付けます：

remote_table = spark.read.format("jdbc") \
  .option("driver", "cdata.jdbc.connect.ConnectDriver") \
  .option("url", "jdbc:connect:AuthScheme=Basic;User=your_username;Password=your_pat;URL=https://cloud.cdata.com/api/;DefaultCatalog=Your_Connection_Name;") \
  .option("dbtable", "YOUR_SCHEMA.YOUR_TABLE") \
  .load()

以下を置き換えます：
- your_username - CData Connect AI のユーザー名
- your_pat - CData Connect AI の Personal Access Token（PAT）
- Your_Connection_Name - Sources ページの Connect AI データソース名
- YOUR_SCHEMA.YOUR_TABLE - スキーマとテーブル名（例：Domino.ByName）
スクリプトを実行します。

ノートブックスクリプト 3 - カラムをプレビュー：

同様に、3 番目のスクリプト用に新しいセルを追加します。
以下のスクリプトを新しいセルに貼り付けます：

display(remote_table.select("ColumnName1", "ColumnName2"))

ColumnName1 と ColumnName2 を HCL Domino 構造の実際のカラム名に置き換えます（例：Name、Address など）。
スクリプトを実行します。

Databricks ノートブックでHCL Domino のデータデータをプレビュー

これで、バックエンド API の複雑さを意識することなく、またHCL Domino のデータをレプリケーションすることなく、 Databricks ノートブック内で直接リアルタイムの HCL Domino のデータ を探索、結合、分析できるようになりました。

CData Connect AI を 14 日間無料でお試しください

HCL Domino のデータへのリアルタイムアクセスを簡素化する準備はできましたか？ CData Connect AI の 14 日間無料トライアルを今すぐ開始して、 Databricks から HCL Domino へのシームレスなライブ接続を体験してください。

ローコード、インフラ不要、レプリケーション不要 - 重要なデータとインサイトへのシームレスでセキュアなアクセスを実現します。

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

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアルお問い合わせ