Edición básica en cuadernos de Databricks

Un cuaderno de Databricks es un editor de código basado en web que permite escribir código y ver los resultados para el análisis interactivo de datos. En esta página se describen los conceptos básicos del uso de cuadernos en Databricks, incluido cómo navegar por la barra de herramientas y realizar diversas acciones de celda.

Creación de un cuaderno

Puede crear un cuaderno de varias maneras:

• Usar el botón Nuevo en la barra lateral
• Crear un cuaderno en cualquier carpeta
• Crear un cuaderno en una pestaña nueva

Apertura de un cuaderno

Para abrir un cuaderno, use la función Search del área de trabajo o use el explorador del área de trabajo para ir al cuaderno y haga clic en el nombre o el icono del cuaderno.

Si tiene pestañas para cuadernos y archivos habilitados, puede abrir un cuaderno en una nueva pestaña.

Celdas de cuaderno

Los cuadernos contienen una colección de dos tipos de celdas: celdas de código y celdas Markdown. Las celdas de código contienen código ejecutable. Las celdas de Markdown contienen código Markdown que se representa como texto y gráficos. Use Markdown para documentar o ilustrar el código. Puede agregar o quitar celdas de cualquier tipo en el cuaderno para estructurar el trabajo.

Puede ejecutar una sola celda, un grupo de celdas o todo el cuaderno. Una celda del cuaderno puede contener como máximo 6 MB y su salida está limitada a 20 MB.

Iconos y botones de la barra de herramientas del cuaderno

La barra de herramientas incluye menús e iconos que puede usar para administrar y editar el cuaderno.

Junto al nombre del cuaderno hay botones para cambiar el idioma predeterminado del cuaderno y, si el cuaderno está incluido en una carpeta de Git de Databricks, abrir el cuadro de diálogo de Git.

Para ver versiones anteriores del cuaderno, haga clic en "Última edición..." situado a la derecha de los menús.

Los iconos y botones situados a la derecha de la barra de herramientas se describen en la tabla siguiente:

Icono	Descripción
	Ejecutar todas las celdas o detener la ejecución. El nombre de este botón cambia en función del estado del cuaderno.
	Abra el selector de proceso. Cuando el cuaderno está conectado a un clúster o a sql Warehouse, este botón muestra el nombre del recurso de proceso.
	Abrir el programador de trabajos.
	Abra Lakeflow Declarative Pipelines. Este botón solo aparece si el cuaderno forma parte de una canalización.
	Abra el cuadro de diálogo de permisos .

Acciones de la barra lateral derecha

Hay varias acciones disponibles en la barra lateral derecha del cuaderno, como se describe en la tabla siguiente:

Icono	Descripción
icono de comentarios de encabezado de	Abrir los comentarios del cuaderno.
icono de experimento de encabezado de Notebook	Abrir el experimento de cuaderno de MLflow.
icono	Abra el historial de versiones del cuaderno.
	Abrir explorador de variables. (Disponible para variables de Python con Databricks Runtime 12.2 LTS y versiones posteriores).
	Abra el panel de entorno de Python. En este panel se muestran todas las bibliotecas de Python disponibles para el cuaderno, incluidas las bibliotecas específicas de cuaderno, las bibliotecas de clústeres y las bibliotecas incluidas en "Databricks Runtime". Solo está disponible cuando el cuaderno está asociado a un clúster.

Crear celdas

Los cuadernos tienen dos tipos de celdas: código y Markdown. El contenido de las celdas de Markdown se representa en HTML. Por ejemplo, este fragmento de código contiene marcado para un encabezado de nivel uno:

%md ### Libraries
Import the necessary libraries.

Representa como se muestra:

Para crear una nueva celda, mantenga el puntero sobre una celda en la parte superior o inferior. Haga clic en Código o Texto para crear un código o una celda Markdown, respectivamente.

Acciones de celda

El menú acciones de celda permite ejecutar, cortar y copiar celdas, mover celdas alrededor del cuaderno y ocultar código o resultados.

Ejecución de una celda

Para ejecutar celdas de código, haga clic en la flecha abajo situada en la parte superior izquierda de la celda de código.

Una vez ejecutada una celda, aparece un aviso a la derecha del menú de ejecución de celdas, que muestra la última vez que se ejecutó la celda y su duración. Mantenga el cursor sobre el aviso para obtener más detalles.

Para mostrar información detallada de ejecución de forma predeterminada, haga clic en la imagen de perfil en la parte superior derecha. A continuación, haga clic en Configuración>Desarrollador>Mostrar información detallada de la ejecución de comandos.

Si tiene una salida de resultado tabular, también puede acceder a esta información si mantiene el puntero sobre la sección "Última actualización" de la interfaz de usuario.

Combinación de celdas seleccionadas

Puede ejecutar una sola celda o una colección de celdas. Para seleccionar una sola celda, haga clic en cualquier lugar dentro de la celda. Para seleccionar varias celdas, mantenga presionada la tecla Command en MacOS o la clave Ctrl en Windows y haga clic en la celda fuera del área de texto, como se muestra en la captura de pantalla.

