Navegación por el cuaderno y el editor de archivos de Databricks

En este artículo se describen las funciones disponibles para ayudarle a navegar por el cuaderno y el editor de archivos de Databricks, incluidos métodos abreviados de teclado, sugerencias de código y función de autocompletar, inspección de variables y plegado de código. Al usar el cuaderno o el editor de archivos, Databricks Assistant está disponible para ayudarle a generar, explicar y depurar código. Consulte Obtención de ayuda de codificación de Databricks Assistant para obtener más información.

Puede elegir entre una selección de temas del editor. Seleccione Ver > tema del Editor y seleccione en el menú.

Paleta de comandos

Puede realizar rápidamente acciones en el cuaderno mediante la paleta de comandos. Para abrir un panel de acciones de cuaderno, haga clic en en la esquina inferior derecha del área de trabajo o use el acceso directo Cmd + Mayús + P en MacOS o Ctrl + Mayús + P en Windows.

Minimapa de ejecución de celdas

Para obtener información general visual sobre el estado de ejecución del cuaderno, use el minimap de ejecución de celdas. El minimap aparece en el margen derecho y muestra una barra de estado para cada celda ejecutable.

Las barras de estado indican los siguientes estados de ejecución:

• Gris claro: la celda es estática.
• Gris oscuro: la celda se omite o se pone en cola para su ejecución.
• Gris claro con barra móvil: la celda se está ejecutando actualmente.
• Verde: la celda se ejecutó correctamente sin errores.
• Rojo: se produjo un error en la celda.

Para interactuar con el minimap:

• Mantenga el puntero sobre el minimap para ver una lista de celdas ejecutables, sus títulos y sus estados de ejecución.
• Haga clic en una entrada para ir directamente a esa celda del cuaderno.
• Haga clic en Ir a la última celda de ejecución o ir a la primera celda con error para ir a la última ejecución o a la primera celda con errores.

El minimap ayuda a realizar un seguimiento del progreso de la ejecución de un vistazo y navegar rápidamente durante la depuración o el desarrollo.

Buscar y reemplazar texto

Para buscar y reemplazar texto dentro de un cuaderno, use el método abreviado de teclado, Cmd + F (Mac) o Ctrl + F (Windows), o selecciona Editar > Buscar... para abrir el cuadro de diálogo Buscar. Escriba el texto que desea encontrar. La coincidencia actual se resalta en naranja y todas las demás coincidencias se resaltan en amarillo. Para acceder a la búsqueda nativa del explorador, vuelva a presionar Cmd + F (Mac) o Ctrl + F(Windows).

Haga clic en el Para abrir la opción Reemplazar . Escriba el texto que desea usar en su lugar. Para reemplazar la coincidencia actual, haga clic en Replace (Reemplazar). Para reemplazar todas las coincidencias del cuaderno, haga clic en Replace All (Reemplazar todo).

Para desplazarse entre las coincidencias, haga clic en (coincidencia anterior) o (siguiente coincidencia). También puede pulsar Shift + Enter y Enter para ir a la coincidencia anterior y a la siguiente, respectivamente.

Para cerrar la herramienta buscar y reemplazar, haga clic en O presione esc.

Inspección variable

Para mostrar información sobre una variable definida en un cuaderno de SQL o Python, mantenga el cursor sobre el nombre de la variable. La inspección de variables de Python requiere Databricks Runtime 12.2 LTS o posterior.

Consulte Explorador de Variables.

Ir a la definición

Cuando un cuaderno de Python está asociado a un recurso de proceso, puede ir rápidamente a la definición de una variable, una función, un módulo del sistema o el código subyacente a una %run instrucción .

Para ello, mantenga presionada la tecla Cmd en macOS o la tecla Ctrl en Windows y mantenga el puntero sobre la variable, el nombre de la función o el módulo del sistema. Si se encuentra una definición, el nombre se convierte en un hipervínculo. Haga clic en el vínculo para ir a su definición, que puede abrirse en una nueva pestaña. También puede hacer clic con el botón derecho y, a continuación, hacer clic en Ir a definición o Ver la definición.

