Partager via

Déboguer des notebooks

  • 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 le débogueur

Procédez de la manière suivante pour activer le débogueur :

  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ébogage

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. Démarrez la session de débogage à l’aide de l’une des options suivantes :

    • Cliquez sur Exécuter > Déboguer la cellule.
    • Utilisez le raccourci clavier Option + 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.

Actions de débogage

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].

Console de débogage

Lorsque vous démarrez une session de débogage, la console de débogage apparaît automatiquement dans le panneau inférieur. Cette console vous permet d’exécuter du code Python pour inspecter ou manipuler des variables lorsqu’elles sont suspendues à un point d’arrêt. Le code exécuté dans le notebook principal ne s’exécute pas pendant une session de débogage. Pour exécuter le code dans la console, appuyez sur Entrée. Pour les expressions multilignes, utilisez Maj + Entrée pour passer à une nouvelle ligne.

debug_console

Remarque

  • La console de débogage est conçue pour des évaluations rapides et expire si l’exécution du code dépasse 15 secondes.
  • La commande display n’est pas prise en charge dans la console de débogage. Pour afficher des exemples de données depuis un DataFrame, utilisez df.show() pour les DataFrames PySpark ou df.head() pour les DataFrames Pandas.

Explorateur de variables

Vous pouvez utiliser le panneau de l’explorateur de variables l’icône d’explorateur de variables sur le côté droit pour afficher les valeurs de vos variables. Cliquer sur Inspecter exécute automatiquement le code dans la console de débogage pour générer la valeur de votre variable.

Exemple de panneau d’explorateur de variables

Pour filtrer l’affichage, entrez du texte dans la zone de recherche. La liste est automatiquement filtrée à mesure que vous tapez.

Pour Python sur Databricks Runtime 12.2 LTS et versions ultérieures, les variables sont mises à jour au fur et à mesure de l'exécution d'une cellule. Pour Scala, R et pour Python sur Databricks Runtime 11.3 LTS et versions antérieures, les variables sont mises à jour une fois l'exécution d'une cellule terminée.

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. La session de débogage se termine également automatiquement après 30 minutes si l’utilisateur n’utilise pas la barre d’outils de débogage ou la console de débogage.

Déboguer avec l’Assistant Databricks

L’Assistant Databricks est un assistant IA prenant en charge le contexte qui peut vous aider à déboguer votre code. Consultez Utiliser l’Assistant Databricks dans une cellule de notebook pour plus d’informations.

Limites

Pour plus d’informations, consultez limitations connues des notebooks Databricks.