RapidMiner からLakebase のデータに連携

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

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

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

1. Lakebase 用の新しいデータベースドライバーを追加します。［Connections］->［Manage Database Drivers］とクリックします。
2. 表示されるウィザードで［Add］ボタンをクリックし、接続に名前を入力します。
3. JDBC URL のプレフィックスを入力します。

   jdbc:lakebase:
   

4. インストールディレクトリのlib サブフォルダにあるcdata.jdbc.lakebase.jar ファイルにパスを入力して下さい。
5. ドライバークラスを入力します。

   cdata.jdbc.lakebase.LakebaseDriver
   

   
6. 新しいLakebase 接続を作成します。［Connections］->［Manage Database Connections］とクリックします。
7. 接続の名前を入力します。
8. データベースシステムの場合は、以前構成したLakebase ドライバーを選択します。
9. Host ボックスで接続文字列を入力します。

   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 を指定します。

   詳細については、ヘルプドキュメントをご参照ください。

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

   JDBC URL の構成については、Lakebase JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

   java -jar cdata.jdbc.lakebase.jar
   

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   

   以下は一般的な接続文字列です。

   DatabricksInstance=lakebase;Server=127.0.0.1;Port=5432;Database=my_database;
   

10. 必要であればユーザー名とパスワードを入力します。

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

最後に、［Retrieve］プロセスから結果に出力をワイヤリングし、プロセスを実行してLakebase を確認します。