Parcourir le notebook Databricks et l’éditeur de fichiers

Cet article décrit les fonctions disponibles pour vous aider à naviguer dans le notebook Databricks et l’éditeur de fichiers, notamment les raccourcis clavier, les suggestions de code et la saisie semi-automatique, l’inspection des variables et le pliage de code. Lorsque vous utilisez le notebook ou l’éditeur de fichiers, l’Assistant Databricks est disponible pour vous aider à générer, à expliquer et à déboguer du code. Pour plus d'informations, consultez Obtenez de l'aide pour le codage auprès de l'Assistant Databricks.

Vous pouvez choisir parmi une sélection de thèmes de l’éditeur. Sélectionnez Afficher > Thème de l’éditeur et effectuez une sélection dans le menu.

Raccourcis clavier

Pour afficher les raccourcis clavier, sélectionnez Aide > raccourcis clavier. Les raccourcis clavier disponibles dépendent du fait que le curseur se trouve dans une cellule de code (mode édition) ou non (mode commande).

palette de commandes

Vous pouvez rapidement effectuer des actions dans le notebook à l’aide de la palette de commandes. Pour ouvrir un panneau d’actions de bloc-notes, cliquez sur en bas à droite de l’espace de travail ou utilisez le raccourci Cmd + Maj + P sur MacOS ou Ctrl + Maj + P sur Windows.

Rechercher et remplacer du texte

Pour rechercher et remplacer du texte dans un bloc-notes, sélectionnez Modifier > Rechercher et remplacer. La correspondance actuelle est mise en surbrillance en orange et toutes les autres correspondances sont mises en surbrillance en jaune.

Pour remplacer la correspondance actuelle, cliquez sur Remplacer. Pour remplacer toutes les correspondances dans le notebook, cliquez sur Remplacer tout.

Pour vous déplacer entre les correspondances, cliquez sur les boutons Précédent et Suivant. Vous pouvez également appuyer sur Maj + entrée et sur Entrée pour accéder aux correspondances précédentes et suivantes, respectivement.

Pour fermer l’outil rechercher et remplacer, cliquez sur ou appuyez sur échap.

Inspection des variables

Pour afficher des informations sur une variable définie dans un notebook Python ou SQL, placez le curseur sur le nom de la variable. L’inspection des variables Python nécessite Databricks Runtime 12.2 LTS ou version ultérieure.

Consultez Explorateur de variables.

Accéder à la définition

Lorsqu’un notebook Python est attaché à un cluster, vous pouvez rapidement accéder à la définition d’une variable, d’une fonction ou du code derrière une instruction %run. Pour ce faire, cliquez avec le bouton droit sur la variable ou le nom de la fonction, puis cliquez sur Accéder à la définition ou Faire un Peek de la Définition.

Maintenez enfoncée la touche Cmd sur macOS ou Ctrl sur Windows et pointez sur le nom de la variable ou de la fonction. Si une définition est trouvée, le nom se transforme en lien hypertexte.

La fonctionnalité Accéder à la définition est disponible dans Databricks Runtime 12.2 LTS et versions ultérieures.

Pliage de code

Le pliage du code vous permet de masquer temporairement des sections de code. Cela peut être utile lors de l’utilisation de blocs de code longs, car cela vous permet de vous concentrer sur des sections spécifiques du code sur lesquelles vous travaillez.

Pour masquer le code, placez votre curseur à l’extrême gauche d’une cellule. Les flèches pointant vers le bas s’affichent à des points logiques où vous pouvez masquer une section de code. Cliquez sur la flèche pour masquer une section de code. Cliquez à nouveau sur la flèche (pointant maintenant vers la droite) pour afficher le code.

Pour plus d’informations, notamment sur les raccourcis clavier, consultez la documentation de VS Code.

Prise en charge du multi-curseur

Vous pouvez créer plusieurs curseurs pour faciliter les modifications simultanées, comme illustré dans la vidéo :

Pour créer plusieurs curseurs dans une cellule :

• Sous macOS, maintenez la touche Option enfoncée et cliquez à chaque emplacement pour ajouter un curseur.
• Sous Windows, maintenez la touche Alt enfoncée et cliquez à chaque emplacement pour ajouter un curseur.
• Vous pouvez également modifier le raccourci. Consultez Modifier le raccourci pour la sélection multi-curseur et de la colonne.

