Interface et contrôles du notebook Databricks

Découvrez comment utiliser la barre d’outils et les menus du notebook Databricks pour contrôler les paramètres d’affichage des notebooks et des cellules.

Cellules du notebook

Les notebooks comportent une collection de deux types de cellules : les cellules de code et les cellules Markdown. Les cellules de code contiennent du code exécutable, tandis que les cellules Markdown contiennent du code Markdown qui affiche du texte et des graphiques. Markdown peut être utilisé pour documenter ou illustrer votre code. Vous pouvez ajouter ou supprimer des cellules à votre notebook pour structurer votre travail.

Vous pouvez exécuter une seule cellule, un groupe de cellules ou exécuter le notebook entier en même temps. Une cellule de notebook peut contenir au maximum 10 Mo et sa sortie est limitée à 20 Mo.

Icônes et boutons de la barre d’outils Notebook

La barre d’outils inclut des menus et des icônes que vous pouvez utiliser pour gérer et modifier le notebook.

En regard du nom du notebook se trouvent des boutons qui vous permettent de modifier la langue par défaut du notebook et, si le notebook est inclus dans un dossier Git Databricks, ouvrez la boîte de dialogue Git.

Pour afficher les versions précédentes du notebook, cliquez sur le message « Dernière modification... » à droite des menus.

Les icônes et boutons situés à droite de la barre d’outils sont présentés dans le tableau suivant :

Icône	Description
	Exécutez toutes les cellules ou arrêtez l’exécution. Le nom de ce bouton change en fonction de l’état du notebook.
	Ouvrez le sélecteur de calcul. Lorsque le notebook est connecté à un cluster ou à un entrepôt SQL, ce bouton affiche le nom de la ressource de calcul.
	Ouvrir planificateur de travaux.
	Ouvrir Delta Live Tables. Ce bouton s’affiche uniquement si le notebook fait partie d’un pipeline Delta Live Tables.
	Ouvrez le dialogue de permissions.

Actions de la barre latérale droite

Plusieurs actions sont disponibles dans la barre latérale droite du notebook, comme décrit dans le tableau suivant :

Icône	Description
	Ouvrez commentaires notebook.
	Ouvrez expérience notebook MLflow.
	Ouvrez l’historique des versions du notebook.
	Ouvrir Explorateur de variables. (Disponible pour les variables Python avec Databricks Runtime 12.2 LTS et versions ultérieures.)
	Ouvrez le panneau de l’environnement Python. Ce panneau affiche toutes les bibliothèques Python disponibles pour le notebook, notamment les bibliothèques étendues au notebook, les bibliothèques de cluster et les bibliothèques incluses dans Databricks Runtime. Disponible uniquement lorsque le notebook est attaché à un cluster.

Créer des cellules

Les notebooks disposent de deux types de cellules : les cellules de code et les cellules Markdown. Le contenu des cellules Markdown est rendu au format HTML. Par exemple, cet extrait de code contient un balisage pour un titre de niveau un :

%md ### Libraries
Import the necessary libraries.

S’affiche comme suit :

Pour créer une cellule, survolez une cellule en haut ou en bas. Cliquez sur Code ou Texte pour respectivement créer un code ou une cellule Markdown.

Actions de cellule

Le menu Actions de la cellule vous permet d’exécuter, de couper et de copier des cellules, de déplacer des cellules dans le notebook et de masquer le code ou les résultats.

Exécuter une cellule

Pour exécuter des cellules de code, cliquez sur la flèche pointant vers le bas dans le coin supérieur gauche de la cellule de code.

Une fois une cellule exécutée, un avis s’affiche à droite du menu d’exécution de la cellule, montrant la dernière exécution de la cellule et sa durée. Placez le curseur sur l’avis pour en savoir plus.

Pour afficher les informations d’exécution détaillées par défaut, cliquez sur votre image de profil en haut à droite. Cliquez ensuite sur Paramètres>Développeur>Afficher les informations détaillées sur l’exécution de commandes.

Si vous avez une sortie sous forme de résultat tabulaire, vous pouvez également accéder à ces informations en plaçant le pointeur sur la section « Dernière actualisation » de l’interface utilisateur.

Icônes de cellule

La capture d’écran suivante décrit les icônes qui s’affichent en haut à droite d’une cellule du notebook :

Sélecteur de langage : sélectionnez le langage de la cellule.

Assistant Databricks : activez ou désactivez l’Assistant Databricks pour les suggestions de code dans la cellule.

Focus sur la cellule : agrandissez la cellule pour en faciliter la modification.