La característica "ir a la definición" está disponible en Databricks Runtime 12.2 LTS y versiones posteriores y en un entorno sin servidor 1 y versiones posteriores.

Plegado de código

El plegado de código permite ocultar temporalmente secciones de código. Esto puede resultar útil al trabajar con bloques de código largos, ya que le permite centrarse en secciones específicas del código en las que está trabajando.

Para ocultar el código, coloque el cursor en el extremo izquierdo de una celda. Las flechas que apuntan hacia abajo aparecen en puntos lógicos donde se puede ocultar una sección de código. Haga clic en la flecha para ocultar una sección de código. Vuelva a hacer clic en la flecha (que apunta a la derecha) para mostrar el código.

Para obtener más información, incluidos los métodos abreviados de teclado, consulte la documentación de VS Code.

Compatibilidad con multicursor

Puede crear varios cursores para facilitar las modificaciones simultáneas, como se muestra en el vídeo:

Para crear varios cursores en una celda:

• En macOS, mantenga pulsada la tecla Option y haga clic en cada ubicación para añadir un cursor.
• En Windows, mantenga pulsada la tecla Alt y haga clic en cada ubicación para añadir un cursor.
• También tiene la opción de cambiar el acceso directo. Consulte Cambiar acceso directo para la selección de columnas y varios cursores.

En macOS, puede crear varios cursores alineados verticalmente mediante el método abreviado de teclado Option+Command+ tecla de flecha arriba o abajo.

Selección de columna (cuadro)

Para seleccionar varios elementos en una columna, haga clic en la parte superior izquierda del área que quiere capturar. Then:

• En macOS, presione Shift + Option y arrastre a la parte inferior derecha para capturar una o varias columnas.
• En Windows, presione Shift + Alt y arrastre a la parte inferior derecha para capturar una o varias columnas.
• También tiene la opción de cambiar el acceso directo. Consulte Cambiar acceso directo para la selección de columnas y varios cursores.

Cambiar acceso directo para la selección de columnas y varios cursores

Hay disponible un acceso directo alternativo para la selección de columnas (cuadro) y varios cursores. Con la selección alternativa, los accesos directos cambian de la siguiente manera:

• Para crear varios cursores en una celda:
  • En macOS, mantenga pulsada la tecla Cmd y haga clic en cada ubicación para añadir un cursor.
  • En Windows, mantenga pulsada la tecla Ctrl y haga clic en cada ubicación para añadir un cursor.
• Para seleccionar varios elementos en una columna, haga clic en la parte superior izquierda del área que quiere capturar. Then:
  • En macOS, presione Option y arrastre a la parte inferior derecha para capturar una o varias columnas.
  • En Windows, presione Alt y arrastre a la parte inferior derecha para capturar una o varias columnas.

Para habilitar los accesos directos alternativos, haga lo siguiente:

1. Haga clic en el nombre de usuario en la esquina superior derecha del área de trabajo y, a continuación, haga clic en Configuración en la lista desplegable.
2. En la barra lateral Configuración, seleccione Desarrollador.
3. En la sección Editor de código, cambie la configuración de Modificador clave para el clic de varios cursores a Cmd para macOS o Ctrl para Windows.

Al habilitar métodos abreviados alternativos, el método abreviado de teclado para crear varios cursores alineados verticalmente no cambia.

Examinar datos

Use el explorador de esquemas para explorar los objetos de catálogo de Unity disponibles para el cuaderno. Haga clic en En el lado izquierdo del cuaderno, abra el explorador de esquemas.

El botón For you (Para usted ) muestra solo los objetos que ha usado en la sesión actual o previamente marcados como Favoritos.

