Appsmith で Lakebase 連携アプリケーションを作成
Appsmith は、チームがビジネスオペレーションを改善するためのUI を素早く簡単に構築できる、オープンソースの内部ツールビルダーです。CData Connect AI と組み合わせることで、ビジネスアプリケーションから Lakebase のデータ に即座にアクセスできるようになります。この記事では、Connect AI を使用して Lakebase に接続し、Appsmith で Lakebase のデータ から基本的なアプリケーションを作成するプロセスを説明します。
CData Connect AI は、Lakebase への純粋なSQL Server のクラウドtoクラウドインターフェースを提供し、Appsmith 内からライブ Lakebase のデータ を直接使用してビジネスアプリケーションを作成できます。ネイティブデータベースへのデータレプリケーションは必要ありません。アプリケーションを構築する際、Appsmith はデータを収集するためのSQL クエリを生成します。CData Connect AI は、最適化されたデータ処理機能により、フィルタやJOIN を含むすべてのサポートされるSQL オペレーションを Lakebase に直接送信します。これにより、サーバーサイドの処理を活用して、リクエストされた Lakebase のデータ を迅速に取得できます。
Appsmith 用に Lakebase への接続を構成
Appsmith から Lakebase への接続は、CData Connect AI を介して行います。Appsmith から Lakebase のデータ を操作するには、まず Lakebase 接続を作成して構成します。
- Connect AI にログインし、Sources をクリックして、 Add Connection をクリックします
- Add Connection パネルから「Lakebase」を選択します
-
Lakebase に接続するために必要な認証プロパティを入力します。
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 クライアントを構成します。手順の概要は以下のとおりです。
- 新しいサービスプリンシパルを作成・構成する
- サービスプリンシパルに権限を割り当てる
- サービスプリンシパル用の OAuth シークレットを作成する
詳細については、ヘルプドキュメントの「Setting Up OAuthClient Authentication」セクションをご参照ください。
OAuth PKCE 認証
PKCE(Proof Key for Code Exchange)を使用した OAuth code タイプで認証するには、以下のプロパティを設定します。
- AuthScheme: OAuthPKCE を指定します。
- User: 認証ユーザーのユーザー ID を指定します。
詳細については、ヘルプドキュメントをご参照ください。
- Save & Test をクリックします
-
Add Lakebase Connection ページのPermissions タブに移動し、User-based permissions を更新します。
パーソナルアクセストークンの追加
REST API、OData API、またはVirtual SQL Server を介してConnect AI に接続する場合、パーソナルアクセストークン(PAT)を使用してConnect AI への接続を認証します。アクセスの粒度を維持するために、サービスごとに個別のPAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン()をクリックして、設定ページを開きます。
- 設定ページで、Access Tokens セクションに移動し、 Create PAT をクリックします。
-
PAT に名前を付けて、Create をクリックします。
- パーソナルアクセストークンは作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。
接続が構成され、PAT が生成されたので、Appsmith から Lakebase のデータ に接続する準備が整いました。
ライブ Lakebase のデータ からAppsmith アプリケーションを作成
Appsmith からCData Connect AI Virtual SQL Server への接続を確立するには、以下の手順に従います。
Appsmith で Lakebase に接続
- Appsmith インスタンスにログインし、新しいアプリケーションを作成します。
-
新しいアプリケーションで、Data ページを開き、Bring your data を選択します。
-
このページで、Microsoft SQL Server を検索し、データソースとして選択します。
-
新しいデータソースの名前を入力し、以下の接続設定を入力します。
- Host address: tds.cdata.com
- Port: 14333
- Database name: 接続するCData Connect AI データソースの接続名を入力します(例:Lakebase1)。
- Username: CData Connect AI のユーザー名を入力します。これはCData Connect AI インターフェースの右上に表示されます。例:[email protected]。
- Password: 先ほど生成したPAT を入力します。
- Test configuration をクリックして接続が成功したことを確認し、Save をクリックしてデータソースを保存します。
新しいクエリを作成
データソースへの接続を構成したら、SQL クエリを追加してデータソースから実際にデータを取得します。
-
新しいデータソースの画面で、New Query をクリックします。
-
クエリエディタが開き、データを選択するSQL クエリを入力できます。SQL クエリの指定については、CData Connect AI のExplorer を使用して、SQL クエリと取得するデータをプレビューできます。
-
SQL クエリを作成したら、Appsmith のクエリエディタに戻り、SQL クエリを入力してRun をクリックします。
- クエリが正常に実行されたら、あとは取得したデータを表示するためのページをセットアップするだけです。
Lakebase のデータ を表示
-
UI タブを開き、New UI element をクリックします。
-
新しいUI 要素を選択し、ページ上にドラッグアンドドロップします。
-
新しいUI 要素でConnect data をクリックし、先ほど作成したクエリを選択します。
-
データが接続されると、UI 要素にデータが表示されます。
アプリケーションをデプロイ
Lakebase のデータ がアプリケーションのUI 要素に接続されたら、アプリケーションをデプロイできます。Appsmith の右上にあるDeploy をクリックすると、Lakebase のデータ を表示するアプリケーションが別ウィンドウで開きます。
CData Connect AI の入手
クラウドアプリケーションから300以上のSaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを実現するには、CData Connect AI をお試しください。