Sur macOS, vous pouvez créer plusieurs curseurs alignés verticalement à l’aide du raccourci clavier Option+Command+ touche de direction haut ou bas.

Sélection de colonne (zone)

Pour sélectionner plusieurs éléments dans une colonne, cliquez en haut à gauche de la zone à capturer. Ensuite :

• Sous macOS, appuyez sur Shift + Option et faites glisser vers le coin inférieur droit pour capturer une ou plusieurs colonnes.
• Sous Windows, appuyez sur Shift + Alt et faites glisser vers le coin inférieur droit pour capturer une ou plusieurs colonnes.
• Vous pouvez également modifier le raccourci. Consultez Modifier le raccourci pour la sélection multi-curseur et de la colonne.

Modifier le raccourci pour la sélection multi-curseur et de la colonne

Un autre raccourci est disponible pour la sélection multi-curseur et colonne (zone). Avec l’autre sélection, les raccourcis changent comme suit :

• Pour créer plusieurs curseurs dans une cellule :
  • Sous macOS, maintenez la touche Cmd enfoncée et cliquez à chaque emplacement pour ajouter un curseur.
  • Sous Windows, maintenez la touche Ctrl enfoncée et cliquez à chaque emplacement pour ajouter un curseur.
• Pour sélectionner plusieurs éléments dans une colonne, cliquez en haut à gauche de la zone à capturer. Ensuite :
  • Sous macOS, appuyez sur Option et faites glisser vers le coin inférieur droit pour capturer une ou plusieurs colonnes.
  • Sous Windows, appuyez sur Alt et faites glisser vers le coin inférieur droit pour capturer une ou plusieurs colonnes.

Pour activer les autres raccourcis, procédez comme suit :

1. Cliquez sur votre nom d’utilisateur en haut à droite dans l’espace de travail, puis sur Paramètres dans la liste déroulante.
2. Dans la barre latérale des Paramètres, sélectionnez Développeur.
3. Dans la section Éditeur de code, changez le paramètre du modificateur de touche pour le clic multi-curseur à Cmd pour macOS ou Ctrl pour Windows.

Lorsque vous activez d’autres raccourcis, le raccourci clavier permettant de créer plusieurs curseurs alignés verticalement ne change pas.

Parcourir les données

Utilisez le navigateur de schéma pour explorer les objets catalogue Unity disponibles pour le bloc-notes. Cliquez sur l'icône de données du cahier située à la gauche du cahier pour ouvrir le navigateur de schéma.

Le bouton Pour vous affiche uniquement les objets que vous avez utilisés dans la session active ou précédemment marqués comme favoris.

Lorsque vous tapez du texte dans la zone Filtre, l’affichage change pour afficher uniquement les objets qui contiennent le texte que vous tapez. Seuls les objets actuellement ouverts ou ouverts dans la session active s’affichent. La zone Filtre ne recherche pas entièrement les catalogues, les schémas, les tables et les volumes disponibles pour le bloc-notes.

Pour ouvrir le menu Kebab , placez le curseur sur le nom de l’objet, comme indiqué :

Si l’objet est une table, vous pouvez effectuer les opérations suivantes :

• Créez et exécutez automatiquement une cellule pour afficher un aperçu des données dans le tableau. Sélectionnez Aperçu dans une nouvelle cellule à partir du menu kebab pour la table.
• Affichez un catalogue, un schéma ou une table dans l’Explorateur de catalogues. Sélectionnez Ouvrir dans Catalog Explorer à partir du menu kebab. Un nouvel onglet s’ouvre pour afficher l’objet sélectionné.
• Obtenez le chemin d’accès à un catalogue, un schéma ou une table. Sélectionnez Copier … chemin d’accès à partir du menu kebab de l’objet.
• Ajoutez un tableau aux Favoris. Sélectionnez Ajouter aux favoris à partir du menu kebab de la table.

Si l’objet est un catalogue, un schéma ou un volume, vous pouvez copier le chemin d’accès de l’objet ou l’ouvrir dans l’Explorateur de catalogues.

Pour insérer un nom de table ou de colonne directement dans une cellule :

