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ú.

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).

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.

Buscar y reemplazar texto

Para buscar y reemplazar texto en un cuaderno, seleccione Editar > Buscar y reemplazar. La coincidencia actual se resalta en naranja y todas las demás coincidencias se resaltan en amarillo.

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 moverse entre coincidencias, haga clic en los botones Prev (Anterior) y Next (Siguiente). También puede presionar Mayús+Entrar y Entrar para ir a las coincidencias anteriores y siguientes, respectivamente.

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

Inspección de variables

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 o el código subyacente a una %run instrucción . Para ello, haga clic con el botón derecho en la variable o el nombre de la función y, a continuación, haga clic en Ir a la definición o Ver la definición.

Mantenga pulsada la tecla Cmd en macOS o la tecla Ctrl en Windows y pase el ratón por encima del nombre de la variable o función. Si se encuentra una definición, el nombre se convierte en un hipervínculo.

La característica “ir a definición” está disponible en Databricks Runtime 12.2 LTS 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 varios cursores

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. A continuación:

• 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. A continuación:
  • 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.

Explorar datos

Use el explorador de esquemas para explorar los objetos de catálogo de Unity disponibles para el cuaderno. Haga clic en el icono de datos en el lado izquierdo del cuaderno para abrir 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 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 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, podrá usar la CLI de Databricks desde el terminal web en el cuaderno.

Requisitos

• El cuaderno debe estar asociado a un recurso de proceso en modo de acceso Dedicado (anteriormente usuario único) o Sin aislamiento compartido.
• 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 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 tipo, clase y objeto, así como base de datos SQL, nombre de tabla y fragmento de consulta. 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.

Nota:

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

Hay dos configuraciones de usuario a tener en cuenta:

• 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 de Python

Las áreas de trabajo con Databricks Assistant habilitado también pueden seleccionar Corregir con Asistente para obtener 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 más pyproject.toml cercano en su ruta de acceso antecesora directa en el sistema de archivos del área de trabajo. Si no se encuentra uno en la ruta de acceso de los ancestros, se usará un pyproject.toml archivo en el directorio principal del usuario actual.

Por ejemplo, si tiene un cuaderno con la ruta de acceso a/b/c/d/notebook.py y hay pyproject.toml archivos en a/b/pyproject.toml y a/b/c/pyproject.toml , a continuación, se usará el segundo, ya que está más cerca. No se consideraría un pyproject.toml archivo en /a/b/c/e/pyproject.toml porque no está en la ruta de acceso antecesora directa .

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 deshabilitar 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.