Para ejecutar las celdas seleccionadas, haga clic en Ejecutar>Ejecutar y depurar>Ejecutar celdas seleccionadas o use el método abreviado de teclado Command + Enter en MacOS o Crtl + Enter en Windows. El comportamiento de este comando depende del recurso de proceso al que está asociado el cuaderno.

• En un recurso informático que ejecuta Databricks Runtime 13.3 LTS o inferior, las celdas seleccionadas se ejecutan individualmente. Si se produce un error en una celda, la ejecución continúa con las celdas posteriores.
• En un recurso de proceso que ejecuta Databricks Runtime 14.0 o superior, o en un almacenamiento de SQL, las celdas seleccionadas se ejecutan como un lote. Cualquier error detiene la ejecución y no se puede cancelar la ejecución de celdas individuales. Puede usar el botón Interrumpir para detener la ejecución de todas las celdas.

Ejecutar texto seleccionado

Puede resaltar el código o las instrucciones SQL en una celda del cuaderno y ejecutar solo el código resaltado. Esto es útil si desea iterar rápidamente el código y las consultas.

1. Resalte las líneas que desea ejecutar.

2. Seleccione Ejecutar > Ejecutar texto seleccionado o use el método abreviado de teclado Ctrl+Shift+Enter. Si no hay ningún texto resaltado, Ejecutar texto seleccionado ejecuta la línea actual.

   

Si usa varios lenguajes en una celda, debe incluir la línea %<language> en la selección.

Ejecutar texto seleccionado también ejecuta código contraído, si hay alguno en la selección resaltada.

Se admiten comandos de celda especiales, como %run, %pipy %sh.

No puede usar Ejecutar texto seleccionado en celdas que tengan varias pestañas de salida (es decir, celdas en las que haya definido un perfil de datos o una visualización).

Iconos de celda

En la captura de pantalla siguiente se describen los iconos que aparecen en la esquina superior derecha de una celda del cuaderno:

selector de idioma: Seleccione el idioma de la celda.

Asistente Databricks: habilite o deshabilite Databricks Assistant para sugerencias de código en la celda.

Foco de celda: Ampliar la celda para facilitar la edición.

Mostrar menú de acciones de celda: Abrir el menú de acciones de celda. Las opciones de este menú son ligeramente diferentes para las celdas de código y Markdown.

Eliminación de una celda

Para eliminar una celda, haga clic en el icono de papelera situado a la derecha de la celda. Este icono solo aparece al mantener el cursor sobre la celda.

Movimiento de una celda

Para subir o bajar una celda, haga clic y mantenga presionado el icono de controlador de arrastre a la izquierda de la celda.

También puede seleccionar Mover hacia arriba o Mover hacia abajo en el menú de acciones de celda.

Cortar, Copiar y Pegar celdas

Hay varias opciones para cortar y copiar celdas. Sin embargo, si usa el explorador Safari, solo están disponibles los métodos abreviados de teclado.

• En el menú de acciones de celda, seleccione Cortar celda o Copiar celda.
• Use métodos abreviados de teclado: Command-X o Ctrl-X para cortar y Command-C o Ctrl-C copiar.
• Use el menú Editar de la parte superior del cuaderno. Seleccione Cortar o Copiar.

Después de cortar o copiar celdas, puede pegar esas celdas en otra parte del cuaderno, en otro cuaderno o en un cuaderno en otra pestaña o ventana del explorador. Para pegar celdas, use el método abreviado de teclado Command-V o Ctrl-V. Las celdas se pegan debajo de la celda actual.

Para deshacer las acciones de cortar o pegar, puede usar el acceso directo del teclado Command-Z o Ctrl-Z o las opciones de menú Edición > Deshacer cortar celdas o Edición > Deshacer pegar celdas.

Para seleccionar celdas adyacentes, haga clic en una celda de Markdown y, después, use Mayús + Arriba o Abajo a fin de seleccionar las celdas situadas encima o debajo de ella. Use el menú de edición para copiar, cortar, pegar o eliminar las celdas seleccionadas como un grupo. Para seleccionar todas las celdas, seleccione Editar > Seleccione todas las celdas o use el acceso directo del modo de comando Cmd+A.

Agregar comentarios de código

Para agregar un comentario al código de una celda, resalte el código. A la derecha de la celda, aparece un icono de comentario. Haga clic en el icono para abrir el cuadro de comentario.

Adición de una celda a un panel

Para agregar una celda Markdown o una celda que tenga resultados tabulares a un panel, seleccione Agregar al panel en el menú acciones de celda. Para obtener más información, consulte Paneles en cuadernos.

Vínculo a una celda

Para obtener un enlace URL a un comando específico en tu cuaderno, haz clic en el icono de enfoque de celdacell focus iconpara abrir el modo de enfoque y copiar la URL desde la barra de direcciones del navegador. Para salir del modo de enfoque, haz clic en .

Apertura del Asistente de Databricks

Para abrir un cuadro de texto de Databricks Assistant en una celda, haga clic en el icono de Databricks Assistant en la esquina superior derecha de la celda.

Puede usarlo en una celda de código para obtener ayuda o sugerencias para el código. Databricks Assistant debe estar habilitado en el área de trabajo.