Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Utiliser l'éditeur de bloc-notes Athena
Vous gérez vos blocs-notes dans l'explorateur de blocs-notes Athena et vous les modifiez et les exécutez dans des sessions à l'aide de l'éditeur de blocs-notes Athena. Vous pouvez configurer DPU l'utilisation de vos sessions de bloc-notes en fonction de vos besoins.
Lorsque vous arrêtez un bloc-notes, vous terminez la session associée. Tous les fichiers sont sauvegardés, mais les changements en cours dans les variables, fonctions et classes déclarées sont perdus. Lorsque vous redémarrez le bloc-notes, Athena recharge les fichiers du bloc-notes et vous pouvez réexécuter votre code.
L'éditeur de bloc-notes Athena est un environnement interactif permettant d'écrire et d'exécuter du code. Les sections suivantes décrivent les caractéristiques de l'environnement.
Comprenez les sessions et les calculs du bloc-notes
Chaque bloc-notes est associé à un seul noyau Python et exécute du code Python. Un bloc-notes peut contenir une ou plusieurs cellules contenant des commandes. Pour exécuter les cellules d'un bloc-notes, vous devez d'abord créer une session pour le bloc-notes. Les sessions permettent de suivre les variables et l'état des blocs-notes.
L'exécution d'une cellule dans un bloc-notes signifie exécuter un calcul dans la session en cours. Les calculs font progresser l'état du bloc-notes et peuvent effectuer des tâches telles que la lecture depuis Amazon S3 ou l'écriture dans d'autres magasins de données. Tant qu'une session est en cours d'exécution, les calculs utilisent et modifient l'état conservé pour le bloc-notes.
Lorsque vous n'avez plus besoin de l'état, vous pouvez mettre fin à la session. Lorsque vous mettez fin à une session, le bloc-notes est conservé, mais les variables et autres informations d'état sont détruites. Si vous devez travailler sur plusieurs projets en même temps, vous pouvez créer une session pour chaque projet, et les sessions seront indépendantes les unes des autres.
Les sessions disposent d'une capacité de calcul dédiée, mesurée enDPU. Lorsque vous créez une session, vous pouvez lui attribuer un numéro deDPUs. Les différentes sessions peuvent avoir des capacités différentes en fonction des exigences de la tâche.
Basculer entre le mode commande et le mode édition
L'éditeur de bloc-notes possède une interface utilisateur modale : un mode édition pour saisir du texte dans une cellule, et un mode commande pour envoyer des commandes à l'éditeur lui-même, comme copier, coller ou exécuter.
Pour utiliser le mode édition et le mode commande, vous pouvez effectuer les tâches suivantes :
-
Pour passer en mode édition, appuyez sur
ENTER
ou choisissez une cellule. Lorsqu'une cellule est en mode édition, elle présente une marge gauche verte. -
Pour passer en mode commande, appuyez sur
ESC
ou cliquez à l'extérieur d'une cellule. Notez que les commandes s'appliquent généralement uniquement à la cellule actuellement sélectionnée, et non à toutes les cellules. Lorsque l'éditeur est en mode commande, la cellule présente une marge gauche bleue. -
En mode commande, vous pouvez utiliser les raccourcis clavier et le menu situé au-dessus de l'éditeur, mais vous ne pouvez pas saisir de texte dans des cellules individuelles.
-
Pour sélectionner une cellule, choisissez-la.
-
Pour sélectionner toutes les cellules, appuyez sur
Ctrl+A
(Windows) ou surCmd+A
(Mac).
Utiliser les actions dans le menu de l'éditeur de bloc-notes
Les icônes du menu situé en haut de l'éditeur de bloc-notes offrent les options suivantes :
-
Enregistrer – Permet d'enregistrer l'état actuel du bloc-notes.
-
Insérer une cellule en dessous – Permet d'ajouter une nouvelle cellule (vide) en dessous de la cellule actuellement sélectionnée.
-
Couper les cellules sélectionnées – Permet de supprimer la cellule sélectionnée de son emplacement actuel et de la copier dans la mémoire.
-
Copier les cellules sélectionnées – Permet de copier la cellule sélectionnée dans la mémoire.
-
Coller les cellules en dessous – Permet de coller la cellule copiée en dessous de la cellule actuelle.
-
Déplacer les cellules sélectionnées vers le haut – Permet de déplacer la cellule actuelle au-dessus de la cellule située au-dessus.
-
Déplacer les cellules sélectionnées vers le bas – Permet de déplacer la cellule actuelle sous la cellule située en dessous.
-
Exécuter – Permet d'exécuter la cellule actuelle (sélectionnée). La sortie s'affiche immédiatement sous la cellule actuelle.
-
Tout exécuter – Permet d'exécuter toutes les cellules du bloc-notes. Le résultat de chaque cellule s'affiche immédiatement sous la cellule.
-
Stop (Interrompre le noyau) – Permet d'arrêter le bloc-notes actuel en interrompant le noyau.
-
Option de format – Permet de sélectionner le format de cellule, qui peut être l'un des suivants :
-
Code – À utiliser pour le code Python (par défaut).
-
Markdown — À utiliser pour saisir du texte au format Markdown de GitHub style -style
. Pour afficher le format Markdown, exécutez la cellule. -
Raw NBConvert — À utiliser pour saisir du texte sous une forme non modifiée. Les cellules marquées comme brutes NBConvert peuvent être converties dans un format différent, comme HTML par le biais de l'outil de ligne de commande Jupyter nbconvert
.
-
-
Titre – Permet de modifier le niveau de titre de la cellule.
-
Palette de commandes – Contient les commandes du bloc-notes Jupyter et leurs raccourcis clavier. Pour plus d'informations sur les raccourcis clavier, voir les rubriques suivantes du présent document.
-
Session – Utilisez les options de ce menu pour afficher les détails d'une session, modifier les paramètres de session ou mettre fin à la session.
Utilisez les raccourcis clavier du mode commande pour améliorer la productivité
Voici quelques raccourcis clavier courants du mode commande de l'éditeur de bloc-notes. Ces raccourcis sont disponibles après avoir appuyé sur ESC
pour passer en mode commande. Pour consulter la liste complète des commandes disponibles dans l'éditeur, appuyez sur ESC +
H
.
Clé | Action |
---|---|
1 - 6 |
Passer le type de cellule au format Markdown et définir le niveau de titre au numéro saisi |
a |
Créer une cellule au-dessus de la cellule actuelle |
b |
Créer une cellule en dessous de la cellule actuelle |
c |
Copier la cellule actuelle dans la mémoire |
d d |
Supprimer la cellule actuelle |
h |
Afficher l'écran d'aide des raccourcis clavier |
j |
Descendre d'une cellule |
k |
Monter d'une cellule |
m |
Changer le format actuel des cellules en format Markdown |
r |
Changer le format actuel des cellules en format brut |
s |
Enregistrer le bloc-notes |
v |
Coller le contenu de la mémoire sous la cellule actuelle |
x |
Couper la ou les cellules sélectionnées |
y |
Changer le format de la cellule en code |
z |
Annuler |
Ctrl+Enter |
Exécuter la cellule actuelle et passer en mode commande |
Shift+Enter ou Alt+Enter |
Exécuter la cellule actuelle et créer une nouvelle cellule sous la sortie, puis passer la nouvelle cellule en mode édition |
Space |
Page avant |
Shift+Space |
Page arrière |
Shift + L |
Activer ou désactiver la visibilité des numéros de ligne dans les cellules |
Personnaliser les raccourcis du mode commande
L'éditeur de bloc-notes dispose d'une option permettant de personnaliser les raccourcis clavier du mode commande.
Modifier les raccourcis clavier du mode commande
-
Dans le menu de l'éditeur de bloc-notes, choisissez la palette de commandes.
-
Dans la palette de commandes, choisissez la commande Edit command mode keyboard shortcuts (Modifier les raccourcis clavier du mode de commande).
-
Utilisez l'interface Edit command mode shortcuts (Modifier les raccourcis clavier du mode de commande) pour mapper ou remapper les commandes que vous souhaitez sur le clavier.
Pour voir les instructions de modification des raccourcis clavier du mode commande, faites défiler jusqu'au bas de l'écran Edit command mode shortcuts (Modifier les raccourcis clavier du mode de commande).
Pour plus d'informations sur l'utilisation des commandes magiques dans Athena pour Apache Spark, consultez Utilisez des commandes magiques.