Databricks アプリに Lakebase リソースを追加する

デプロイ全体でデータを保持するために、Databricks Apps リソースとして Lakebase データベースを追加します。これらの PostgreSQL に基づくリソースを使用すると、状態を保持するスキーマとテーブルをアプリで作成および管理できます。

次の種類の Lakebase データベースリソースを使用できます。

どちらの種類も同じ PostgreSQL 接続モデルを使用し、同じ環境変数をアプリに提供します。

データベースリソースを追加する

リソースとして Lakebase データベースを追加する前に、アプリリソースの前提条件を確認します。

アプリリソースとして追加するには、Lakebase プロジェクトに対する CAN MANAGE アクセス許可が必要です。

注

2026 年 3 月 12 日以降、新しいプロビジョニング済みデータベースを作成することはできませんが、既存のデータベースをアプリリソースとして追加することはできます。既定での自動スケールを参照してください。

データベースリソースを追加する場合:

Azure Databricks は、選択したデータベースに PostgreSQL ロールを作成します。ロール名は、サービスプリンシパルのクライアント ID と一致します。ロールが既に存在する場合、Azure Databricks はそれを再利用します。
Azure Databricks は、選択したデータベースに対するサービスプリンシパルの CONNECT と CREATE 特権を付与します。これらの権限を使用すると、アプリはデータベースにスキーマとテーブルを作成できます。
Lakebase 自動スケールの場合、リソースを追加するユーザーには、プロジェクトに対する CAN MANAGE アクセス許可が必要です。

データベースリソースを使用してアプリをデプロイすると、Azure Databricks は最初のデータベースリソースに対して次の環境変数を設定します。

アプリで複数の PostgreSQL データベースが使用されている場合、これらの変数は最初のデータベースのみを反映します。リソースキーと valueFrom を使用して、データベースの接続の詳細を取得します。「環境変数を使用してリソースにアクセスする」を参照してください。

アプリからデータベースリソースを削除すると、アプリはサービスプリンシパルが所有するすべてのオブジェクトをリソースの削除ユーザーに再割り当てしようとします。

アプリが主に使用するロジックは、データベースにロールがあるかどうかによって異なります。

アクセス許可	データベースの役割	結果
`CAN MANAGE`	イエス	Azure Databricks は、サービスプリンシパルが所有するすべてのオブジェクトを再割り当てし、サービスプリンシパルのロールを削除します。
`CAN MANAGE`	いいえ	サービスプリンシパルのロールによって所有されているすべてのオブジェクトがあなたに再割り当てされ、サービスプリンシパルのロールが削除されるとともに、Azure Databricks によってあなたのためのロールが作成されます。
いいえ `CAN MANAGE`	なし	Azure Databricks はリソースを削除しますが、ロールを削除したり、所有権を再割り当てしたりすることはありません。 UI に警告が表示され、後でロールと所有オブジェクトを手動でクリーンアップする必要があります。

アプリリソースとしてデータベースを追加する場合は、次の点を考慮してください。

1 つのデータベースから CONNECT と CREATE を取り消し、同じ更新で別のデータベースに付与した場合、Azure Databricks は特権を更新しますが、サービスプリンシパルのロールは再作成しません。
データベースは状態を保持します。アプリによって作成されたスキーマまたはテーブルは、アプリを再デプロイまたは停止した後も残ります。

このページはお役に立ちましたか?