Afficher le menu Actions de la cellule : ouvrez le menu Actions de la cellule. Les options de ce menu sont légèrement différentes pour les cellules de code et Markdown.

Supprimer une cellule

Pour supprimer une cellule, cliquez sur l’icône de la corbeille à droite de la cellule. Cette icône s’affiche uniquement lorsque vous pointez votre curseur sur la cellule.

Déplacer une cellule

Pour déplacer une cellule vers le haut ou le bas, cliquez et maintenez l’icône de la poignée de déplacement à gauche de la cellule.

Vous pouvez également sélectionner Déplacer vers le haut ou Déplacer vers le bas dans le menu Actions de la cellule.

Couper, copier et coller des cellules

Il existe plusieurs options pour couper et copier des cellules. Toutefois, si vous utilisez le navigateur Safari, seuls les raccourcis clavier sont disponibles.

• Dans le menu Actions de cellule, sélectionnez Couper la cellule ou Copier la cellule.
• Utilisez les raccourcis clavier : Command-X ou Ctrl-X pour couper, et Command-C ou Ctrl-C pour copier.
• Utilisez le menu Modifier situé en haut du notebook. Sélectionnez Couper ou Copier.

Après avoir coupé ou copié des cellules, vous pouvez coller ces cellules ailleurs dans le notebook, dans un autre notebook ou dans un notebook présent dans un autre onglet ou une autre fenêtre de navigateur. Pour coller des cellules, utilisez le raccourci clavier Command-V ou Ctrl-V. Les cellules sont collées sous la cellule active.

Pour annuler les actions couper ou coller, vous pouvez utiliser le raccourci clavier Command-Z, Ctrl-Z ou les options de menu Modifier > Annuler l’action couper les cellules ou Modifier > Annuler l’action coller les cellules.

Pour sélectionner les cellules adjacentes, cliquez dans une cellule Markdown, puis utilisez Déplacer + Vers le haut ou Vers le bas pour sélectionner les cellules situées au-dessus ou en dessous. Utilisez le menu d’édition pour copier, couper, coller ou supprimer les cellules sélectionnées en tant que groupe. Pour sélectionner toutes les cellules, sélectionnez Modifier > Sélectionner toutes les cellules ou utilisez le raccourci du mode de commande Cmd+A.

Ouvrir l’assistant Databricks

Pour ouvrir une zone de texte de l’Assistant Databricks dans une cellule, cliquez sur l’icône de l’Assistant Databricks dans le coin supérieur droit de la cellule.

Vous pouvez l’utiliser dans une cellule de code pour obtenir de l’aide ou des suggestions pour votre code. L’assistant Databricks doit être activé dans votre espace de travail.

Ajouter des commentaires de code

Pour ajouter un commentaire au code d’une cellule, mettez en surbrillance le code. À droite de la cellule, une icône de commentaire s’affiche. Cliquez sur l’icône pour ouvrir la zone de commentaire.

Ajouter une cellule à un tableau de bord

Pour ajouter une cellule Markdown ou une cellule avec des résultats tabulaires à un tableau de bord, sélectionnez Ajouter au tableau de bord dans le menu Actions de la cellule. Pour plus d’informations, consultez Tableaux de bord dans Notebook.

Lien vers une cellule

Pour obtenir un lien d’URL vers une commande spécifique dans votre notebook, cliquez sur pour ouvrir le mode Focus et copiez l’URL depuis la barre d’adresses du navigateur. Pour quitter le mode Focus, cliquez sur .

Table des matières du bloc-notes

Pour afficher une table des matières générée automatiquement, cliquez sur l’icône située en haut à gauche du notebook (entre la barre latérale gauche et la cellule supérieure). La table des matières est générée à partir des en-têtes Markdown utilisés dans le notebook. Les cellules avec des titres apparaissent également dans la table des matières.

Ajouter un titre de cellule

Pour ajouter un titre à une cellule, effectuez l’une des actions suivantes :

• Cliquez sur le numéro de cellule au centre de la cellule en haut de la cellule et tapez le titre.
• Sélectionnez Ajouter un titre dans le menu Actions de cellule.

Les cellules avec des titres apparaissent dans la table des matières du notebook.

Titres des cellules promues

Les utilisateurs peuvent activer Afficher les titres des cellules promues pour rendre les titres de cellule de notebook plus visibles dans l’interface utilisateur.

1. Dans le coin supérieur droit d’une page, cliquez sur votre photo de profil, puis sur Paramètres.
2. Cliquez sur Développeur> et activez Afficher les titres des cellules promues.

