Administración del formato del cuaderno de Databricks

De forma predeterminada, los cuadernos de Databricks se crean en formato .ipynb (IPython o Jupyter). También puede optar por usar el formato de origen en su lugar.

Todavía puede importar y exportar cuadernos en varios formatos. Vea Importación y exportación de cuadernos de Databricks.

Formatos de cuaderno

Databricks admite la creación y edición de cuadernos en dos formatos: IPYNB (valor predeterminado) y origen.

Puedes administrar archivos de origen, incluidos cuadernos, mediante carpetas de Git. Solo se admiten determinados tipos de recursos de Databricks en carpetas de Git. El formato afecta a cómo se confirman los cuadernos en repositorios remotos, como se describe en la tabla siguiente.

Formato de origen del cuaderno	Descripción
fuente	Un formato básico que solo captura el código fuente, con un sufijo que indica el lenguaje de código, como .py, .scala, .r y .sql.
IPYNB (Jupyter)	Un formato enriquecido que captura el código fuente, el entorno del cuaderno, las definiciones de visualización, los widgets de cuaderno y las salidas opcionales. Un cuaderno IPYNB puede contener código en cualquier lenguaje admitido por los cuadernos de Databricks (a pesar de la parte py de .ipynb). Con el formato IPYNB, puede opcionalmente llevar control de versiones tanto del contenido del cuaderno como de su salida.

El formato IPYNB también admite una mejor experiencia de visualización para cuadernos de Databricks en repositorios de Git remotos. Si usa GitHub o GitLab, puede habilitar características que proporcionan diferencias mejoradas de los cuadernos en las solicitudes de incorporación de cambios, lo que facilita la visualización y la revisión de código de los cambios en un cuaderno.

Para obtener más información sobre la compatibilidad de GitHub con diferencias avanzadas de cuadernos IPYNB, consulte Vista previa de funciones: Diferencias avanzadas de Jupyter Notebook. Para obtener más información sobre la compatibilidad de GitLab con las diferencias en los cuadernos IPYNB, consulte Archivos de Jupyter Notebook.

Para distinguir los cuadernos de formato de origen de los archivos de Python, Scala y SQL normales, Azure Databricks agrega el comentario "Databricks notebook source" a la parte superior de los cuadernos de Python, Scala y SQL. Este comentario garantiza que Azure Databricks analice correctamente el archivo como un cuaderno en lugar de un archivo de script.

Cambiar la configuración predeterminada del formato del cuaderno

Los cuadernos IPYNB son el formato predeterminado al crear un cuaderno en Azure Databricks.

Para cambiar el valor predeterminado al formato de origen de Azure Databricks, inicie sesión en el área de trabajo de Azure Databricks, haga clic en el perfil en la esquina superior derecha de la página y, a continuación, haga clic en Settings y vaya a Developer. Cambie el formato predeterminado del cuaderno en la sección de configuración del editor bajo el encabezado .

Conversión del formato de cuaderno

Puede convertir un cuaderno existente a otro formato a través de la interfaz de usuario de Azure Databricks.

Para convertir un cuaderno existente a otro formato:

1. Abra el cuaderno en el área de trabajo.

2. Seleccione Archivo en el menú del área de trabajo, seleccione Formato de cuaderno y elija el formato que desee. Puedes elegir Jupyter (.ipynb) (recomendado) u Source (.scala, .py, .sql, .r). El formato actual del cuaderno está en gris y tiene una marca de verificación al lado.

   

Para obtener más información sobre los tipos de cuadernos admitidos en Azure Databricks, consulte Importar y exportar cuadernos de Databricks.

Administrar confirmaciones de salida del cuaderno IPYNB

Las salidas son los resultados de ejecutar un cuaderno en la plataforma de Databricks, incluidas las tablas y las visualizaciones. En el caso de los cuadernos IPYNB en carpetas controladas por código fuente, puede administrar cómo se confirman las salidas del cuaderno en el repositorio remoto.

Habilitación de la confirmación de la salida del cuaderno .ipynb

Los resultados solo se pueden confirmar si un administrador del área de trabajo ha habilitado esta función. De manera predeterminada, la configuración administrativa de las carpetas Git no permite confirmar la salida del cuaderno .ipynb. Si tiene privilegios de administrador para el área de trabajo, puede cambiar esta configuración:

1. Haga clic en su nombre de usuario en la barra superior del área de trabajo de Azure Databricks y seleccione Configuración.

2. En Administrador del espacio de trabajo, haz clic en Desarrollo.

3. En la sección Repos, configura Permitir que los repos exporten la salida IPYNB a Permitir: las salidas IPYNB pueden activarse.

   

Importante

Cuando se incluyen salidas, las configuraciones de visualizaciones y paneles se incluyen en los cuadernos .ipynb que cree.

Control de las confirmaciones de artefactos de salida del cuaderno IPYNB

El .databricks/commit_outputs archivo de configuración en tu repositorio controla qué .ipynb salidas del cuaderno se incluyen en el commit. Después de que un administrador de espacio de trabajo permita los commits de salida, puedes crear este archivo desde el diálogo Git:

1. Abre el diálogo de Git para una carpeta Git que contiene un .ipynb notebook pero ningún archivo .databricks/commit_outputs.

2. En la alerta de información en la parte superior del diálogo, haz clic en Crear el archivo de configuración commit_outputs.

   

También puedes usar el menú Archivo para incluir o excluir salidas de un cuaderno IPYNB específico. Si el archivo de configuración no existe, Azure Databricks lo crea cuando haces tu selección. Usa esta opción si has cerrado la alerta en el diálogo de Git.

1. En el menú Archivo, selecciona Confirmar cambios de las salidas del cuaderno. El elemento de menú solo está disponible para notebooks IPYNB en una carpeta Git, después de que un administrador del espacio de trabajo permita los commits de salida.

   

2. En el cuadro de configuración de Confirmar salidas , selecciona Incluir salidas o Excluir salidas, y luego haz clic en Cambiar.