Interfaz y controles del cuaderno de Databricks
La barra de herramientas del cuaderno incluye menús e iconos que puede usar para administrar y editar el cuaderno.
Junto al nombre del cuaderno hay botones que le permiten 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 las versiones anteriores del cuaderno, haga clic en el mensaje "Última edición..." situado a la derecha de los menús.
Diseño de celda actualizado
Importante
Esta característica está en versión preliminar pública.
Hay disponible un diseño de celda actualizado. En esta página se incluye información sobre cómo usar ambas versiones del diseño de celdas. Para obtener una orientación a la nueva interfaz de usuario y respuestas a preguntas comunes, consulte Orientación a la nueva interfaz de usuario de celda.
Para habilitar o deshabilitar el nuevo diseño de celdas, abra la página configuración del editor en el área de trabajo. En la barra lateral, haga clic en Desarrollador. En Características experimentales, active Nueva interfaz de usuario de celda.
Celdas de cuaderno
Los cuadernos contienen una colección de dos tipos de celdas: celdas de código y celdas de Markdown. Las celdas de código contienen código ejecutable. Las celdas de Markdown contienen código Markdown que se representa en texto y gráficos cuando se ejecuta la celda y se pueden usar para documentar o ilustrar el código. Puede agregar o quitar celdas al cuaderno para estructurar el trabajo.
Puede ejecutar una sola celda, un grupo de celdas o ejecutar todo el cuaderno a la vez. Una celda del cuaderno puede contener como máximo 10 MB. La salida de la celda del cuaderno está limitada a 20 MB.
Iconos y botones de la barra de herramientas del cuaderno
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 almacenamiento SQL, este botón muestra el nombre del recurso de proceso. |
 |
Abrir el programador de trabajos. |
 |
Abrir Delta Live Tables. Este botón solo aparece si el cuaderno forma parte de una canalización de Delta Live Tables. |
 |
Abrir 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 |
|---|---|
 |
Abrir los comentarios del cuaderno. |
 |