Masquer et afficher le contenu de la cellule

Le contenu de la cellule est constitué d’un code de cellule et des résultats de l’exécution de la cellule. Pour masquer le code de la cellule ou les résultats, cliquez sur le menu kebab en haut à droite de la cellule, puis sélectionnez Masquer le code ou Masquer le résultat.

Vous pouvez également sélectionner Réduire la cellule pour afficher uniquement la première ligne d’une cellule. Pour développer une cellule réduite, sélectionnez Développer la cellule.

Pour afficher les cellules masquées, cliquez sur l’icône d’affichage : .

Titres réductibles

Les cellules qui apparaissent après les cellules contenant des en-têtes Markdown maintenant être réduites dans la cellule d’en-tête. Dans le notebook, pour développer ou réduire des cellules, après des cellules contenant des titres Markdown, sélectionnez Réduire tous les titres depuis le menu Affichage. Le reste de cette section décrit comment développer ou réduire un sous-ensemble de cellules.

Développer et réduire les titres

L’image montre un titre de niveau deux Configuration Mlflow avec les deux cellules suivantes qui y sont réduites.

Pour développer et réduire les titres, placez le curseur sur la cellule Markdown. Cliquez sur la flèche apparaissant à gauche de la cellule.

Options d’affichage des cellules

Il existe trois options d’affichage pour les notebooks. Utilisez le menu Affichage pour modifier l’option d’affichage.

• Vue standard : les résultats s’affichent immédiatement après les cellules de code.
• Résultats uniquement : seuls les résultats sont affichés.
• Côte-à-côte : le code et les cellules de résultats sont affichés côte à côte.

Les actions sont disponibles à partir d’icônes à la marge de la cellule (la zone à droite et à gauche de la cellule). Par exemple, utilisez les points d’accroche pour déplacer une cellule vers le haut ou vers le bas dans la marge gauche. Pour supprimer une cellule, utilisez l’icône de la corbeille dans la marge droite.

Pour faciliter la modification, cliquez sur l’icône du mode focus afin d’afficher la cellule à pleine largeur. Pour quitter le mode Focus, cliquez sur . Vous pouvez également agrandir la largeur affichée d’une cellule en désactivant Affichage > Disposition centrée.

Pour mettre automatiquement en forme toutes les cellules du notebook sur les longueurs et des espacements de ligne standard, sélectionnez Modifier Mettre en forme un notebook>.

Supprimer les marges de cellule

Vous pouvez développer ou réduire les marges en cliquant sur Afficher > Disposition du notebook dans le menu du notebook.

Numéros de ligne et de commande

Pour afficher ou masquer les numéros de ligne ou les numéros de commande, sélectionnez Numéros de ligne ou Numéros de commande dans le menu Affichage. Pour les numéros de ligne, vous pouvez également utiliser le raccourci clavier Control + L. Lorsqu’une cellule est dans un état d’erreur, les numéros de ligne sont affichés indépendamment de la sélection.

Si vous activez les numéros de ligne ou de commande, Databricks enregistre votre préférence et les affiche dans tous les autres notebooks pour ce navigateur.

Afficher les notebook en mode sombre

Vous pouvez choisir d’afficher les notebooks en mode sombre. Pour activer ou désactiver le mode sombre, sélectionnez Affichage > Thème et sélectionnez Thème clair ou Thème sombre.

Si vous activez les numéros de ligne ou de commande, Databricks enregistre votre préférence et les affiche dans les autres notebooks pour ce navigateur.

Parcourir des données

Important

Cette fonctionnalité est disponible en préversion publique.

Pour explorer les tables et les volumes pouvant être utilisés dans le notebook, cliquez sur à gauche du notebook pour ouvrir le navigateur de schémas. Consultez Parcourir des données pour plus d’informations.

Ressources de calcul pour les notebooks

Cette section décrit les options pour les ressources de calcul de notebook. Vous pouvez exécuter un notebook sur un cluster Databricks ou, pour les commandes SQL, vous pouvez utiliser un entrepôt SQL, un type de calcul optimisé pour l’analytique SQL.

Calcul serverless pour les notebooks

Le calcul serverless vous permet de vous connecter rapidement votre notebook à des ressources informatiques à la demande.

Pour effectuer un attachement au calcul serverless, cliquez sur le menu déroulant Se connecter dans le notebook, puis sélectionnez Serverless.

Pour plus d’informations, consultez Calcul serverless pour les notebooks.

Attacher un notebook à votre cluster

