Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Las utilidades de notebook (NotebookUtils) son un paquete integrado que le ayudará a realizar fácilmente tareas comunes en Fabric Notebook. Puede usar NotebookUtils para trabajar con sistemas de archivos, obtener variables de entorno, encadenar cuadernos entre sí y trabajar con secretos. El paquete NotebookUtils está disponible en PySpark (Python) Scala, cuadernos de SparkR y canalizaciones de Fabric.
Note
- MsSparkUtils cambia oficialmente el nombre a NotebookUtils. El código existente sigue siendo compatible con versiones anteriores y no provoca cambios importantes. Se recomienda encarecidamente actualizar a notebookutils para garantizar el soporte continuo y el acceso a las nuevas características. El espacio de nombres mssparkutils será descontinuado en el futuro.
- NotebookUtils está diseñado para funcionar con Spark 3.4 (runtime v1.2) y versiones posteriores. Todas las nuevas características y actualizaciones se admitirán exclusivamente con el espacio de nombres notebookutils de ahora en adelante.
Módulos NotebookUtils
NotebookUtils proporciona los siguientes módulos. Seleccione un módulo para ver documentación detallada, ejemplos de código y procedimientos recomendados.
| Módulo | Namespace | Descripción |
|---|---|---|
| Utilidades del sistema de archivos | notebookutils.fs |
Trabaje con archivos y directorios en ADLS Gen2, Azure Blob Storage y Lakehouse Storage. Incluye operaciones de copia, movimiento, lectura, escritura, eliminación y lista. |
| Montaje y desmontaje de archivos | notebookutils.fs |
Conecte el almacenamiento remoto (ADLS Gen2) a los nodos de Spark como puntos de montaje locales para simplificar el acceso a archivos. |
| Ejecución y orquestación de cuadernos | notebookutils.notebook |
Ejecute y encadene cuadernos juntos, incluida la ejecución en paralelo con compatibilidad con DAG, referencias entre áreas de trabajo y valores de salida. |
| Gestión de portátiles | notebookutils.notebook |
Crear, obtener, actualizar, eliminar y listar objetos de cuadernos de manera programática. |
| Utilidades de credenciales | notebookutils.credentials |
Obtenga tokens de acceso para los servicios de Azure y recupere secretos de Azure Key Vault. |
| Utilidades de Lakehouse | notebookutils.lakehouse |
Cree, obtenga, actualice, elimine y administre elementos y tablas de Lakehouse mediante programación. |
| Contexto en tiempo de ejecución | notebookutils.runtime |
Acceda a la información de contexto de sesión, incluidos el nombre del cuaderno, los detalles del área de trabajo y el contexto de ejecución. |
| Administración de sesiones | notebookutils.session |
Detenga las sesiones interactivas y reinicie el intérprete de Python. |
| Utilidades de función de datos de usuario (UDF) | notebookutils.udf |
Recupere e invoque funciones de datos de usuario desde cuadernos. |
| Utilidades de la biblioteca de variables | notebookutils.variableLibrary |
Acceda a variables y configuraciones administradas centralmente desde elementos de biblioteca de variables. |
Para obtener información general de todos los módulos y métodos disponibles, ejecute:
notebookutils.help()
Para obtener ayuda para un módulo específico, ejecute:
notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()
Problemas conocidos
- Al usar la versión en tiempo de ejecución anterior a 1.2 y ejecutar
notebookutils.help(), las API fabricClient y PBIClient enumeradas aún no se admiten, pero estarán disponibles en una versión futura.