Arquitectura

AppKit sigue una arquitectura basada en plugins, diseñada para crear aplicaciones de Databricks listas para producción. Este documento ofrece una visión general de los componentes del sistema y de cómo interactúan entre sí.

Arquitectura de alto nivel

Componentes principales

AppKit se organiza en dos paquetes principales:

@databricks/appkit

El SDK de backend que proporciona la arquitectura de plugins y la funcionalidad principal. Incluye:

• Sistema de plugins con gestión del ciclo de vida
• Plugins integrados de servidor y de analítica
• Funciones de telemetría y observabilidad
• Gestión de caché y capacidades de streaming
• Generación de tipos para queries SQL

Consulta la documentación de Plugins y la referencia de la API para obtener información detallada.

@databricks/appkit-ui

Una biblioteca de UI en React con componentes prediseñados y optimizados para aplicaciones de datos:

• Hooks de React para la ejecución de queries y el streaming
• Componentes de UI basados en Radix UI y Tailwind
• Componentes de visualización de datos
• Integración con tipado seguro con las queries del backend

Consulta la referencia de la API para ver la documentación de los componentes.

Capas de la aplicación

Capa de cliente

La capa de frontend en React que, opcionalmente, usa componentes de @databricks/appkit-ui:

• Renderiza componentes de UI y visualizaciones
• Gestiona el estado del cliente y las interacciones del usuario
• Consume las API del backend mediante HTTP y SSE
• Proporciona hooks de ejecución de queries con seguridad de tipos

Capa de servidor

La capa de backend en Node.js creada con @databricks/appkit:

• Sirve la aplicación React (en modo desarrollo y producción)
• Ejecuta queries SQL en los SQL Warehouses de Databricks
• Gestiona la autenticación y la autorización
• Proporciona almacenamiento en caché, lógica de reintentos y manejo de errores
• Expone APIs REST y endpoints SSE

Capa de datos

Integración con los servicios de Databricks:

• SQL Warehouses: ejecuta queries analíticas en formato Arrow o JSON
• Lakebase Autoscaling: acceso a bases de datos OLTP con refresh automático del token OAuth

Véase también

• Plugins: Análisis a fondo del sistema de plugins
• Referencia de la API: Documentación completa de la API
• Desarrollo: Explora los flujos de trabajo de desarrollo
• Principios fundamentales: Conoce la filosofía de diseño de AppKit