Lakebase のデータをBoomi AtomSphere で連携利用する方法：CData JDBC Driver

桑島義行
テクニカルディレクター

CData JDBC ドライバを使って、データ統合サービス（iPaaS）のBoomi で Lakebase のデータをノーコードで連携。

Boomi AtomSphere https://boomi.com/は、Boomi 社が提供する、シングルインスタンス、マルチテナントアーキテクチャを特徴としているデータ統合サービス（iPaaS）です。データ統合機能だけでなく、マスターデータのハブ機能、EDI、APIManagement、WorkFlow といったビジネスユースに必要なデータ連携のすべてを実現する機能をシングルプラットフォームで提供しています。

この記事では、Boomi AtomSphere のオンプレミスAtom deployment 機能を使って、CData JDBC ドライバ経由でLakebase のデータにアクセスする方法を紹介します。CData Drivers を使うことで、RDB のようにBoomi 内でLakebase のデータを扱うことができるようになります。

Boomi のon-Premise Atom depleyment の作成

on-Premise Atom deployment （右上の青部分）を利用する構成としました。この機能を利用することでOn-Premise 側に配置したCData JDBC ドライバ経由でのSaaS 連携を実現します。

ブラウザからBoomi Atom のManage > Atom Management のタブを開きます。
+New > Atom を開きます。
Atom Setup ダイアログが開くので、ブラウザを開いているマシンのOS（本例ではWindows10Pro 64bit）のSetup ファイルをダウンロードします。

ダウンロードした「atom_install64.exe」を実行するとインストーラが起動します。
Setup Wizard を進めます。
ブラウザからBoomi Atom へのログインする時のUser・Password をセットして、Atom Name はデフォルトのまま、次に進みます。
on-Premise Atom deployment のインストールディレクトリ（デフォルト）を指定して次に進みます。
Setup Wizard を終了（Finish）します。
ブラウザからBoomi Atom のManage > Atom Management のタブを開いて、上記で作成したon-Premise Atom Deployment が起動していることを確認します。なお、Windows マシンの場合、サービスからも起動を確認できます。on-Premise Atom deployment の作成は以上です。

Boomi on-Premise Atom deployment モジュールへのJDBC ドライバの配置

次に別途ダウンロード・インストールしたCData JDBC Driver for Lakebase をBoomi on-premise Atom モジュールに配置していきます。

cdata.jdbc.lakebase.jar
cdata.jdbc.lakebase.lic （試用版では.lic ファイルは不要）

コピー元：C:\Program Files\CData\CData JDBC Driver for Lakebase 2019J\lib
コピー先：C:\Boomi AtomSphere\Atom - 10.211.55.9\lib

コピーしたらBoomi Atom をブラウザからリスタート(Restart Atom)してください。作成したon-Premise Atom deployment のInstalledLibraries にJDBCの.jar ファイルが表示されれば成功です。

Lakebase のConnectionの作成

Boomi Atom からLakebase のデータソースに接続するためのConnection を作成します。

Welcom 画面の「Component > Connetion」を選択するとCreate Component ウィザードが開きます。
Lakebase への接続用のConnection 設定として以下の値をセットします。
- Type: Connection
- Component Name: ConnectionCDataLakebase
- Folder: 任意のパス
- Connector: Database

そしてJDBC Driver の接続設定を行います。
Databricks Lakebase に接続するには、以下のプロパティを設定します。
- DatabricksInstance: Databricks インスタンスまたはサーバーホスト名を指定します。形式は instance-abcdef12-3456-7890-abcd-abcdef123456.database.cloud.databricks.com です。
- Server: Lakebase データベースをホストするサーバーのホスト名または IP アドレスを指定します。
- Port（オプション）: Lakebase データベースをホストするサーバーのポート番号を指定します。デフォルトは 5432 です。
- Database（オプション）: Lakebase サーバーへの認証後に接続するデータベースを指定します。デフォルトでは認証ユーザーのデフォルトデータベースに接続します。
OAuth クライアント認証

OAuth クライアント資格情報を使用して認証するには、サービスプリンシパルで OAuth クライアントを構成します。手順の概要は以下のとおりです。
1. 新しいサービスプリンシパルを作成・構成する
2. サービスプリンシパルに権限を割り当てる
3. サービスプリンシパル用の OAuth シークレットを作成する
詳細については、ヘルプドキュメントの「Setting Up OAuthClient Authentication」セクションをご参照ください。

OAuth PKCE 認証

PKCE（Proof Key for Code Exchange）を使用した OAuth code タイプで認証するには、以下のプロパティを設定します。
- AuthScheme: OAuthPKCE を指定します。
- User: 認証ユーザーのユーザー ID を指定します。
詳細については、ヘルプドキュメントをご参照ください。
- Driver Type: Custom
- Class Name: cdata.jdbc.lakebase.LakebaseDriver
- User Name: 本来であれば不要ですが、空のままだと後の手順でバリデーションエラーが発生するので適当な値をセットします
- Password: 本来であれば不要ですが、空のままだと後の手順でバリデーションエラーが発生するので適当な値をセットします
- Connection URL: jdbc:lakebase:DatabricksInstance=lakebase;Server=127.0.0.1;Port=5432;Database=my_database;InitiateOAuth=GETANDREFRESH

Connection の値を設定したら接続テストを行います。右上のTest Connection ボタンをクリックします。実行するAtom を選択する画面が表示されるので、上記手順で作成したon-Premise Atom deployment を選択します。
テスト接続が成功することを確認してFinish ボタンでウィザードを閉じます。
作成した Lakebase のデータへの接続Connection を保存（Save）します。