Preguntas frecuentes
Preguntas frecuentes
Integraciones
¿Qué servicios de Databricks están disponibles a través de AppKit?
AppKit ofrece integraciones nativas con los siguientes servicios de Databricks mediante su sistema de plugins:
| Plugin | Servicio de Databricks | Qué hace |
|---|---|---|
| Analytics | SQL Warehouses | Ejecuta queries SQL parametrizadas con caché, reintentos y soporte de Arrow integrados |
| Lakebase | Lakebase Autoscaling (PostgreSQL) | Acceso a bases de datos relacionales mediante pg.Pool estándar con renovación automática del token OAuth |
| Genie | AI/BI Genie Spaces | Queries de datos en lenguaje natural con gestión de conversaciones y streaming |
| Files | Volúmenes de Unity Catalog | Operaciones de archivos en múltiples volúmenes (listar, leer, subir, descargar, eliminar, previsualizar) |
| Model Serving | Model Serving | Proxy autenticado hacia endpoints de Model Serving con soporte de invocación y streaming |
| Server | N/D | Servidor HTTP Express con servicio de archivos estáticos, modo de desarrollo de Vite e inyección de rutas de plugins |
¡Atento a los nuevos plugins: ampliamos las integraciones constantemente!
¿Puedo agregar integraciones personalizadas?
Sí. La arquitectura de plugins de AppKit es extensible: puedes crear plugins personalizados con la CLI (npx appkit plugin create) o de forma manual. Consulta la guía para crear plugins personalizados.
Autenticación
¿Cómo funciona la autenticación en las AppKit apps?
Las AppKit apps están diseñadas para ejecutarse en Databricks Apps, que se encarga de la autenticación y la autorización de los usuarios. Databricks Apps reenvía la identidad del usuario a la app mediante encabezados de solicitud, y AppKit se integra con este mecanismo a través del patrón .asUser(req) para la ejecución en nombre del usuario (OBO), lo que permite que los plugins actúen en nombre del usuario autenticado.
Para conocer en detalle cómo funcionan la autenticación y la autorización en Databricks Apps, consulta la documentación oficial de autenticación.
Bases de datos
También: Lakebase, PostgreSQL, OLTP
¿Cómo gestiona AppKit las bases de datos?
AppKit es un SDK de TypeScript (Express + React) y no administra bases de datos directamente.
Para añadir compatibilidad con bases de datos, usa el plugin de Lakebase, que se integra con Lakebase Autoscaling.
AppKit también usa Lakebase para el almacenamiento en caché cuando está disponible (consulta la sección almacenamiento en caché más abajo).
Puedes administrar los projects y branches de Lakebase Autoscaling con la agent skill dedicada de Databricks Agent Skills, que se instala con la Databricks CLI.
¿Cómo funcionan la configuración de la base de datos y la gestión de permisos en AppKit?
Las AppKit apps pueden tener asociada una instancia de Lakebase Autoscaling. De forma predeterminada no se incluye ninguna base de datos: para agregar una, configura el plugin de Lakebase. Al ejecutar databricks apps init y seleccionar el plugin de Lakebase, la base de datos elegida se adjunta automáticamente como recurso de la app tras el deployment.
Con el desarrollo asistido por IA, también puedes pedirle al Agent que cree un project y un branch de Lakebase por ti.
Una vez desplegada, una Databricks app usa su Service Principal para crear esquemas y tablas. Si configuras el project de Lakebase Autoscaling como recurso de la app, los permisos de conexión y creación necesarios se otorgan automáticamente al Service Principal de la app.
¿AppKit es compatible con Lakebase Provisioned?
No. AppKit solo admite Lakebase Autoscaling. Las bases de datos Lakebase Provisioned no son compatibles con el plugin de Lakebase ni con la agent skill de Lakebase de Databricks Agent Skills.
Almacenamiento en caché
¿AppKit admite almacenamiento en caché?
Sí. El Analytics plugin, que se usa para ejecutar queries SQL en SQL Warehouses de Databricks, admite una capa de caché opcional.
La caché se configura por plugin y puede usar Lakebase Autoscaling o un almacén en memoria, según la configuración.
Si la conexión de Lakebase Autoscaling está configurada, la app basada en AppKit crea un esquema appkit en la base de datos configurada, con las tablas internas necesarias para la caché.