Bien démarrer avec Databricks Apps

Cet article vous aide à bien démarrer avec Databricks Apps à l’aide d’un exemple pas à pas pour créer une application simple dans votre espace de travail Azure Databricks à l’aide d’un modèle qui suit les meilleures pratiques d’Azure Databricks.

Cet exemple vous guide tout au long des étapes suivantes :

• Création d’une application à partir d’un modèle
• Affichage de l’application après son déploiement
• Copie du modèle d’application sur votre ordinateur pour un développement plus approfondi
• Exécution locale de l’application
• Redéployer l’application dans votre espace de travail

À la fin de cet article, vous serez en mesure d’itérer sur votre application localement et de déployer des mises à jour sur Databricks.

Conditions préalables

Avant de suivre ce tutoriel, assurez-vous que votre espace de travail Azure Databricks et votre environnement de développement local sont configurés correctement. Consultez Configurer votre espace de travail Databricks Apps et votre environnement de développement.

Étape 1 : Installer les dépendances

Ouvrez un terminal et exécutez les commandes suivantes pour :

• Installez les bibliothèques Python requises par l’exemple d’application.
• Créez un répertoire local pour les fichiers source et de configuration de votre application.

pip install gradio
pip install pandas
mkdir gradio-hello-world
cd gradio-hello-world

gradio-hello-world est le répertoire local de vos fichiers d’application.

Étape 2 : Créer l’application

1. Dans votre espace de travail Databricks, cliquez sur + Nouvelle>application dans la barre latérale gauche.

2. Sous Installer à partir d’un modèle, accédez à l’onglet Gradio .

3. Choisissez le modèle Hello World .

   

4. Nommez l’application gradio-hello-world , puis cliquez sur Installer.

Cela crée une application basée sur le modèle sélectionné et la déploie dans votre espace de travail.

Étape 3 : Afficher l’application

Une fois que vous avez créé une application, elle démarre automatiquement et affiche une URL que vous pouvez utiliser pour l’afficher en préversion. Affichez l’URL de l’application et l’état du déploiement sur la page Vue d’ensemble :

Cliquez sur l’URL pour afficher l’application :

Étape 4 : Copier l’application sur votre ordinateur

Après avoir créé l’application, vous pouvez télécharger le code source sur votre ordinateur local pour le personnaliser.

1. Copiez la première commande sous Synchroniser les fichiers :

   

2. Dans un terminal, accédez au gradio-hello-world répertoire local que vous avez créé, puis exécutez la commande copiée sync .

   databricks workspace export-dir /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2025_06_09-18_38/gradio-hello-world-app .
   
   ...
   Export complete
   

   La commande copie deux nouveaux fichiers dans le répertoire nommé app.py et app.yaml. app.yaml définit la configuration de l’application, y compris son point d’entrée et ses autorisations. app.py contient le code qui implémente les fonctionnalités et l’interface utilisateur de l’application.

Étape 5 : Modifier et tester l’application localement

1. Vous pouvez éventuellement personnaliser et développer votre application localement. Par exemple, vous pouvez modifier app.py pour rendre les données interactives, ajouter un thème ou des options de style ou autoriser les chargements de données.

2. Pour tester votre application, exécutez python app.py:

   python app.py
   
   Running on local URL:  http://127.0.0.1:7860
   ...
   

3. Pour afficher l’application, saisissez http://127.0.0.1:7860 dans une fenêtre de navigateur.

4. Si vous le souhaitez, utilisez la commande databricks apps run-local pour exécuter et déboguer l’application :

   databricks apps run-local --prepare-environment --debug
   

   Cette commande installe toutes les dépendances et prépare l’environnement virtuel, puis démarre l’application et le débogueur sur le port 5678. Accédez à http://localhost:8001 pour voir l'application.

   Pour définir des points d’arrêt dans Visual Studio Code, installez l’extension du débogueur Python, puis accédez à Exécuter>Démarrer le débogage>Attacher à distance.

Étape 6 : Redéployer l’application sur votre espace de travail

Pour redéployer l’application, copiez la commande sous Déployer sur Databricks Apps sur la page de détails de l’application :

Exécutez la commande à partir du gradio-hello-world répertoire local.

La commande réussit avec :

{
  "create_time": "2025-06-09T19:36:50Z",
  "creator": "my-email@org.com",
  "deployment_artifacts": {
    "source_code_path": "/Workspace/Users/1234abcd-5678-90ab-cdef-123456abcdef/src/abcd1234efgh5678ijkl9012mnop3456"
  },
  "deployment_id": "abcd1234efgh5678ijkl9012mnop3456",
  "mode": "SNAPSHOT",
  "source_code_path": "/Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2025_06_09-18_38/gradio-hello-world-app",
  "status": {
    "message": "App started successfully",
    "state": "SUCCEEDED"
  },
  "update_time": "2025-06-09T19:36:51Z"
}

Pour afficher l’état du déploiement, accédez à la page Vue d’ensemble de l’application.

Étapes suivantes

Maintenant que vous avez déployé et personnalisé votre première application, vous pouvez :

• Configurez l’autorisation pour gérer les personnes pouvant accéder à votre application et les modifier.
• Intégrez votre application à des fonctionnalités de plateforme Azure Databricks comme les secrets Azure Databricks ou Databricks SQL.
• Partagez votre application avec d’autres utilisateurs dans votre espace de travail ou au sein de votre organisation.
• Explorez d’autres modèles d’application pour expérimenter différentes infrastructures et fonctionnalités.