1. Cliquez sur votre curseur dans la cellule à l’emplacement où vous souhaitez entrer le nom.
2. Déplacez votre curseur sur le nom de la table ou le nom de colonne dans le navigateur de schéma.
3. Cliquez sur la flèche double qui apparaît à droite du nom de l’objet.

Utiliser le terminal web et la CLI Databricks

Pour ouvrir le terminal web dans un bloc-notes, 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.

Exigences

• 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 bloc-notes. Dans un notebook, les commandes telles que %sh databricks ... ne fonctionnent pas avec Databricks Runtime 15.0 ou version ultérieure.

Saisie semi-automatique personnalisée

L’autocomplétion complète automatiquement des segments de code à mesure que vous les tapez. Les objets complets incluent des types, des classes et des objets, ainsi que des noms de base de données et de tableaux SQL. Databricks utilise vos métadonnées et l’utilisation de Unity Catalog pour personnaliser les suggestions.

• Pour les cellules Python, le notebook doit être attaché à un cluster pour que l’autocomplétion fonctionne, et vous devez exécuter toutes les cellules qui définissent des objets qui peuvent faire l’objet d’une autocomplétion.
• Pour les cellules SQL, l’autocomplétion suggère des mots clés et une syntaxe de base, même si le notebook n’est attaché à aucune ressource de calcul.
  • Si l’espace de travail est activé pour Unity Catalog, l’autocomplétion suggère également les noms de catalogues, de schémas, de tables et de colonnes pour les tables Unity Catalog.
  • Si l’espace de travail n’est pas activé pour Unity Catalog, le notebook doit être attaché à un cluster ou à un entrepôt SQL pour suggérer des noms de tables ou de colonnes.

Les suggestions d’autocomplétion s’affichent automatiquement lorsque vous tapez dans une cellule. Utilisez les touches de direction haut et bas ou votre souris pour sélectionner une suggestion, puis appuyez sur Tab ou Entrée pour insérer la sélection dans la cellule.

Notes

L’autocomplétion du serveur dans les notebooks R est bloquée pendant l’exécution de la commande.

Il existe deux paramètres utilisateur à prendre en compte :

• Pour désactiver les suggestions d’autocomplétion, activez l’Autocomplétion en cours de frappe. Lorsque l’autocomplétion est désactivée, vous pouvez afficher des suggestions d’autocomplétion en appuyant sur Ctrl + Espace.
• Pour empêcher la touche Entrée d’insérer des suggestions d’autocomplétion, activez la Ls touche Entrée accepte les suggestions d’autocomplétion.

Correspondance de crochets

Lorsque vous cliquez près d’une parenthèse, d’un crochet ou d’une accolade, l’éditeur met en évidence ce caractère et son crochet correspondant.

Mise en surbrillance d’erreur Python

Lorsqu’un ordinateur portable est connecté à un cluster, les erreurs de syntaxe sont soulignées en rouge. Pour Python, le cluster doit exécuter Databricks Runtime 12.2 LTS ou version ultérieure.

Placez le curseur sur l’avertissement de syntaxe et sélectionnez Correctif rapide pour afficher les actions possibles.

Les espaces de travail avec Assistant Databricks activé peuvent également sélectionner Corriger avec l’Assistant pour obtenir des suggestions assistées par l’IA.

Pour activer ou désactiver la mise en surbrillance des erreurs de syntaxe, procédez comme suit :

1. Cliquez sur votre nom d’utilisateur en haut à droite dans l’espace de travail, puis sur Paramètres dans la liste déroulante.
2. Dans la barre latérale des Paramètres, sélectionnez Développeur.
3. Dans la section Éditeur de code, activez ou désactivez le paramètre pour la mise en surbrillance de l’erreur de syntaxe SQL ou de l’erreur de syntaxe Python.

Mise en surbrillance de la mise en forme Python

Les erreurs et avertissements de mise en forme du code Python sont soulignés en jaune. Pointez sur les avertissements de syntaxe pour afficher plus d’informations. Le cluster doit exécuter Databricks Runtime 12.1 LTS ou version ultérieure.

Pour activer les erreurs de mise en forme et les avertissements :

1. Cliquez sur votre nom d’utilisateur en haut à droite dans l’espace de travail, puis sur 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 le paramètre pour erreur de format Python mettant en surbrillance.