11 Blocs-notes

Ce chapitre fournit des informations sur l'utilisation et la gestion des blocs-notes dans votre espace de travail.

Rubriques :

Développer du code dans les blocs-notes

Les ingénieurs de données et les data scientists peuvent utiliser les blocs-notes dans leur workbench Oracle AI Data Platform en tant qu'outil commun pour développer du code de manière interactive et explorer les données.

Oracle AI Data Platform Workbench prend actuellement en charge les langages Python, SQL et Scala dans les blocs-notes. Les blocs-notes peuvent être planifiés ou configurés pour s'exécuter dans le cadre d'un workflow. Pour exécuter des blocs-notes, vous devez attacher un cluster de calcul.

Votre workbench AI Data Platform est livré avec des blocs-notes gérés intégrés pour une expérience de développeur intuitive.

Vous pouvez utiliser l'exemple de code dans le référentiel Git Oracle AI Data Platform Workbench Samples pour obtenir des exemples de code que vous pouvez utiliser avec votre bloc-notes.

Sauvegarde automatique

Les blocs-notes sont automatiquement enregistrés toutes les deux minutes.

Import et export de blocs-notes

Vous pouvez actuellement importer un fichier de bloc-notes (*.ipynb) de votre ordinateur local vers votre espace de travail.

L'exportation des blocs-notes n'est pas prise en charge actuellement.

Créer un bloc-notes

Vous pouvez créer un bloc-notes dans n'importe quel espace de travail disposant des droits d'accès administrateur.

  1. Sur la page d'accueil, accédez à votre espace de travail.
  2. Cliquez sur Créer, puis sur Bloc-notes.
  3. Renseignez le nom et la Description, puis cliquez sur Créer.

Attachement d'un cluster existant à un bloc-notes

Les blocs-notes nécessitent un cluster connecté pour fournir une puissance de calcul pour le code développé.

  1. Sur la page d'accueil, accédez à votre espace de travail et ouvrez votre bloc-notes.
  2. Cliquez sur Actions, puis sur Attacher un cluster existant.
  3. Cliquez sur le cluster à utiliser dans la liste.
    Le bloc-notes affiche Cluster : (ClusterName) running lorsqu'il a été attaché. Cette opération peut prendre plusieurs minutes.

Création d'un cluster pour un bloc-notes

Vous pouvez créer un cluster directement à partir de l'interface de bloc-notes et l'attacher immédiatement.

Pour plus d'informations, reportez-vous à A propos des clusters Compute.
  1. Sur la page d'accueil, accédez à votre espace de travail et ouvrez votre bloc-notes.
  2. Cliquez sur Actions, puis sur Créer un cluster.
  3. Sélectionnez Version d'exécution.
  4. Sélectionnez les options de pilote pour votre cluster.
  5. Sélectionnez les options de processus actif pour votre cluster. Ces options s'appliquent à tous les processus actifs de cluster.
  6. Indiquez si le nombre de salariés est statique ou s'il est automatiquement mis à l'échelle.
    • Si Montant statique, indiquez le nombre de salariés.
    • Si Redimensionnement automatique, indiquez le nombre minimal et maximal de processus sur lesquels le cluster peut évoluer.
  7. Pour Durée d'exécution, indiquez si le cluster s'arrêtera après une durée d'inactivité définie. Si l'option Délai d'inactivité est sélectionnée, indiquez le temps d'inactivité, en minutes, avant le délai d'expiration du cluster.
  8. Cliquez sur Créer.

Langue par défaut

Vous pouvez utiliser des blocs-notes pour développer et exécuter du code Apache Spark en Python, SQL ou Scala.

Le langage par défaut pour les blocs-notes est Python. Vous pouvez modifier la langue par défaut pour l'ensemble du bloc-notes ou pour des cellules individuelles en SQL, Scala, Markdown ou texte brut. Vous pouvez combiner du code Python, SQL et Scala dans différentes cellules du même bloc-notes.

Les blocs-notes présentent une coloration syntaxique pour Python, SQL et Scala. De nouvelles cellules de bloc-notes seront créées en fonction de la langue par défaut du bloc-notes.

Gestion des blocs-notes

