Architecture

AppKit repose sur une architecture modulaire à base de plugins, conçue pour créer des applications Databricks prêtes pour la production. Ce document offre une vue d'ensemble des composants du système et de leurs interactions.

Architecture générale

Composants principaux

AppKit s'organise en deux packages principaux :

@databricks/appkit

Le SDK backend qui fournit l'architecture de plugins et les fonctionnalités de base. Il comprend :

• Un système de plugins avec gestion du cycle de vie
• Les plugins server et Analytics intégrés
• Des fonctionnalités de télémétrie et d'observabilité
• La gestion du cache et les capacités de streaming
• La génération de types pour les requêtes SQL

Consultez la documentation Plugins et la Référence de l'API pour plus de détails.

@databricks/appkit-ui

Une bibliothèque d'interface React proposant des composants prêts à l'emploi, optimisés pour les applications de données :

• Hooks React pour l'exécution de requêtes et le streaming
• Composants d'interface basés sur Radix UI et Tailwind
• Composants de visualisation de données
• Intégration typée avec les requêtes du backend

Consultez la référence de l'API pour la documentation des composants.

Couches applicatives

Couche client

La couche frontend React, qui peut éventuellement utiliser les composants @databricks/appkit-ui :

• Affiche les composants d'interface et les visualisations
• Gère l'état côté client et les interactions utilisateur
• Consomme les API backend via HTTP et SSE
• Fournit des hooks d'exécution de requêtes typés

Couche serveur

La couche backend Node.js construite avec @databricks/appkit :

• Sert l'application React (modes développement et production)
• Exécute des requêtes SQL sur les SQL Warehouses Databricks
• Gère l'authentification et les autorisations
• Fournit la mise en cache, la logique de relance et la gestion des erreurs
• Expose des API REST et des endpoints SSE

Couche de données

Intégration avec les services Databricks :

• SQL Warehouses : exécution de requêtes analytiques au format Arrow ou JSON
• Lakebase Autoscaling : accès à la base de données OLTP avec actualisation automatique des tokens OAuth

Voir aussi

• Plugins : exploration détaillée du système de plugins
• Référence de l'API : documentation complète de l'API
• Développement : découvrez les flux de travail de développement
• Principes fondamentaux : découvrez la philosophie de conception d'AppKit