Gérer les bibliothèques

Cette section explique comment utiliser et gérer les bibliothèques connectées à vos clusters de calcul.

Bibliothèques

Vous pouvez ajouter des bibliothèques de portée cluster pour que le code tiers ou personnalisé soit disponible pour vos clusters de calcul lors de l'exécution de blocs-notes ou de travaux de workflow.

Les bibliothèques de niveau cluster peuvent être installées pour étendre les fonctionnalités prêtes à l'emploi des clusters de calcul et s'appliquent à tous les blocs-notes et tâches de workflow utilisant ce cluster. Par exemple, options de visualisation, options de connectivité (par exemple, fichiers JAR JDBC), extractions (par exemple, extraction de texte à partir d'un fichier PDF) ou transformations.

L'option d'installation des bibliothèques de portée cluster est disponible dans l'onglet Bibliothèque de votre cluster une fois que le statut du cluster devient Actif. Votre fichier de bibliothèque doit être un fichier .jar ou un fichier Wheel (*.whl) ou un fichier requirements.txt.

Vous pouvez également ajouter des scripts d'initialisation lors de la création d'un cluster ou en modifiant un cluster existant. Pour plus d'informations, reportez-vous à la section Modify a Cluster.

Installer une bibliothèque à partir d'un espace de travail ou d'un volume

Vous pouvez installer une bibliothèque qui se trouve dans votre espace de travail ou votre volume afin de développer les options de cluster pour les blocs-notes et les travaux attachés.

Les bibliothèques peuvent uniquement être ajoutées à partir d'un espace de travail ou d'un volume pour lequel vous disposez des droits d'accès appropriés. Vous pouvez afficher les bibliothèques installées sur un cluster à tout moment à partir de l'onglet Library du cluster.

Si le fichier de bibliothèque que vous souhaitez installer n'est pas déjà disponible dans votre espace de travail ou votre volume, vous pouvez d'abord télécharger la bibliothèque de votre ordinateur local vers votre espace de travail, puis l'installer dans le cluster.

  1. Accédez à votre espace de travail et cliquez sur Compute.
  2. Cliquez sur le cluster, puis sur l'onglet Bibliothèque.
  3. Cliquez sur Icône Installer la bibliothèque Bibliothèque d'installation.
  4. Indiquez si votre bibliothèque fait partie d'un espace de travail ou d'un volume.

    Ouvrir la page Install Library avec l'option Workspace sélectionnée

  5. Accédez à la bibliothèque et sélectionnez-la. Cliquez sur Installer.
  6. Une fois la bibliothèque installée, redémarrez le cluster en cliquant sur Actions, puis sur Redémarrer.
    Lorsque le statut du cluster est à nouveau Actif, vous pouvez utiliser la bibliothèque dans votre code dans un bloc-notes ou un travail de workflow.

Installer une bibliothèque à partir d'un fichier chargé

Vous pouvez installer une bibliothèque dans votre espace de travail à partir d'un fichier téléchargé afin de développer les options de cluster pour les blocs-notes et les travaux attachés.

  1. Accédez à votre espace de travail et cliquez sur Compute.
  2. Cliquez sur le cluster, puis sur l'onglet Bibliothèque.
  3. Cliquez sur Icône Installer la bibliothèque Bibliothèque d'installation.
  4. Sélectionnez Télécharger le fichier vers l'espace de travail.

    Page Installer la bibliothèque avec l'option Télécharger le fichier vers l'espace de travail sélectionnée

  5. Accédez au fichier contenant votre bibliothèque ou glissez-déplacez-le dans la fenêtre.
    Votre fichier de bibliothèque doit être au format .whl ou .jar ou un fichier texte portant le nom requirements.txt. Pour plus d'informations sur le fichier requirements.txt, reportez-vous à la section Requirements File Format.

    Voici un exemple de fichier requirements.txt :

    plotly==6.0.1
    pandas==2.2.3
    matplotlib==3.10.1
  6. Cliquez sur Installer.
  7. Une fois la bibliothèque installée, redémarrez le cluster en cliquant sur Actions, puis sur Redémarrer.
    Lorsque le statut du cluster est à nouveau Actif, vous pouvez utiliser la bibliothèque dans votre code dans un bloc-notes ou un travail de workflow.

Désinstallation d'une bibliothèque

Vous pouvez désinstaller une bibliothèque indésirable ou dont vous n'avez plus besoin des clusters que vous possédez.

  1. Accédez à votre espace de travail et cliquez sur Compute.
  2. Cliquez sur le cluster, puis sur l'onglet Bibliothèque.
  3. En regard de la bibliothèque, cliquez sur Icône Actions à trois points Actions, puis sur Désinstaller.
  4. Cliquez sur Désinstaller.