Gestión de entornos de Lakebase para aplicaciones fuera de la plataforma

Al finalizar, tendrás:

• Todos los valores de conexión de Lakebase obtenidos desde la CLI de Databricks
• Un módulo de validación de entorno basado en Zod que falla de inmediato ante variables faltantes o inválidas
• Compatibilidad tanto con autenticación por token (desarrollo local) como con OAuth M2M (producción)
• Un archivo .env.example que documenta todas las variables requeridas para tu equipo y para CI

Prerequisites

Este template recopila las variables de entorno necesarias para acceder a Lakebase desde una aplicación que se ejecuta fuera de Databricks App Platform. Verifica que estas funcionalidades del workspace de Databricks estén habilitadas antes de comenzar.

• Lakebase Postgres disponible. Ejecuta databricks postgres list-projects --profile <PROFILE> y confirma que el comando se ejecute correctamente. Un error not enabled indica que Lakebase no está disponible para esta identidad.
• Un project de Lakebase aprovisionado. Completa primero el template Create a Lakebase Project. De su branch, endpoint y base de datos obtendrás los valores de conexión.
• OAuth de máquina a máquina para producción (opcional). Si planeas ejecutar en producción con un service principal, ten listos los valores DATABRICKS_CLIENT_ID / DATABRICKS_CLIENT_SECRET de ese service principal. Para el desarrollo local, basta con un token del workspace obtenido con databricks auth token --profile <PROFILE>.