A medida que escribe texto en el cuadro Filtro, la presentación cambia para mostrar solo los objetos que contienen el texto que escribe. Solo aparecen los objetos que están abiertos actualmente o que se han abierto en la sesión actual. El cuadro Filtro no realiza una búsqueda completa de los catálogos, esquemas, tablas y volúmenes disponibles para el cuaderno.

Para abrir el , mantenga el cursor sobre el nombre del objeto como se muestra:

Si el objeto es una tabla, puede hacer lo siguiente:

• Cree y ejecute automáticamente una celda para mostrar una vista previa de los datos de la tabla. Seleccione Vista previa en una nueva celda en el menú de kebab de la tabla.
• Vea un catálogo, un esquema o una tabla en el Explorador de catálogos. Seleccione Abrir en Explorador de catálogo en el menú de kebab. Se abre una nueva pestaña que muestra el objeto seleccionado.
• Obtenga la ruta de acceso a un catálogo, un esquema o una tabla. Seleccione Copiar ... ruta de acceso desde el menú de kebab para el objeto.
• Agregue una tabla a Favoritos. Seleccione Agregar objeto a favoritos en el menú de kebab de la tabla.

Si el objeto es un catálogo, un esquema o un volumen, puede copiar la ruta de acceso del objeto o abrirlo en el Explorador de catálogos.

Para insertar un nombre de tabla o columna directamente en una celda:

1. Haga clic en el cursor de la celda en la ubicación en la que desea escribir el nombre.
2. Mueva el cursor sobre el nombre de la tabla o el nombre de columna en el explorador de esquemas.
3. Haga clic en la doble flecha que aparece a la derecha del nombre del objeto.

Uso del terminal web y la CLI de Databricks

Para abrir el terminal web en un cuaderno, haga clic en el icono de terminal en la parte inferior de la barra lateral derecha.

En Databricks Runtime 15.0 y versiones posteriores, puede usar la CLI de Databricks desde el terminal web en un cuaderno. Consulte Ejecución de comandos de shell en el terminal web de Azure Databricks para conocer los requisitos y la información de uso.

No se puede usar la CLI desde una celda de un notebook. En un cuaderno, los comandos como %sh databricks ... no funcionan con Databricks Runtime 15.0 o versiones posteriores.

Autocompletado personalizado

La función de autocompletar completa automáticamente los segmentos de código mientras los escribe. Los objetos completables incluyen tipos, clases y objetos, así como sql database, nombres de tabla, estructuras, mapas, matrices y fragmentos de código de consulta. Al hacer referencia a expresiones de tabla comunes (CTE) que usan SELECT *, autocompletar proporciona recomendaciones de columna basadas en la estructura de tabla subyacente. Databricks usa los metadatos y el uso del catálogo de Unity para personalizar sugerencias.

• En el caso de las celdas de Python, el cuaderno debe asociarse a un recurso de cálculo para que funcione la función de autocompletar y debe ejecutar todas las celdas que definen objetos completables.
• En el caso de las celdas SQL, autocompletar sugiere palabras clave y sintaxis básica incluso si el cuaderno no está asociado a ningún recurso de proceso.
  • Si el área de trabajo está habilitada para Unity Catalog, la función de autocompletar también sugiere nombres de catálogo, esquema, tabla y columna para las tablas en Unity Catalog.
  • Si el área de trabajo no está habilitada para el catálogo de Unity, el cuaderno debe asociarse a un recurso informático de uso general o a un almacén SQL para sugerir nombres de tablas o columnas.

Las sugerencias de la función de autocompletar aparecen automáticamente al escribir en una celda. Use las teclas de dirección arriba y abajo o el mouse para seleccionar una sugerencia y presione Tab o Entrar para insertar la selección en la celda.

Note

La función autocompletar del servidor en cuadernos de R se bloquea durante la ejecución del comando.

Autocompletar está habilitado de forma predeterminada, pero se puede deshabilitar en la configuración de usuario:

• Para desactivar las sugerencias de la función de autocompletar, alterne Autocompletar mientras escribe. Cuando la función de autocompletar está desactivada, puede mostrar sugerencias de la función de autocompletar presionando Ctrl + Espacio.
• Para evitar que Entrar inserte sugerencias de la función de autocompletar, alterne Tecla Entrar acepta sugerencias de la función de autocompletar.

Coincidencia de corchetes

Al hacer clic cerca de un paréntesis, corchete o llave, el editor resalta ese carácter y su corchete coincidente.

Resaltado de errores en Python

Las áreas de trabajo con características de IA potenciadas por socios habilitadas también pueden seleccionar Corregir con asistente para sugerencias asistidas por IA.

Los cuadernos de Databricks admiten el siguiente resaltado de errores:

• Resaltado de errores de sintaxis de Python: los errores de sintaxis de las celdas de código de Python se resaltan en rojo. Si es posible, el Asistente sugerirá una corrección rápida para usted. Esto es compatible con computación ejecutando Databricks Runtime 12.1 y superior o computación sin servidor. Puede configurar el resaltado de errores de sintaxis con pyproject.toml archivos. Consulte Configuración del resaltado de sintaxis de Python.
• Resaltado de errores de formato de Python: los errores de formato de código de Python y las advertencias se subrayan en amarillo o rojo, en función de la gravedad. Esto puede ayudar a identificar problemas de formato, como sangría inesperada, longitud de línea larga, etc. Mantenga el puntero sobre las advertencias de sintaxis para ver más información. Esto es compatible con computación ejecutando Databricks Runtime 12.1 y superior o computación sin servidor.
• Resaltado de errores de tipo de Python: la comprobación de tipos puede mejorar la calidad, la legibilidad y el mantenimiento del código en proyectos de Python y PySpark. Los comprobadores de tipos pueden marcar errores relacionados con atributos no existentes, argumentos que faltan y argumentos no coincidentes en las llamadas de función antes de la ejecución del código. Mantenga el puntero sobre las advertencias resaltadas para ver más información. Esto es compatible con el cómputo que ejecuta Databricks Runtime 16.0 y versiones posteriores, o con el entorno sin servidor 2.

Habilitación del resaltado de errores de Python

Para habilitar o deshabilitar el resaltado de errores, haga lo siguiente:

1. Haga clic en el nombre de usuario en la esquina superior derecha del área de trabajo y, a continuación, haga clic en Configuración en la lista desplegable.
2. En la barra lateral Configuración, seleccione Desarrollador.
3. Cambie la configuración para el resaltado de errores de sintaxis de Python (en editor de código), resaltado de errores de formato de Python (en Características experimentales) o resaltado de errores de tipo de Python (en Características experimentales).

Configuración del resaltado de sintaxis de Python

Cuando un cuaderno está conectado al proceso que ejecuta Databricks Runtime 16.4 o superior o la versión 3 o superior del entorno sin servidor, puede personalizar el comportamiento del resaltado de sintaxis mediante la creación de un archivo pyproject.toml. Para un cuaderno determinado, se usará el archivo pyproject.toml más cercano en su ruta de antecesores directos en el sistema de archivos del espacio de trabajo. Si no se encuentra ninguno en la ruta de los antecesores, se usará un archivo pyproject.toml en la carpeta de inicio del usuario actual.

Por ejemplo, si tiene un cuaderno con la ruta a/b/c/d/notebook.py y hay archivos pyproject.toml en a/b/pyproject.toml y a/b/c/pyproject.toml, entonces se usará el segundo, ya que está más cerca. Un archivo pyproject.toml en /a/b/c/e/pyproject.toml no se tendría en cuenta porque no se encuentra en la ruta de antecesores directos.

Azure Databricks usa la sintaxis estándar para pyproject.toml los archivos. Por ejemplo, puede consultar la documentación de Ruff para ver cómo configurar el linter de Ruff con un pyproject.toml archivo.