Vous pouvez renommer et supprimer vos propres blocs-notes. Vous pouvez également cloner des blocs-notes pour copier leur contenu et utiliser leur code dans un nouveau bloc-notes.

Vous renommez et supprimez vos blocs-notes à partir de leur menu d'actions dans votre espace de travail. Pour cloner votre bloc-notes, ouvrez-le et sélectionnez l'option Cloner dans le menu Fichier.

Renommer un bloc-notes

Si le nom de votre bloc-notes n'est plus utile ou pertinent, vous pouvez le modifier à tout moment.

  1. Sur la page d'accueil, accédez à votre espace de travail.
  2. En regard du bloc-notes à renommer, cliquez sur Actions, puis sur Renommer.
  3. Entrez un nouveau nom et cliquez sur Enregistrer.
  4. Facultatif : vous pouvez également modifier le nom d'un bloc-notes ouvert en cliquant sur son nom et en saisissant un nouveau.

Suppression d'un bloc-notes

Vous pouvez supprimer des blocs-notes pour lesquels vous disposez de droits d'administrateur.

  1. Accédez à votre espace de travail.
  2. En regard du bloc-notes à supprimer, cliquez sur Actions, puis sur Supprimer.
  3. Cliquez sur Supprimer.

Clonage d'un bloc-notes

Vous pouvez cloner un bloc-notes existant pour créer une copie du contenu de ce bloc-notes que vous pouvez modifier tout en conservant l'original.

  1. Ouvrez le bloc-notes à cloner.
  2. Dans la barre d'outils Bloc-notes, cliquez sur Fichier, puis sur Cloner.
  3. Entrez un nouveau nom pour le bloc-notes cloné.
  4. Cliquez sur Parcourir pour sélectionner le dossier d'espace de travail dans lequel enregistrer le bloc-notes cloné. Si aucun dossier n'est sélectionné, le bloc-notes cloné est créé dans le même dossier que le bloc-notes que vous clonez.
  5. Indiquez si les sorties doivent être incluses ou exclues. Par défaut, les sorties sont incluses. Effacez la sélection pour exclure les sorties.
  6. Cliquez sur Cloner. Le bloc-notes cloné est créé dans le dossier d'espace de travail que vous avez indiqué.

Parcourir les ressources lors de la modification du bloc-notes

Lorsque vous êtes dans un bloc-notes, vous pouvez parcourir le catalogue ou les objets d'espace de travail sur le côté gauche sans quitter votre bloc-notes.

Si vous faites glisser un objet du volet gauche vers le bloc-notes, le nom de l'objet ou le chemin complet est copié et collé dans la cellule du bloc-notes (selon le contexte).


Bloc-notes ouvert avec un objet glissé-déposé dans le bloc-notes

Vous disposez également d'un bouton et d'options de menu contextuel pour chaque objet de catalogue ou d'espace de travail dans le volet de gauche. Le menu contextuel de la navigation de gauche propose des options permettant de copier un exemple de code, un nom de copie ou un chemin de copie, et de les coller dans la cellule du bloc-notes.


Options du menu contextuel affichées dans le volet gauche d'un bloc-notes

Exécuter les blocs-notes

Vous pouvez exécuter du code dans les blocs-notes dont vous êtes propriétaire ou à partir de blocs-notes partagés avec vous.

Le code peut être exécuté à partir d'un bloc-notes à l'aide de trois méthodes : exécution à la demande, exécution ponctuelle manuelle ou création d'un travail de bloc-notes planifié. Les travaux exécutés à la demande ne sont exécutés qu'une seule fois.

Exécution de commandes de terminal dans un bloc-notes

Vous pouvez exécuter des commandes de terminal de base ou des commandes shell dans un bloc-notes en ajoutant le préfixe " !". Par exemple, vous pouvez utiliser la commande unzip pour extraire des fichiers ZIP dans l'espace de travail.


Exemple de commande unzip utilisée

Vous pouvez également utiliser le module subprocess en Python pour l'exécution de script shell.


Exemple de commande de sous-processus utilisée

Vous pouvez également utiliser des modules Python natifs tels que zipfile pour des tâches telles que la décompression de fichiers comme alternative aux commandes shell.

