Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Notebook Utilities (NotebookUtils) est un package intégré pour vous aider à effectuer facilement des tâches courantes dans un notebook Fabric. Vous pouvez utiliser NotebookUtils pour travailler avec des systèmes de fichiers, pour obtenir des variables d’environnement, pour enchaîner des notebooks et utiliser des secrets. Le package NotebookUtils est disponible dans PySpark (Python) Scala, les notebooks SparkR et les pipelines Fabric.
Note
- MsSparkUtils est officiellement renommé NotebookUtils. Le code existant reste rétrocompatible et ne provoque aucune modification cassante. Il est vivement recommandé de mettre à niveau vers notebookutils pour garantir un accès continu et une prise en charge continue aux nouvelles fonctionnalités. L’espace de noms mssparkutils sera supprimé à l’avenir.
- NotebookUtils est conçu pour fonctionner avec Spark 3.4 (Runtime v1.2) et versions ultérieures. Toutes les nouvelles fonctionnalités et mises à jour seront exclusivement prises en charge avec l’espace de noms notebookutils à l’avenir.
Modules NotebookUtils
NotebookUtils fournit les modules suivants. Sélectionnez un module pour afficher une documentation détaillée, des exemples de code et des bonnes pratiques.
| Module | Namespace | Description |
|---|---|---|
| Utilitaires de système de fichiers | notebookutils.fs |
Travaillez avec des fichiers et des répertoires sur ADLS Gen2, le stockage Blob Azure et le stockage Lakehouse. Inclut les opérations de copie, de déplacement, de lecture, d’écriture, de suppression et de liste. |
| Montage et démontage de fichiers | notebookutils.fs |
Attachez le stockage distant (ADLS Gen2) aux nœuds Spark en tant que points de montage locaux pour un accès simplifié aux fichiers. |
| Exécution et orchestration du notebook | notebookutils.notebook |
Exécutez et reliez des notebooks, avec la possibilité d'une exécution parallèle prenant en charge les DAG, les références inter-espaces de travail et les valeurs de sortie. |
| Gestion des blocs-notes | notebookutils.notebook |
Créer, obtenir, mettre à jour, supprimer et répertorier des artefacts de bloc-notes de manière programmatique. |
| Outils d'identifiants | notebookutils.credentials |
Obtenez des jetons d’accès pour les services Azure et récupérez des secrets à partir d’Azure Key Vault. |
| Utilitaires Lakehouse | notebookutils.lakehouse |
Créez, obtenez, mettez à jour, supprimez et gérez des éléments et des tables Lakehouse par programmation. |
| Contexte d’exécution | notebookutils.runtime |
Accédez aux informations de contexte de session, notamment le nom du bloc-notes, les détails de l’espace de travail et le contexte d’exécution. |
| Gestion des sessions | notebookutils.session |
Arrêtez les sessions interactives et redémarrez l’interpréteur Python. |
| Utilitaires UDF (User Data Function) | notebookutils.udf |
Récupérer et appeler des fonctions de données utilisateur à partir de notebooks. |
| Utilitaires de bibliothèque de variables | notebookutils.variableLibrary |
Accédez aux variables et à la configuration gérées de manière centralisée à partir d’éléments de la bibliothèque de variables. |
Pour obtenir une vue d’ensemble de tous les modules et méthodes disponibles, exécutez :
notebookutils.help()
Pour obtenir de l’aide pour un module spécifique, exécutez :
notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()
Problèmes connus
- Lors de l’utilisation de la version runtime supérieure à la version 1.2 et en cours d’exécution
notebookutils.help(), les API FabricClient et PBIClient répertoriées ne sont pas encore prises en charge, mais elles seront disponibles dans une prochaine version.