Actualmente, Azure Databricks solo admite la configuración de ruff, pylint, pyright y flake8 para linting mediante pyproject.toml.

Para habilitar un linter, el pyproject.toml archivo debe tener un [tool.<name-of-linter>] bloque.

Para desactivar explícitamente un linter, agregue el siguiente bloque:

[tool.<name-of-linter>]
disabled=true

También puede deshabilitar las reglas de resaltado de sintaxis escritas por Azure Databricks con un bloque como:

[tool.databricks]
disabled_rules = ['DB01', 'DB03']

Dado que Flake8 espera una configuración en un formato diferente, debe pasar la configuración de Flake8 como una cadena:

[tool.flake8]
config = """ \
[flake8] \
extend_ignore = E303 \
"""

Personalizar el formato de SQL

Puede personalizar la configuración del formato SQL en el nuevo editor de SQL y en el editor de cuadernos. Haga clic en Ver > configuración del desarrollador. Desplácese hacia abajo hasta Formato SQL y especifique la configuración.

Usar métodos abreviados de teclado

Para mostrar métodos abreviados de teclado, seleccione Ayuda > Métodos abreviados de teclado. Los métodos abreviados de teclado disponibles dependen de si el cursor está en una celda de código (modo de edición) o no (modo de comando).

En las tablas siguientes se muestran los métodos abreviados de teclado disponibles.

Métodos abreviados del modo de edición