Limites

Actuellement, Oracle AI Data Platform Workbench ne prend pas en charge nativement les systèmes d'installation de pip, d'intégration continue et de déploiement continu, de Git ou de contrôle de version.

Options d'exécution pour les cellules de bloc-notes

Le menu Run dans les blocs-notes fournit des options permettant d'exécuter des cellules dans un bloc-notes.

<Saisir le titre de la section ici>

Vous pouvez trouver toutes les options d'exécution des cellules dans votre bloc-notes à partir du menu Exécuter en haut de votre bloc-notes.


Le menu Run d'un bloc-notes s'ouvre et affiche les options permettant d'exécuter des cellules dans un bloc-notes

Tableau 11-1 Options d'exécution pour les cellules de bloc-notes

Option Description
Tout exécuter Exécute toutes les cellules du bloc-notes de manière séquentielle.
Exécuter les cellules sélectionnées Exécute la ou les cellules actuellement sélectionnées.
Exécuter tout ce qui précède Exécute la cellule actuellement sélectionnée et toutes les cellules qui apparaissent au-dessus de la cellule actuellement sélectionnée dans le bloc-notes.
Exécuter tout en dessous Exécute la cellule actuellement sélectionnée et toutes les cellules qui apparaissent sous la cellule actuellement sélectionnée dans le bloc-notes.
Exécuter le texte choisi Exécute le segment de code sélectionné dans une cellule.
Accéder à la cellule de dernière exécution Permet d'accéder à la cellule la plus récemment exécutée du bloc-notes.
Effacer toutes les sorties de cellule Supprime les sorties de toutes les cellules du bloc-notes.

Exécuter le code à partir d'un bloc-notes

Vous pouvez choisir d'exécuter tout le code développé dans un bloc-notes à la fois, ou une cellule à la fois.

Les raccourcis clavier pour exécuter du code dans un bloc-notes sont les suivants :
  • MacOS : Cmd + Return
  • Windows : Ctrl + Entrée

Vous pouvez exécuter du code dans une seule cellule en cliquant sur le bouton Bouton de lecture de bloc-notes Lancer ou exécuter l'ensemble du bloc-notes en cliquant sur Tout exécuter.

  1. Sur la page d'accueil, cliquez sur Espace de travail.
  2. Accédez à votre bloc-notes.
  3. Cliquez sur Tout exécuter.
  4. Vérifiez le statut de l'exécution du travail de bloc-notes en cliquant sur Workflow, puis sur Exécutions de travail.

Exécuter le code à partir d'un autre bloc-notes

Vous pouvez utiliser la commande %run magic dans un bloc-notes pour inclure le code d'un autre bloc-notes.

Dans l'exemple suivant, vous apportez le code d'un bloc-notes nommé appelé-notebook.ipynb à un bloc-notes caller-notebook.ipynb.
  1. Installez la bibliothèque Python nbconvert.
  2. Utilisez la commande %run dans une cellule, comme dans l'exemple suivant :
    %run /Workspace/folder1/called-notebook.ipynb

Après avoir suivi ces étapes, le bloc-notes nommé appelé-notebook.ipynb est immédiatement exécuté à l'aide de votre principal utilisateur (c'est-à-dire caller-notebook.ipynb) et à l'aide du cluster joint de caller-notebook.ipynb. Toutes les fonctions et variables définies dans appelé-notebook.ipynb deviennent immédiatement disponibles dans le bloc-notes nommé caller-notebook.ipynb.

Partager la sortie du bloc-notes avec oidlUtils

Vous pouvez capturer et partager le contenu généré par vos tâches de bloc-notes à l'aide des utilitaires disponibles dans oidlUtils.

oidlUtils est un ensemble d'utilitaires disponibles pour tous les utilisateurs d'Oracle AI Data Platform Workbench. Lorsque vous partagez du contenu entre des blocs-notes, oidlUtils peut être appelé pour transmettre des arguments à un bloc-notes et transmettre la sortie au bloc-notes de l'appelant, et il peut être appelé dans une tâche de travail d'un bloc-notes pour transmettre la sortie à la tâche parent, c'est-à-dire la tâche qui appelle le bloc-notes. Vous pouvez ainsi capturer et utiliser la sortie structurée renvoyée par vos tâches de bloc-notes.

