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

Lakebase データベースインスタンスを Databricks Apps リソースとして追加して、デプロイ間でデータを保持します。これらのPostgreSQLでバックアップされたリソースを使用すると、アプリは状態を保持するスキーマとテーブルを作成および管理できます。

備考

プレビュー

Lakebaseデータベースインスタンスはパブリックプレビュー段階です。それらをアプリリソースとして追加する前に、ワークスペース管理者がそれらを有効にする必要があります。

データベースリソースの追加

Lakebaseデータベースインスタンスをアプリリソースとして追加する前に、前提条件を満たしていることを確認してください。

「Databricksアプリにリソースを追加する」の手順に従って、データベースリソースを追加します。

データベース・リソースを追加すると、次のようになります。

Databricks は、選択したデータベースインスタンスに PostgreSQL ロールを作成します。ロール名は、サービスプリンシパルのクライアント ID と一致します。ロールが既に存在する場合、Databricks はそれを再利用します。
Databricks、選択したデータベースに対する権限とCONNECT``CREATE権限をサービスプリンシパルに付与します。これらの権限により、アプリはデータベースにスキーマとテーブルを作成できます。

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

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

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

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

あなたの権限	データベースインスタンスでの役割	結果
`CAN MANAGE`	Yes	Databricks は、サービスプリンシパルが所有するすべてのオブジェクトを再割り当てし、サービスプリンシパルの役割を削除します。
`CAN MANAGE`	No	Databricks は、ロールを作成し、サービスプリンシパルのロールが所有するすべてのオブジェクトを再割り当てし、サービスプリンシパルのロールを削除します。
No `CAN MANAGE`	N/A	Databricks はリソースを削除しますが、ロールの削除や所有権の再割り当ては行いません。UI に警告が表示され、後でロールと所有オブジェクトを手動でクリーンアップする必要があります。

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

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