Función	Acceso directo de MacOS	Acceso directo de Windows
Cambiar al modo de comando	Esc	Esc
Ejecute el comando e inserte la nueva celda siguiente	Option + Enter	Alt + Enter
Insertar una celda anterior	Ctrl + Option + P	Ctrl + Alt + P
Insertar una celda a continuación	Ctrl + Option + N	Ctrl + Alt + N
Mover a la celda anterior o siguiente	Option + Up/Down	Alt + Up/Down
Dividir una celda en el cursor	Ctrl + Option + -	Ctrl + Alt + -
Eliminar línea actual	⌘ + Shift + K	Ctrl + Shift + K
Eliminar celda actual	Ctrl + Option + D	Ctrl + Alt + D
Subir o a la celda anterior	Up	Up
Bajar o a la celda siguiente	Down	Down
Autocompletar	Ctrl + Space	Ctrl + Space
Autocompletar del Asistente automático	Ctrl + Shift + Space	Ctrl + Shift + Space
Asistente insertado	⌘ + I	Ctrl + I
Sugerencias de parámetro	⌘ + Shift + Space	Ctrl + Shift + Space
Docstring	⌘ + (K, I)	Ctrl + (K, I)
Varios cursores	Option + Click	Alt + Click
Columna (cuadro) seleccionar	Option + Shift + Drag	Alt + Shift + Drag
Sangría/Selección de sangría	⌘ + ]/[	Ctrl + ]/[
Deshacer la escritura	⌘ + Z	Ctrl + Z
Rehacer escritura	⌘ + Shift + Z	Ctrl + Shift + Z
Alternar comentario de línea	⌘ + /	Ctrl + /
Agregar comentario de línea	⌘ + (K, C)	Ctrl + (K, C)
Quitar comentario de línea	⌘ + (K, U)	Ctrl + (K, U)
Edición de varios cursores	⌘ + Option + Up/Down	Ctrl + Option + Up/Down
Aumentar el tamaño de fuente	Option + +	Alt + +
Reducir el tamaño de fuente	Option + -	Alt + -

Métodos abreviados del modo de comando

Función	Acceso directo de Mac OS	Acceso directo de Windows
Cambiar al modo de edición	Enter	Enter
Cancelación de la ejecución de celdas seleccionadas	I, I	I, I
Cancelación de la ejecución (solicitud de omisión)	Shift + (I, I)	Shift + (I, I)
Eliminar celda actual	D, D	D, D
Eliminar celda actual (omitir solicitud)	Shift + (D, D)	Shift + (D, D)
Ir a la primera celda	G, G	G, G
Ir a la última celda	Shift + G	Shift + G
Deshacer cortar o eliminar celdas	⌘ + Z/Z	Ctrl + Z/Z
Copia de la celda actual	⌘ + C	Ctrl + C
Cortar celda actual	⌘ + X	Ctrl + X
Pegar celda	⌘ + V	Ctrl + V
Insertar una celda anterior	A	A
Insertar una celda a continuación	B	B
Alternar salida de celda	O	O
Alternar título de celda	T	T
Desplazarse hacia abajo	Space	Space
Desplazarse hacia arriba	Shift + Space	Shift + Space
Menú alternar métodos abreviados de teclado	H	H
Combinar con la celda siguiente	Shift + M	Shift + M
Mover a la celda anterior	Up/P/K	Up/P/K
Mover a la celda siguiente	Down/N/J	Down/N/J
Agregar celda adyacente a la selección	Shift + Up/Down	Shift + Up/Down
Selección de todas las celdas	⌘ + A	Ctrl + A
Selección de varias celdas	⌘ + Click	Ctrl + Click
Alternar números de línea	L	L
Expandir o contraer encabezados de celda	Right/Left	Right/Left

Accesos directos compartidos

Función	Acceso directo de MacOS	Acceso directo de Windows
Paleta de comandos de alternancia	⌘ + Shift + P	Ctrl + Shift + P
Buscar	⌘ + F	Ctrl + F
Replace	Ctrl + Option + F	Ctrl + Alt + F
Código de formato	⌘ + Shift + F	Ctrl + Shift + F
Ejecute el comando y vaya a la celda siguiente.	Shift + Enter	Shift + Enter
Ejecutar comandos seleccionados	⌘ + Enter	Ctrl + Enter
Celda de depuración	Option + Shift + D	Alt + Shift + D
Depurador: Continuar	F7	F7
Depurador: línea siguiente	F8	F8
Depurador: Paso a paso por instrucciones	F9	F9
Depurador: paso a paso a paso por fuera	Shift + F9	Shift + F9
Ejecución de todos los comandos	Option + Shift + Enter	Alt + Shift + Enter
Ejecutar todos los comandos anteriores (exclusivo)	Option + Shift + Up	Alt + Shift + Up
Ejecutar todos los siguientes comandos (ambos incluidos)	Option + Shift + Down	Alt + Shift + Down
Borrar el estado y las salidas	0, 0	0, 0
Ejecutar texto seleccionado o instrucción activa	Ctrl + Shift + Enter	Ctrl + Shift + Enter
Ejecución de la instrucción SQL activa	⌘ + Shift + Enter	Ctrl + Shift + Enter
Mover una celda hacia arriba	Ctrl + Option + Up	Ctrl + Alt + Up
Bajar una celda	Ctrl + Option + Down	Ctrl + Alt + Down
Alternar panel de comentarios/agregar comentario	Ctrl + Option + M	Ctrl + Alt + M
Panel alternar área de trabajo	Ctrl + Option + E	Ctrl + Alt + E
Alternar el panel de catálogo	Ctrl + Option + C	Ctrl + Alt + C
Panel del asistente de alternancia	Ctrl + Option + A	Ctrl + Alt + A
Alternar el modo de enfoque	Ctrl + Option + O	Ctrl + Alt + O
Cerrar la pestaña actual:	Ctrl + Option + W	Ctrl + Alt + W
Crear nueva pestaña	Ctrl + Option + T	Ctrl + Alt + T
Cambiar a la pestaña izquierda	Ctrl + Option + Left	Ctrl + Alt + Left
Cambiar a la pestaña derecha	Ctrl + Option + Right	Ctrl + Alt + Right
Cerrar todas las pestañas	Ctrl + Option + Shift + A	Ctrl + Alt + Shift + A