Les modules oidlUtils suivants sont disponibles avec les blocs-notes :

Module Description Exemple
carnet Orchestrez les exécutions de tâche de bloc-notes et renvoyez un résultat structuré unique (généralement une chaîne JSON) à l'appelant. 
oidlUtils.notebook.run(
    notebook_path: str,
    timeout_seconds: int = 0, (Optional)
    parameters: dict (Optional)
) -> str
carnet Autoriser un bloc-notes à quitter une exécution de tâche et à renvoyer un résultat de chaîne unique (généralement une charge utile JSON) au bloc-notes de l'appelant ou à l'API de sortie de tâche/travail. 
oidlUtils.notebook.exit(value: str)

Exemple 1 : partage entre bloc-notes et bloc-notes

Dans cet exemple, vous utilisez le bloc-notes A pour appeler le bloc-notes B. Le bloc-notes B renvoie une charge utile de résultat que le bloc-notes A est configuré pour capturer et utiliser.

Bloc-notes A

result = oidlUtils.notebook.run("NotebookB", 0)
print("Output from Notebook B:", result)
Bloc-notes B
import json

payload = {
"status": "SUCCESS",
"rows_processed": 1234,
"output_table": "sales_gold",
"run_id": "run_2026_02_11"
}

json_payload = json.dumps(payload)
oidlUtils.notebook.exit(str(json_payload))

Sortie du bloc-notes B

{"status": "SUCCESS", "rows_processed": 1234, "output_table": "sales_gold", "run_id": "run_2026_02_11"}

Exemple 2 : transmission de la sortie via des tâches de travail

Dans cet exemple, vous renvoyez un fichier JSON lorsque votre bloc-notes est exécuté en tant que tâche : oidlUtils.notebook.exit(json.dumps(payload)). 

import json

payload = {
    "status": "SUCCESS",
    "output_table": "sales_gold",
    "rows_processed": 1234
}

oidlUtils.notebook.exit(json.dumps(payload))

Ensuite, exécutez le travail avec votre tâche de bloc-notes et obtenez la sortie de la tâche via l'appel d'API : endpoint = f"https://<workspace-url>/jobs/runs/get-output?run_id={task_run_id}" and response = requests.get(endpoint, headers=headers).json(). 

import requests

task_run_id = "<task_run_id>"

endpoint = f"https://<workspace-url>/jobs/runs/get-output?run_id={task_run_id}"
response = requests.get(endpoint, headers=headers).json()

Enfin, vous capturez la sortie renvoyée par le bloc-notes avec job_result = response['notebook_output']['result']. 

job_result = response["notebook_output"]["result"]
payload = json.loads(job_result)

print(payload["output_table"])   # Output : sales_gold
print(payload["rows_processed"]) # Output : 1234

Navigation dans le bloc-notes

Vous pouvez créer et gérer une table des matières qui peut être utilisée pour organiser et naviguer dans votre bloc-notes.

Vous pouvez cliquer sur l'icône de la table des matières en haut à gauche de votre bloc-notes pour afficher un profil de bloc-notes. La table des matières est générée automatiquement en fonction des en-têtes de démarque que vous pouvez créer, ce qui facilite l'organisation et la navigation.

Vous pouvez ajouter du texte formaté, des en-têtes, des listes et de la documentation en tant que démarque pour organiser et expliquer le contenu du bloc-notes pour vous-même et d'autres utilisateurs.

Créer une cellule Markdown

Vous pouvez créer des cellules de démarque pour fournir des en-têtes dans la table des matières de votre bloc-notes pour faciliter l'organisation et la navigation.

  1. Sur la page d'accueil, accédez à votre bloc-notes.
  2. Dans la liste déroulante Type de cellule, sélectionnez Marque.
  3. Ajoutez votre Markdown à la cellule.
    • Les cellules de démarque peuvent inclure du texte formaté, des en-têtes, des listes et d'autres documents.
    • Pour créer un en-tête, commencez une ligne par #, suivie d'un espace. L'en-tête 1 utilise un #, l'en-tête 2 utilise ##. Ajoutez # pour chaque niveau d'en-tête supplémentaire.

