Installer des bibliothèques à partir des fichiers d’espace de travail

Cet article vous guide dans les étapes requises pour charger des fichiers de package ou de requirements.txt dans les fichiers d’espace de travail et les installer sur des clusters dans Azure Databricks. Vous pouvez installer des bibliothèques sur une capacité de calcul à usage général ou une capacité de calcul de tâche.

Pour plus d’informations sur les fichiers d’espace de travail, consultez l’interface utilisateur de l’espace de travail.

Databricks Runtime 15.0 ou version ultérieure est requis pour charger des fichiers requirements.txt dans les fichiers d’espace de travail. Pour plus d’informations sur la compatibilité des bibliothèques, consultez Installer des bibliothèques.

Charger des bibliothèques dans les fichiers d’espace de travail

Vous pouvez charger des bibliothèques dans les fichiers d’espace de travail de la même manière que vous chargez d’autres fichiers.

Pour charger une bibliothèque dans les fichiers d’espace de travail :

1. Cliquez sur Workspace (Espace de travail) dans la barre latérale gauche.
2. Rendez-vous dans l’emplacement de l’espace de travail où vous souhaitez charger la bibliothèque.
3. Cliquez sur Dans le coin supérieur droit, puis choisissez Importer.
4. La boîte de dialogue Importer s’affiche. Pour Import from (Importer depuis) : choisissez File (Fichier) ou URL. Glissez-déposez ou recherchez le(s) fichier(s) que vous souhaitez charger, ou indiquez le chemin URL du fichier.
5. Cliquez sur Importer.

Installer des bibliothèques à partir des fichiers d’espace de travail sur un cluster

Lorsque vous installez une bibliothèque sur un cluster, tous les notebooks exécutés sur ce cluster ont accès à la bibliothèque.

Pour installer une bibliothèque à partir des fichiers d’espace de travail sur un cluster :

1. Cliquez sur Compute (Calcul) dans la barre latérale gauche.
2. Cliquez sur le nom du cluster dans la liste des clusters.
3. Cliquez sur l’onglet Bibliothèques.
4. Cliquez sur Installer. La boîte de dialogue Install library (Installer une bibliothèque) s’affiche.
5. Pour Library Source (Source de la bibliothèque), sélectionnez Workspace (Espace de travail).
6. Chargez la bibliothèque ou le fichier requirements.txt, recherchez la bibliothèque ou le fichier requirements.txt dans l’espace de travail, ou saisissez son emplacement dans l’espace de travail dans le champ Workspace File Path (Chemin du fichier d’espace de travail), comme dans l’exemple suivant : /Workspace/Users/someone@example.com/<path-to-library>/<library-name>.<ext>
7. Cliquez sur Installer.

Ajouter des bibliothèques dépendantes aux tâches d’un workflow à partir des fichiers d’espace de travail

Vous pouvez ajouter des bibliothèques dépendantes aux tâches à partir des fichiers d’espace de travail. Veuillez consulter la section Configurer et modifier les tâches dans Lakeflow Jobs.

Pour configurer une tâche de workflow avec une bibliothèque dépendante provenant des fichiers d’espace de travail :

1. Sélectionnez une tâche existante dans un workflow ou créez une nouvelle tâche.
2. À côté de Dependent libraries (Bibliothèques dépendantes), cliquez sur + Add (Ajouter).
3. Dans la boîte de dialogue Add dependent library (Ajouter une bibliothèque dépendante), sélectionnez Workspace (Espace de travail) pour Library Source (Source de la bibliothèque).
4. Chargez la bibliothèque ou le fichier requirements.txt, recherchez la bibliothèque ou requirements.txt dans l’espace de travail, ou saisissez son emplacement dans l’espace de travail dans le champ Workspace File Path (Chemin du fichier d’espace de travail), comme dans l’exemple suivant : /Workspace/Users/someone@example.com/<path-to-library>/<library-name>.<ext>
5. Cliquez sur Installer.

Installer des bibliothèques à partir des fichiers d’espace de travail dans un notebook

Vous pouvez installer des bibliothèques Python directement dans un notebook pour créer des environnements personnalisés spécifiques à ce notebook. Par exemple, vous pouvez utiliser une version spécifique d’une bibliothèque dans un notebook, sans affecter d’autres utilisateurs du cluster qui peuvent avoir besoin d’une autre version de cette même bibliothèque. Pour en savoir plus, veuillez consulter la section bibliothèques à portée de notebook.

Lorsque vous installez une bibliothèque dans un notebook, seul le notebook actuel et les tâches associées à ce notebook ont accès à cette bibliothèque. Les autres notebooks attachés au même cluster ne sont pas concernés.