Adición de un recurso de Lakebase a una aplicación de Databricks

Agregue instancias de base de datos de Lakebase como recursos de Databricks Apps para conservar los datos entre implementaciones. Estos recursos respaldados por PostgreSQL permiten a la aplicación crear y administrar esquemas y tablas que conservan el estado.

Importante

Las instancias de base de datos de Lakebase se encuentran en versión preliminar pública. El administrador del área de trabajo debe habilitarlos para poder agregarlos como un recurso de aplicación.

Adición de un recurso de base de datos

Antes de agregar una instancia de base de datos de Lakebase como recurso, revise los requisitos previos del recurso de la aplicación.

1. Al crear o editar una aplicación, vaya al paso Configurar .
2. En la sección Recursos de la aplicación, haga clic en + Agregar recurso.
3. Seleccione Base de datos como tipo de recurso.
4. Elija una instancia de base de datos.
5. Elija una base de datos dentro de esa instancia.
6. Seleccione el nivel de permisos adecuado para la aplicación. Actualmente, el único permiso disponible es Puede conectarse y crear.
7. (Opcional) Especifique una clave de recurso personalizada, que es la forma en que hace referencia a la base de datos en la configuración de la aplicación. La clave predeterminada es database.

Al agregar un recurso de base de datos:

• Azure Databricks crea un rol de PostgreSQL en la instancia de base de datos seleccionada. El nombre del rol coincide con el identificador de cliente del principal del servicio. Si el rol ya existe, Azure Databricks lo reutiliza.
• Azure Databricks concede a la entidad de servicio CONNECT y CREATE privilegios en la base de datos seleccionada. Estos privilegios permiten a la aplicación crear esquemas y tablas en la base de datos.

Variables de entorno

Al implementar una aplicación con un recurso de base de datos, Azure Databricks establece las siguientes variables de entorno para el primer recurso de base de datos.

Si la aplicación usa varias bases de datos, estas variables solo reflejan la primera. Use valueFrom con la clave de recurso para recuperar el nombre de host de la base de datos. Consulte Uso de variables de entorno para acceder a los recursos.

Variable	Descripción
PGAPPNAME	Nombre de la aplicación
PGDATABASE	Nombre de la base de datos
PGHOST	Nombre de host del servidor postgreSQL
PGPORT	Puerto para el servidor postgreSQL
PGSSLMODE	Modo SSL para la conexión
PGUSER	Identificador de cliente y nombre de rol del principal del servicio

Eliminación de un recurso de base de datos

Si quita recursos de base de datos de una aplicación, la aplicación intenta reasignar todos los objetos propiedad de la entidad de servicio al usuario que quita el recurso.

La lógica que usa la aplicación depende principalmente de si tiene un rol en la instancia de base de datos:

Sus permisos	¿Rol en la instancia de base de datos?	Resultado
CAN MANAGE	Sí	Azure Databricks reasigna todos los objetos que pertenecen a la entidad de servicio y elimina el rol de la entidad de servicio.
CAN MANAGE	No	Azure Databricks crea un rol para usted, le reasigna todos los objetos propiedad del rol de la entidad de servicio y elimina el rol de la entidad de servicio.
No CAN MANAGE	No disponible	Azure Databricks quita el recurso, pero no elimina el rol ni reasigna la propiedad. Aparece una advertencia en la interfaz de usuario y debe limpiar manualmente el rol y los objetos de propiedad más adelante.

Notas

Tenga en cuenta lo siguiente al agregar bases de datos como recursos de aplicación:

• Si revoca CONNECT y CREATE desde una misma base de datos y los concede en otra en la misma actualización, Azure Databricks actualiza los privilegios, pero no vuelve a crear el rol de la entidad de servicio.
• Las bases de datos conservan el estado. Los esquemas o tablas creados por una aplicación permanecen incluso después de volver a implementar o detener la aplicación.