Sortie et résultats du bloc-notes

Vous pouvez voir les sorties et les résultats du bloc-notes dans une nouvelle cellule qui apparaît juste après la cellule contenant du code.

Pendant qu'une cellule est en cours, vous pouvez annuler l'exécution de la cellule. Si un bloc-notes est exécuté en tant que travail de workflow, la sortie n'est pas visible dans le même bloc-notes. Dans ce cas, la sortie est visible dans la zone de sortie de l'exécution de travail de workflow correspondante.

Vous pouvez télécharger la sortie de la cellule de sortie sous forme de fichier CSV ou Excel. Vous pouvez également copier le contenu de la cellule de sortie directement dans le presse-papiers.


Cellule de sortie dans un bloc-notes affichée avec les boutons Copier et Télécharger mis en surbrillance. Le menu de téléchargement est ouvert et affiche les options Télécharger CSV et Télécharger Excel.

Télécharger la sortie du bloc-notes

Vous pouvez télécharger la sortie obtenue d'une cellule de bloc-notes directement à partir du panneau de résultats.

  1. En haut à droite de la cellule à partir de laquelle télécharger la sortie, cliquez sur Télécharger.
  2. Dans le menu, sélectionnez le format sous lequel vous voulez télécharger la sortie.

Copier la sortie du bloc-notes

Vous pouvez copier la sortie obtenue d'une cellule de bloc-notes directement à partir du panneau de résultats.

  1. En haut à droite de la cellule à partir de laquelle vous souhaitez télécharger la sortie, cliquez sur Copier.
  2. Le contenu de la cellule de sortie est copié directement dans le presse-papiers. Vous pouvez le coller ailleurs dans votre bloc-notes ou à un emplacement externe.

Apparence du bloc-notes

Vous pouvez modifier l'espace disponible sur l'écran pour travailler dans les blocs-notes en réduisant le panneau de navigation de gauche ou en développant la vue Bloc-notes.

Vous pouvez réduire le panneau de navigation de gauche d'Oracle AI Data Platform Workbench tout en travaillant sur votre bloc-notes pour augmenter l'espace d'écran utilisable en cliquant sur Réduire le panneau dans la partie inférieure droite du panneau de navigation.


Panneau de navigation gauche du pupitre AI Data Platform avec icône Réduire le panneau mise en évidence

Vous pouvez également développer le bloc-notes en cliquant sur Développer en haut à droite du bloc-notes, en augmentant l'espace disponible et en facilitant la lecture des cellules et des sorties plus volumineuses.


Bloc-notes ouvert avec icône Développer mise en évidence

Numéros d'exécution de cellule

Chaque cellule du bloc-notes affiche un numéro d'exécution qui indique l'ordre dans lequel les cellules ont été exécutées. Ce nombre est mis à jour chaque fois que la cellule est exécutée. Vous pouvez exécuter des cellules dans n'importe quel ordre, de sorte que les numéros d'exécution peuvent ne pas correspondre à l'ordre physique des cellules dans votre bloc-notes.

Gérer les traitements de travail

Vous pouvez créer des traitements de travail pour gérer comment et quand le code est exécuté à partir de vos blocs-notes.

Les exécutions de travail manuelles peuvent être réexécutées ou configurées ultérieurement pour être exécutées selon une programmation. Les exécutions de travail programmées sont déclenchées automatiquement en fonction de la programmation que vous avez définie. Sauf si une planification est configurée, les travaux manuels ne sont exécutés qu'une seule fois.

Création d'un travail d'exécution manuelle à partir d'un bloc-notes

Vous pouvez créer un travail non planifié que vous pouvez exécuter manuellement à partir du code que vous avez développé dans votre bloc-notes.

  1. Sur la page d'accueil, cliquez sur Espace de travail.
  2. Accédez à votre bloc-notes.
  3. Cliquez sur Actions, puis sur Planifier.
  4. Fournissez le nom et la description du travail.
  5. Cliquez sur Parcourir et sélectionnez l'emplacement de stockage de votre travail. Cliquez sur Sélectionner.
  6. Sélectionnez un cluster de calcul dans la liste déroulante Cluster.
  7. Dans Programmation, sélectionnez Exécution manuelle.
  8. Cliquez sur Créer.

