よくある質問

インテグレーション

AppKit ではどの Databricks サービスを利用できますか？

AppKit はプラグインシステムを通じて、以下の Databricks サービスとの組み込み統合を提供します。

Plugin	Databricks サービス	機能
Analytics	SQL Warehouses	パラメータ化された SQL queries を実行。キャッシュ、リトライ、Arrow サポートを内蔵
Lakebase	Lakebase Autoscaling (PostgreSQL)	標準の pg.Pool を利用したリレーショナルデータベースアクセス。OAuth token の自動リフレッシュ付き
Genie	AI/BI Genie Spaces	自然言語によるデータ queries。会話管理とストリーミングに対応
Files	Unity Catalog Volumes	複数ボリュームにまたがるファイル操作 (一覧、読み取り、アップロード、ダウンロード、削除、プレビュー)
Model Serving	Model Serving	Model Serving endpoint への認証済みプロキシ。invoke とストリーミングに対応
Server	N/A	静的ファイル配信、Vite 開発モード、プラグインルート注入に対応した Express HTTP サーバー

統合は今後も継続的に拡充していきます。新しいプラグインにご期待ください。

カスタム統合を追加できますか？

はい。AppKit のプラグインアーキテクチャは拡張可能で、CLI (npx appkit plugin create) または手動でカスタムプラグインを作成できます。詳細はカスタムプラグインの作成ガイドを参照してください。

認証

AppKit appでの認証はどのように機能しますか?

AppKit appはDatabricks Apps上で動作するように設計されており、ユーザーの認証と認可はDatabricks Appsが処理します。Databricks Appsはリクエストヘッダー経由でユーザーIDをアプリに転送し、AppKitは.asUser(req)パターンでこれと連携して代理実行 (OBO) を行います。これにより、プラグインは認証済みユーザーの代理として動作できます。

Databricks Appsにおける認証と認可の仕組みの詳細については、公式の認証ドキュメントを参照してください。

データベース

別名: Lakebase、PostgreSQL、OLTP

AppKit はデータベースをどのように扱いますか？

AppKit は TypeScript SDK (Express + React) であり、データベースを直接管理することはありません。

データベースのサポートを追加するには、Lakebase Autoscaling と連携する Lakebase プラグインを使用してください。

また AppKit は、Lakebase が利用可能な場合はキャッシュにも Lakebase を使用します (後述のキャッシュセクションを参照) 。

Lakebase Autoscaling の project と branch は、Databricks CLI でインストールした Databricks エージェントスキルの専用エージェントスキルで管理できます。

AppKit ではデータベースのセットアップと権限管理はどのように行われますか？

AppKit app には Lakebase Autoscaling インスタンスをアタッチできます。デフォルトではデータベースは同梱されていないため、Lakebase プラグインを設定して追加します。databricks apps init の実行時に Lakebase プラグインを選択すると、選択したデータベースはデプロイ後に自動的にアプリのリソースとしてアタッチされます。

AI 支援開発を利用すれば、Agent に Lakebase の project と branch の作成を依頼することもできます。

デプロイされた Databricks app は、スキーマとテーブルの作成に自身のサービスプリンシパルを使用します。Lakebase Autoscaling の project をアプリのリソースとして設定すると、接続と作成に必要な権限がアプリのサービスプリンシパルに自動的に付与されます。

AppKit は Lakebase Provisioned をサポートしていますか？

いいえ。AppKit がサポートするのは Lakebase Autoscaling のみです。Lakebase Provisioned のデータベースは、Lakebase プラグインや Databricks エージェントスキルの Lakebase エージェントスキルではサポートされていません。

キャッシュ

AppKit はキャッシュをサポートしていますか？

はい。Databricks SQL Warehouse に対して SQL クエリを実行するための Analytics プラグインは、オプションのキャッシュ層をサポートしています。

キャッシュはプラグインごとに設定し、設定内容に応じて Lakebase Autoscaling またはインメモリストアのいずれかを利用できます。

Lakebase Autoscaling の接続を設定した場合、AppKit ベースのアプリは指定されたデータベースに appkit スキーマを作成し、キャッシュに必要な内部テーブルを配置します。