Utiliser le débogueur interactif Databricks

  • Article

Important

Cette fonctionnalité est disponible en préversion publique.

Cette page explique comment utiliser le débogueur interactif intégré dans le notebook Databricks. Le débogueur est disponible uniquement pour Python.

Le débogueur interactif fournit des points d’arrêt, une exécution pas à pas, une inspection des variables et d’autres outils pour vous aider à développer du code dans des notebooks plus efficacement.

Spécifications

Votre notebook doit être attaché à un cluster qui répond aux exigences suivantes :

  • Databricks Runtime 13.3 LTS ou version ultérieure.
  • Le mode d’accès doit être Utilisateur unique (affecté) ou Aucune isolation partagée.

Activer ou désactiver le débogueur

Pour activer ou désactiver le débogueur, effectuez ces étapes :

  1. Cliquez sur votre nom d’utilisateur en haut à droite de l’espace de travail, puis sélectionnez Paramètres dans la liste déroulante.
  2. Dans la barre latérale des Paramètres, sélectionnez Développeur.
  3. Dans la section Fonctionnalités expérimentales, activez Débogueur interactif de notebook Python.

Démarrer le débogueur

Pour démarrer le débogueur, effectuez ces étapes :

  1. Ajoutez un ou plusieurs points d’arrêt en cliquant dans la marge d’une cellule. Pour supprimer un point d’arrêt, cliquez à nouveau dessus.

    créer et supprimer des points d’arrêt vidéo

  2. Effectuez l’une des opérations suivantes :

    • Cliquez sur Exécuter > Déboguer la cellule.
    • Utilisez le raccourci clavier Ctrl+Maj+D.
    • Dans le menu d’exécution de cellule, sélectionnez Déboguer la cellule.

    élément de débogage de la cellule dans le menu d’exécution de la cellule

Une session de débogage démarre automatiquement et exécute la cellule sélectionnée.

Vous pouvez également démarrer le débogueur si une cellule déclenche une erreur. En bas de la sortie de la cellule, cliquez sur Bouton Déboguer.

Lorsqu’une session de débogage est active, la barre d’outils de débogage Déboguer (barre d'outils) apparaît en haut de la cellule.

Utiliser le débogueur

barre d’outils du débogueur annoté

Dans une session de débogage, vous pouvez effectuer les opérations suivantes :

  • Définir ou supprimer des points d’arrêt.
  • Afficher les valeurs des variables à un point d’arrêt.
  • Examiner le code
  • Entrer dans une fonction ou en sortir.

Lorsque le code atteint un point d’arrêt, il s’arrête avant l’exécution de la ligne, et non après.

Utilisez les boutons de la barre d’outils du débogueur pour parcourir le code. Lorsque vous parcourez le code, la ligne active est mise en surbrillance dans la cellule. Vous pouvez afficher les valeurs des variables dans le volet Explorateur de variables dans la barre latérale droite.

Lorsque vous parcourez une fonction, les variables de fonction locales apparaissent dans le volet des variables, marquées [local].

Mettre fin à une session de débogueur

Pour mettre fin à la session de débogage, cliquez sur bouton d’arrêt du débogueur en haut à gauche de la cellule ou cliquez sur bouton d’arrêt du notebook en haut du notebook.

Limites

  • Le débogueur fonctionne uniquement avec Python. Il ne prend pas en charge Scala ou R.
  • Le débogueur ne fonctionne pas sur les clusters en mode d’accès partagé.
  • Le débogueur ne prend pas en charge les pas à pas détaillés dans des fichiers ou modules externes.
  • Lorsqu’une session de débogage est active, vous ne pouvez pas exécuter d’autres commandes dans le notebook.