Vue d'ensemble
Qu'est-ce que Databricks Apps ?
Databricks Apps héberge votre application web directement dans votre workspace. Celle-ci bénéficie d'une URL fixe, d'une authentification OAuth intégrée et d'un accès direct aux données et services de votre workspace. Pas de service d'hébergement distinct, pas de couche d'authentification à développer, pas de rotation d'identifiants à gérer.
AppKit est le SDK TypeScript qui permet de créer ces applications. Il fournit des composants d'interface React prêts à l'emploi, un accès aux données typé et un système de plugins pour se connecter aux services Databricks.
Fonctionnement
AppKit repose sur une architecture à trois couches, avec des plugins qui enregistrent des fonctionnalités à chaque niveau :
- Client : frontend React servi par Vite. Le package
@databricks/appkit-uifournit des tables de données, des graphiques, des boîtes de dialogue et des composants de mise en page. - Serveur : serveur HTTP Express avec l'authentification Databricks OAuth intégrée. Les plugins y rattachent des routes et des middlewares.
- Données : accès aux ressources Databricks via des plugins. Chaque plugin encapsule un type de ressource et expose une API typée sur l'objet
AppKit.
| Plugin | Ce qu'il apporte |
|---|---|
| server | Serveur HTTP Express, service de fichiers statiques, mode développement Vite (toujours inclus) |
| lakebase | Pool de connexions Postgres pour Lakebase Postgres avec actualisation automatique des jetons OAuth |
| analytics | Exécution de requêtes SQL sur les SQL warehouses Databricks. Voir Lectures analytiques. |
| genie | Intégration de Genie Agent pour interroger les données en langage naturel |
| serving | Proxy authentifié vers les endpoints Model Serving, avec prise en charge du streaming |
| files | Opérations sur les fichiers des volumes Unity Catalog |
| agents | Agents IA définis en markdown ou en code, avec découverte automatique des outils |
| ai-search | Recherche sémantique et vectorielle sur vos index AI Search |
| jobs | Déclenchement et suivi des Lakeflow Jobs Databricks |
| caching | Mise en cache des réponses au niveau global et par plugin, s'appuyant sur Lakebase Postgres lorsqu'il est disponible |
Pour consulter l'ensemble des plugins actuellement disponibles, voir la référence des plugins.
Fonctionnement de l'authentification
Chaque app dispose d'un service principal dédié. Databricks injecte ses identifiants au runtime, ce qui permet à votre app d'appeler les API du workspace sans avoir à gérer de jetons.
Par défaut, toutes les requêtes s'exécutent sous ce service principal, et tous les utilisateurs partagent ses permissions. Si vous avez besoin d'un accès aux données propre à chaque utilisateur, Databricks peut transmettre le jeton de l'utilisateur connecté via x-forwarded-access-token. Les plugins Genie et Model Serving intégrés à AppKit s'en chargent automatiquement.
Quand l'utiliser
Les apps sont avant tout affaire d'interactivité, pas seulement d'analytique. Un tableau de bord est idéal pour des vues en lecture seule avec des filtres prédéfinis. Une app fait la même chose, mais accepte en plus des saisies, exécute de la logique et conserve les résultats. Créez une app dès que votre flux de travail requiert l'un de ces éléments : par exemple un générateur de scénarios qui enregistre les cas créés par les utilisateurs, ou un outil interne remplaçant un processus manuel sur tableur.
Quand ne pas l'utiliser
- Sites statiques sans accès aux données Databricks. Hébergez-les où vous voulez.
- Applications publiques ou destinées aux clients. Par défaut, les utilisateurs doivent être des identités authentifiées dans votre compte Databricks (sans nécessairement appartenir au workspace de l'application). Pour un accès externe ou destiné aux clients, consultez App Users.
- Tableaux de bord purement en lecture seule déjà couverts par les Dashboards AI/BI. Utilisez un tableau de bord tant que vous n'avez pas besoin de conserver les saisies des utilisateurs ou d'y ajouter une logique personnalisée.
Et ensuite ?
Les modèles sont des prompts prêts à l'emploi pour les agents, organisés par cas d'usage. Trouvez celui qui correspond à votre besoin, ou consultez le Démarrage rapide Apps pour un guide pas à pas.