Pour attacher un notebook à un cluster, vous devez disposer de l’autorisation PEUT JOINDRE À au niveau du cluster.

Important

Tant qu’un notebook est attaché à un cluster, tout utilisateur disposant de l’autorisation PEUT EXÉCUTER sur le Notebook a des autorisations implicites pour accéder au cluster.

Pour attacher un notebook à un cluster, cliquez sur le sélecteur de cluster dans la barre d’outils du notebook et sélectionnez un cluster dans le menu déroulant.

Le menu affiche une sélection de clusters que vous avez utilisés récemment ou qui sont actuellement en cours d’exécution.

Pour sélectionner parmi tous les clusters disponibles, cliquez sur Plus.... Cliquez sur le nom du cluster pour afficher un menu déroulant, puis sélectionnez un cluster existant.

Vous pouvez également créer un nouveau cluster en sélectionnant Créer une nouvelle ressource... dans le menu déroulant.

Important

Les variables Apache Spark suivantes sont définies pour un notebook attaché.

Classe	Nom de la variable
SparkContext	sc
SQLContext/HiveContext	sqlContext
SparkSession (Spark 2.x)	spark

Ne créez pas de SparkSession, SparkContext ou SQLContext. Cela entraînera un comportement incohérent.

Utiliser un notebook avec un entrepôt SQL

Lorsqu’un notebook est attaché à un entrepôt SQL, vous pouvez exécuter des cellules SQL et Markdown. L’exécution d’une cellule dans n’importe quel autre langage (comme Python ou R) génère une erreur. Les cellules SQL exécutées sur un entrepôt SQL apparaissent dans l’historique des requêtes de l’entrepôt SQL. L’utilisateur qui a exécuté une requête peut afficher le profil de requête à partir du notebook en cliquant sur la durée écoulée en bas de la sortie.

L’exécution d’un notebook nécessite un entrepôt SQL Pro ou Serverless. Vous devez avoir accès à l’espace de travail et à l’entrepôt SQL.

Pour attacher un notebook à un entrepôt SQL, procédez comme suit :

1. Cliquez sur le sélecteur de calcul dans la barre d’outils du notebook. Le menu déroulant affiche les ressources de calcul en cours d’exécution ou que vous avez utilisées récemment. Les entrepôts SQL sont marqués de l’.

2. Dans le menu, sélectionnez un entrepôt SQL.

   Pour afficher tous les entrepôts SQL disponibles, sélectionnez Plus... dans le menu déroulant. Une boîte de dialogue indique les ressources de calcul disponibles pour le notebook. Sélectionnez Entrepôt SQL, choisissez l’entrepôt que vous souhaitez utiliser, puis cliquez sur Joindre.

   

Vous pouvez également sélectionner un entrepôt SQL comme ressource de calcul, pour un notebook SQL, à la création d’un workflow ou d’un travail planifié.

Limitations de SQL Warehouse

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

Détacher un notebook

Pour détacher un notebook d’une ressource de calcul, cliquez sur le sélecteur de calcul dans la barre d’outils du notebook et survolez le cluster ou l’entrepôt SQL attaché dans la liste pour afficher un menu latéral. Depuis le menu latéral, sélectionnez Détacher.

Vous pouvez également détacher des notebooks d’un cluster à l’aide de l’onglet Notebooks de la page de détails du cluster.

Lorsque vous détachez un notebook, le contexte d’exécution est supprimé et toutes les valeurs des variables calculées sont effacées du notebook.

Conseil

Azure Databricks vous recommande de détacher des notebooks inutilisés des clusters. Cela libère de l’espace mémoire sur le pilote.

Utiliser le terminal web et l’interface CLI Databricks

Pour ouvrir le terminal web dans un notebook, cliquez sur en bas de la barre latérale droite.

Utiliser l’interface CLI Databricks dans un terminal web

À compter de Databricks Runtime 15.0, vous pouvez utiliser l’interface CLI Databricks à partir du terminal web dans le notebook.

Spécifications

• Le notebook doit être attaché à un cluster en mode d’accès Un seul utilisateur ou Aucun isolement partagé.
• L’interface CLI n’est pas disponible dans les espaces de travail activés pour Private Link.

L’interface CLI installée est toujours la dernière version. L’authentification est basée sur l’utilisateur actuel.

Vous ne pouvez pas utiliser l’interface CLI à partir d’une cellule de notebook. Dans un notebook, les commandes comme %sh databricks ... ne fonctionnent pas avec Databricks Runtime 15.0 ou version ultérieure.