Gestion des bibliothèques dans l’environnement Fabric
Les environnements Microsoft Fabric fournissent des configurations flexibles pour l’exécution de vos tâches Spark. Les bibliothèques fournissent du code réutilisable que les développeurs souhaitent inclure dans leur travail. À l’exception des bibliothèques intégrées qui sont livrées avec chaque runtime Spark, vous pouvez installer des bibliothèques publiques et personnalisées dans vos environnements Fabric. Et vous pouvez facilement attacher des environnements à vos notebooks et à vos définitions de tâches Spark.
Remarque
La modification de la version d’un package spécifique peut potentiellement interrompre d’autres packages qui en dépendent. Par exemple, la rétrogradation azure-storage-blob
peut entraîner des problèmes avec Pandas
et diverses autres bibliothèques qui s’appuient sur Pandas
, y compris mssparkutils
, fsspec_wrapper
et notebookutils
.
Vous pouvez afficher la liste des packages préinstallés et leurs versions pour chaque runtime ici.
Consultez d’autres options et meilleures pratiques d’utilisation de bibliothèques dans Microsoft Fabric : Gérer des bibliothèques Apache Spark dans Microsoft Fabric
Bibliothèques publiques
Les bibliothèques publiques proviennent de dépôts tels que PyPI et Conda, qui sont actuellement pris en charge par Fabric.
Ajouter une nouvelle bibliothèque publique
Pour ajouter une nouvelle bibliothèque publique, sélectionnez une source et spécifiez le nom et la version de la bibliothèque. Vous pouvez également charger un fichier .yml de spécification d’environnement Conda pour spécifier les bibliothèques publiques. Le contenu du fichier .yml chargé est extrait et ajouté à la liste.
Remarque
La fonction de saisie semi-automatique des noms de bibliothèques lors de l’ajout est limitée aux bibliothèques les plus populaires. Si la bibliothèque que vous souhaitez installer ne fait pas partie de la liste, vous ne recevrez pas d’invite de saisie semi-automatique. Vous pouvez plutôt rechercher la bibliothèque directement dans PyPI ou Conda en entrant son nom complet. Si le nom de la bibliothèque est valide, vous voyez les versions disponibles. Si le nom de la bibliothèque n’est pas valide, vous recevez un avertissement indiquant que la bibliothèque n’existe pas.
Ajouter des bibliothèques publiques par lot
Les environnements prennent en charge le téléchargement du fichier YAML pour gérer plusieurs bibliothèques publiques dans un lot. Les contenus du fichier YAML est extrait et ajouté à la liste des bibliothèques publiques.
Remarque
Les canaux conda personnalisés dans le fichier YAML ne sont actuellement pas pris en charge. Seules les bibliothèques de PyPI et de conda sont reconnues.
Filtrer les bibliothèques publiques
Entrez des mots clés dans la zone de recherche de la page Bibliothèques publiques, pour filtrer la liste des bibliothèques publiques et trouver celui dont vous avez besoin.
Mettre à jour des bibliothèques publiques
Pour mettre à jour la version d’une bibliothèque publique existante, accédez à votre envronment et ouvrez Bibliothèques publiques ou Bibliothèques personnalisées. Choisissez la bibliothèque requise, puis sélectionnez une entrée dans la liste déroulante de versions et mettez à jour.
Supprimer des bibliothèques publiques
L’option de corbeille de chaque bibliothèque s’affiche lorsque vous passez votre souris sur la ligne correspondante. Vous pouvez également supprimer plusieurs bibliothèques publiques en les sélectionnant, puis en sélectionnant Supprimer sur le ruban.
Afficher une dépendance
Chaque bibliothèque publique a différentes dépendances. L’option de dépendance d’affichage s’affiche lorsque vous passez votre souris sur la ligne correspondante.
Exporter au format yaml
Fabric offre l’option d’exporter la liste complète des bibliothèques publiques vers un fichier YAML et le télécharger dans votre répertoire local.
Bibliothèques personnalisées
Les bibliothèques personnalisées se réfèrent au code créé par vous ou par votre organisation. Fabric prend en charge les fichiers de bibliothèque personnalisés dans les formats .whl, .jar et .tar.gz.
Remarque
Fabric prend uniquement en charge fichiers .tar.gz pour la langue R. Utilisez le format de fichier .whl pour le langage Python.
Charger la bibliothèque personnalisée
Vous pouvez charger des bibliothèques personnalisées à partir de votre répertoire local dans l’environnement Fabric.
Supprimer la bibliothèque personnalisée
L’option de corbeille de chaque bibliothèque s’affiche lorsque vous passez votre souris sur la ligne correspondante. Vous pouvez également supprimer plusieurs bibliothèques personnalisées en les sélectionnant, puis en sélectionnant Supprimer sur le ruban.
Télécharger toutes les bibliothèques personnalisées
Si vous cliquez sur ce bouton, les bibliothèques personnalisées sont téléchargées une par une dans votre répertoire de téléchargement local par défaut.