Abrir el experimento de cuaderno de MLflow. |
 |
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 del entorno de Python. En este panel se muestran todas las bibliotecas de Python disponibles para el cuaderno, incluyendo las bibliotecas con ámbito de cuaderno, las bibliotecas de clúster y las bibliotecas incluidas en Databricks Runtime. Solo estará disponible cuando el cuaderno esté asociado a un clúster. |
Examinar datos
Importante
Esta característica está en versión preliminar pública.
Para explorar las tablas y volúmenes disponibles para su uso en el cuaderno, haga clic en el 
situado a la izquierda del cuaderno para abrir el explorador de esquema. Consulte Examinar datos para obtener más detalles.
Menú de acciones de celda
El menú de acciones de celda le permite cortar y copiar celdas, desplazar celdas en el cuaderno y ocultar código o resultados. El menú tiene una apariencia diferente en la interfaz de usuario original y en la nueva interfaz de usuario. En esta sección se incluyen instrucciones para ambas versiones.
Si Databricks Assistant está habilitado en el área de trabajo, puede usarlo en una celda de código para obtener ayuda o sugerencias para el código. Para abrir un cuadro de texto de Databricks Assistant en una celda, haga clic en el icono de Databricks Assistant 
situado en la esquina superior derecha de la celda.
Puede cambiar fácilmente una celda entre código y Markdown, o cambiar el lenguaje de una celda de código, usando el botón de lenguaje de la celda situado cerca de la esquina superior derecha de la celda.
Menú Acciones de celda (interfaz de usuario original)
En este menú también puede ejecutar celdas de código:
El menú de acciones de celda también incluye botones que le permiten ocultar una celda 
o eliminar una celda 
.
En el caso de las celdas de Markdown, también existe la opción de agregar la celda a un panel. Para obtener más información, consulte Paneles en cuadernos.
Trabajar con celdas en la nueva interfaz de usuario
En la captura de pantalla siguiente se describen los iconos que aparecen en la esquina superior derecha de una celda del cuaderno:
Selector de lenguaje: seleccione el lenguaje para la celda.
Asistente Databricks: habilite o deshabilite Databricks Assistant para sugerencias de código en la celda.
Foco de celda: amplíe la celda para facilitar la edición.
Mostrar menú de acciones de celda: abra el menú de acciones de celda. Las opciones de este menú son ligeramente diferentes para las celdas de código y las de Markdown.
Para ejecutar celdas de código en la nueva interfaz de usuario, 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 la duración de la ejecución. Mantenga el cursor sobre el aviso para obtener más detalles.
Para agregar una celda de Markdown o una celda que tenga resultados tabulares a un panel, seleccione Añadir al panel en el menú de acciones de celda. Para obtener más información, consulte Paneles en cuadernos.
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.
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 comentarios.
Para mover una celda hacia arriba o hacia abajo, haga clic y mantenga pulsado 
fuera de la esquina superior izquierda de la celda, y arrastre la celda a la nueva ubicación. También puede seleccionar Mover hacia arriba o Mover hacia abajo en el menú de acciones de celda.
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:
Creación de una celda (interfaz de usuario original)
Para crear una nueva celda en la interfaz de usuario original, pase el ratón por encima de una celda en la parte superior o inferior y haga clic en el icono 
. También puede usar el menú de celdas del cuaderno: haga clic en 
y seleccione Agregar celda encima o Agregar celda a continuación.
En el caso de una celda de código, escriba código en la celda. Para crear una celda de Markdown, seleccione Markdown en el botón de lenguaje de la celda o escriba %md en la parte superior de la celda.
Creación de una celda (nueva interfaz de usuario)
Para crear una nueva celda en la nueva interfaz de usuario, pase el ratón por encima de una celda de la parte superior o inferior. Haga clic en Código o Texto para crear una celda de código o de Markdown, respectivamente.
Corte, copia y pegado de celdas
Hay varias opciones para cortar y copiar celdas. Si usa el explorador Safari, solo están disponibles los métodos abreviados de teclado.
- En el menú de acciones de celda de la Interfaz de usuario original o de la Nueva interfaz de usuario, seleccione Cortar celda o Copiar celda.
- Use métodos abreviados de teclado:
Command-XoCtrl-Xpara cortar, yCommand-CoCtrl-Cpara copiar. - Use el menú Editar de la parte superior del cuaderno. Seleccione Cortar o Copiar.
Después de cortar o copiar celdas, puede pegarlas en otro lugar 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 > Seleccionar todas las celdas o use el acceso directo del modo de comandos Cmd+A.
Tabla de contenido del cuaderno
Para mostrar una tabla de contenido generada automáticamente, haga clic en el icono situado en la esquina superior izquierda del cuaderno (entre la barra lateral izquierda y la celda superior). La tabla de contenido se genera a partir de los encabezados de Markdown que se usan en el cuaderno. Si usa la nueva interfaz de usuario, las celdas con títulos también aparecen en la tabla de contenido.
Opciones de presentación de celdas
Hay tres opciones de visualización para los cuadernos. Use el menú Vista para cambiar la opción de visualización.
- Vista estándar: los resultados se muestran inmediatamente después de las celdas de código.
- Solo resultados: solo se muestran los resultados.
- En paralelo: las celdas de código y los resultados se muestran en paralelo.
En la nueva interfaz de usuario, las acciones están disponibles en los iconos del margen de celda (el área a la derecha y a la izquierda de la celda). Por ejemplo, para mover una celda hacia arriba o hacia abajo, use los puntos de agarre en el margen izquierdo. Para eliminar una celda, use el icono de papelera en el margen derecho.
Para facilitar la edición, haga clic en el icono de modo de enfoque 
para mostrar la celda en el ancho completo. Para salir del modo de enfoque, haga clic en 
. También puede ampliar la anchura mostrada de una celda desactivando Vista> Distribución centrada.
Para dar formato automáticamente a todas las celdas del cuaderno según las longitudes de línea y espaciado estándar del sector, seleccione Editar> Dar formato al cuaderno.
Números de línea y de comandos
Para mostrar u ocultar números de línea o números de comando, seleccione Números de línea o Números de comando en el menú Ver. En el caso de los números de línea, también puede usar el método abreviado de teclado Control+L.
Si habilita los números de línea o de comandos, Databricks guarda sus preferencias y las muestra en todos los demás cuadernos de ese explorador.
Números de línea y comandos (interfaz de usuario original)
Los números de comando encima de las celdas se vinculan a ese comando específico. Si hace clic en el número de comando de una celda, se actualiza la dirección URL para que esté anclada a ese comando. Para obtener un vínculo de dirección URL a un comando específico en el cuaderno, haga clic con el botón derecho en el número de comando y elija Copiar dirección de vínculo.
Números de línea y de comando (nueva interfaz de usuario)
Los números de línea están desactivados de forma predeterminada en la nueva interfaz de usuario. Para activarlos, seleccione Vista > Números de línea. Cuando una celda está en un estado de error, los números de línea se muestran independientemente de la selección.
Para alternar los números de comando, seleccione Ver >Números de comando.
La nueva interfaz de usuario no incluye vínculos de número de comando de celda. Para obtener un vínculo URL a un comando específico de su cuaderno, haga clic en para abrir el modo de enfoque y copie la URL de la barra de direcciones del navegador. Para salir del modo de enfoque, haga clic en .
Agregar un título de celda
Para agregar un título a una celda usando la interfaz de usuario original, seleccione Mostrar título en el menú de acciones de celda.
Para agregar un título a una celda mediante la nueva interfaz de usuario, realice una de las siguientes acciones:
- Haga clic en el número de celda que se muestra en el centro de la parte superior de la celda y escriba el título.
- Seleccione Agregar título en el menú acciones de celda.
Con la nueva interfaz de usuario, las celdas que tienen títulos aparecen en la tabla de contenido del cuaderno.
Visualización de cuadernos en modo oscuro
Puede optar por mostrar los cuadernos en modo oscuro. Para activar o desactivar el modo oscuro, seleccione Ver > Tema y Tema claro o Tema oscuro.
Ocultar y mostrar el contenido de la celda
El contenido de la celda consta de código de celda y los resultados generados mediante la ejecución de la celda. Puede ocultar y mostrar el código de la celda y el resultado usando el menú de acciones de celda situado en la parte superior derecha de la celda.
Para ver la funcionalidad relacionada, consulte Encabezados que pueden contraerse.
Ocultar y mostrar contenido de celda (interfaz de usuario original)
Para ocultar el código de celda o los resultados, haga clic en y seleccione Ocultar código u Ocultar resultado. También puede seleccionar para mostrar solo la primera línea de una celda.
Para mostrar el código o los resultados de celdas ocultas, haga clic en los vínculos Show (Mostrar):
Ocultar y mostrar contenido de celda (nueva interfaz de usuario)
Para ocultar el código de la celda o los resultados, haga clic en el menú desplegable 
situado en la parte superior derecha de la celda y seleccione Ocultar código u Ocultar resultado. También puede seleccionar Contraer celda para mostrar solo la primera línea de una celda. Para expandir una celda contraída, seleccione Expandir celda.
Para mostrar el código de celda oculto o los resultados, haga clic en el icono Mostrar: 
.
Encabezados que pueden contraerse
Las celdas que aparecen después de las celdas que contienen encabezados de Markdown ahora se pueden contraer en la celda de encabezado. Para expandir o contraer las celdas que hay después de las que contienen encabezados de Markdown en todo el cuaderno, seleccione Contraer todos los encabezadosen el menú Ver. En el resto de esta sección se describe cómo expandir o contraer un subconjunto de celdas.
Para ver la funcionalidad relacionada, consulte Ocultar y mostrar el contenido de la celda.
Expandir y contraer encabezados (interfaz de usuario original)
La imagen muestra un encabezado de nivel dos Configuración de MLflow con las dos celdas siguientes contraídas.
Haga clic en + y - para expandir y contraer los encabezados.
Expandir y contraer encabezados (nueva interfaz de usuario)
La imagen muestra un encabezado de nivel dos Configuración de MLflow con las dos celdas siguientes contraídas.
Para expandir y contraer los encabezados, pase el cursor por encima de la celda de Markdown. Haga clic en la flecha que aparece a la izquierda de la celda.
Recursos de proceso de cuadernos
En esta sección se tratan las opciones de los recursos de proceso de cuadernos. Puede ejecutar un cuaderno en un clúster de Databricks o, para los comandos SQL, también tiene la opción de usar un almacenamiento SQL, un tipo de proceso optimizado para el análisis SQL.
Anexión de un cuaderno a un clúster
Para asociar un cuaderno a un clúster, necesita el permiso CAN ATTACH TO en el nivel de clúster.
Importante
Siempre que un cuaderno esté asociado a un clúster, cualquier usuario con el permiso CAN RUN en el cuaderno tiene permiso implícito para acceder al clúster.
Para asociar un cuaderno a un clúster, haga clic en el selector de procesos de la barra de herramientas del cuaderno y seleccione un clúster en el menú desplegable.
En el menú se muestra una selección de clústeres que ha usado recientemente o que se están ejecutando actualmente.
Para seleccionar entre todos los clústeres disponibles, haga clic en Más…. Haga clic en el nombre del clúster para mostrar un menú desplegable y seleccione un clúster existente.
También puede crear un clúster seleccionando Crear recurso... en el menú desplegable.
Importante
Un cuaderno asociado tiene definidas las siguientes variables de Apache Spark.
| Clase | Nombre de la variable |
|---|---|
SparkContext |
sc |
SQLContext/HiveContext |
sqlContext |
SparkSession (Spark 2.x) |
spark |
No cree SparkSession, SparkContext ni SQLContext. De lo contrario, dará lugar a un comportamiento incoherente.
Uso de un cuaderno con un almacenamiento SQL
Cuando un cuaderno está asociado a un almacenamiento SQL, puede ejecutar celdas SQL y de Markdown. La ejecución de una celda en cualquier otro lenguaje (como Python o R) produce un error. Las celdas SQL ejecutadas en un almacenamiento SQL aparecen en el historial de consultas del almacenamiento SQL. El usuario que ejecutó una consulta puede ver el perfil de la consulta desde el cuaderno haciendo clic en el tiempo transcurrido en la parte inferior de la salida.
La ejecución de un cuaderno requiere un almacenamiento SQL profesional o sin servidor. Debe tener acceso al área de trabajo y al almacenamiento SQL.
Los widgets funcionan de forma diferente cuando un cuaderno está conectado a un almacén de SQL. Para obtener más información, vea Uso de widgets de Databricks en una instancia de SQL Warehouse.
Para asociar un cuaderno a un almacenamiento SQL, haga lo siguiente:
Haga clic en el selector de proceso en la barra de herramientas del cuaderno. El menú desplegable muestra los recursos de proceso que se están ejecutando actualmente o que se han usado recientemente. Los almacenamientos SQL están marcados con la
.En el menú, seleccione un almacenamiento SQL.
Para ver todos los almacenamientos SQL disponibles, seleccione Más… en el menú desplegable. Aparece un cuadro de diálogo que muestra los recursos de proceso disponibles para el cuaderno. Seleccione SQL Warehouse (Almacenamiento SQL), elija el almacenamiento que quiere usar y haga clic en Asociar.
También puede seleccionar una instancia de SQL Warehouse como recurso de proceso para un cuaderno de SQL al crear un flujo de trabajo o un trabajo programado.
Entre las limitaciones de los almacenamientos SQL se incluyen las siguientes:
- Cuando se asocia a un almacenamiento SQL, los contextos de ejecución tienen un tiempo de espera de inactividad de 8 horas.
- El tamaño máximo de los resultados devueltos es de 10 000 filas o 2 MB, lo que sea menor.
Desasociación de un cuaderno
Para desasociar un cuaderno de un recurso de proceso, haga clic en el selector de proceso de la barra de herramientas del cuaderno y mantenga el puntero sobre el clúster o almacenamiento SQL asociados en la lista para mostrar un menú lateral. Seleccione Desasociar en el menú lateral.
También puede desasociar cuadernos de un clúster mediante la pestaña Notebooks (Cuadernos) de la página de detalles del clúster.
Al desasociar un cuaderno, se quita el contexto de ejecución y se borran todos los valores de variables calculadas del cuaderno.
Sugerencia
Azure Databricks recomienda desasociar los cuadernos no usados de clústeres. De esta forma se libera espacio de memoria en el controlador.
Uso del terminal web y la CLI de Databricks
Para abrir el terminal web en un cuaderno, haga clic en 
la parte inferior de la barra lateral derecha.
Uso de la CLI de Databricks en un terminal web
A partir de Databricks Runtime 15.0, puede usar la CLI de Databricks desde el terminal web del cuaderno.
Requisitos
- El cuaderno debe estar conectado a un clúster en usuario único o No se ha compartido el aislamiento modo de acceso.
- La CLI no está disponible en áreas de trabajo habilitadas para Private Link.
La CLI instalada siempre es la versión más reciente. La autenticación se basa en el usuario actual.
No se puede usar la CLI desde una celda del cuaderno. Los comandos como %sh databricks ... de un cuaderno no funcionan con Databricks Runtime 15.0 o versiones posteriores.