Création d'une exécution de travail programmée à partir d'un bloc-notes

Vous pouvez créer un travail planifié qui s'exécute automatiquement à partir du code que vous avez développé dans votre bloc-notes.

  1. Sur la page d'accueil, cliquez sur Espace de travail.
  2. Accédez à votre bloc-notes.
  3. Cliquez sur Actions, puis sur Planifier.
  4. Fournissez le nom et la description du travail.
  5. Cliquez sur Parcourir et sélectionnez l'emplacement de stockage de votre travail. Cliquez sur Sélectionner.
  6. Sélectionnez un cluster de calcul dans la liste déroulante Cluster.
  7. Dans Programmation, sélectionnez Programmation.
  8. Sélectionnez un statut de programmation.
    • Sélectionnez Actif si vous souhaitez que la programmation soit activée immédiatement.
    • Sélectionnez En pause pour activer manuellement l'exécution planifiée ultérieurement.
  9. Indiquez un fuseau horaire sur lequel le planning doit être basé.
  10. Sélectionnez le type de programmation.
    • Pour Calendrier, vous devez indiquer la fréquence et les heures ou jours de répétition de la programmation.
    • Pour Expression CRON, vous devez fournir la programmation sous la forme d'une expression CRON.
  11. Vérifiez l'heure d'exécution répertoriée en bas pour confirmer que votre programmation est correcte. Cliquez sur Créer.

Raccourcis clavier du bloc-notes

Vous pouvez utiliser des raccourcis clavier pour simplifier l'utilisation des commandes dans votre bloc-notes.

Windows  macOS Action
Ctrl + Entrée Cmd + Retour Exécuter cellule
Maj+Entrée Equipe + Retour Exécuter la cellule et passer à la cellule suivante
Ctrl + S Cmd + S Enregistrer le bloc-notes
Ctrl + N Ctrl + N Nouveau bloc-notes
Ctrl + Z CMD + Z Annuler
Ctrl + Y CMD + Y Rétablir
Ctrl + C Cmd + C Copier (Copy)
Ctrl+X cmd +X Couper
Ctrl + V CMD + V Coller
Ctrl + Alt + F Ctrl + Option + F Rechercher et remplacer
Ctrl + Maj + A Ctrl + Maj + A Insérer des cellules au-dessus
Ctrl + Maj + B Ctrl + Maj + B Insérer les cellules ci-dessous
Ctrl + Alt + Haut Ctrl + Option + Haut Déplacer la cellule vers le haut
Ctrl + Alt + Bas Ctrl + Option + Bas Déplacer la cellule vers le bas
Ctrl + D Ctrl + D Supprimer une cellule
Alt + Maj + Entrée Option + Maj + Retour Tout exécuter
Alt + Maj + Haut Option + Maj + Haut Exécuter toutes les cellules ci-dessus

Migrer le code Apache Spark existant vers Oracle AI Data Platform Workbench

Vous pouvez adapter votre code Apache Spark pour le migrer afin de l'utiliser dans les blocs-notes Oracle AI Data Platform Workbench.

Si vous migrez du code Spark existant à partir d'autres plates-formes, vous pouvez utiliser les directives suivantes pour adapter votre code en vue de son utilisation dans les blocs-notes.

Tableau 11-2 Directives de migration d'Apache Spark vers une plate-forme de données AI

Recommandation Détails
Enlever les commandes de création SparkSession AI Data Platform Workbench crée automatiquement un SparkContext pour chaque cluster de calcul. Nous vous recommandons de supprimer les commandes de création de session ou de les remplacer par SparkSession.builder().getOrCreate().
Enlever les commandes de terminaison de session, telles que sys.exit() ou spark.stop() Tous les clusters de calcul à usage unique sont des clusters partagés. Par conséquent, si des utilisateurs arrêtent SparkSession, en utilisant sys.exit() ou spark.stop(), par exemple, le cluster doit être redémarré pour tout le monde. Pour éviter toute interruption, nous vous recommandons d'éviter ces commandes dans les blocs-notes.