Uso del depurador interactivo de Databricks

Importante

Esta característica está en versión preliminar pública.

En esta página se describe cómo usar el depurador interactivo integrado en el cuaderno de Databricks. El depurador solo está disponible para Python.

El depurador interactivo proporciona puntos de interrupción, ejecución paso a paso, inspección de variables y más herramientas para ayudarle a desarrollar código en cuadernos de forma más eficaz.

Requisitos

El cuaderno debe estar asociado a un clúster que cumpla los siguientes requisitos:

• Databricks Runtime versión 13.3 LTS o posterior.
• El modo de acceso debe ser Usuario único (asignado) o Sin aislamiento compartido.

Habilitación o deshabilitación del depurador

Para habilitar o deshabilitar el depurador, haga lo siguiente:

1. Haga clic en el nombre de usuario en la esquina superior derecha del área de trabajo y seleccione Configuración en la lista desplegable.
2. En la barra lateral Configuración, seleccione Desarrollador.
3. En la sección Características experimentales, active el Depurador interactivo de cuaderno de Python.

Iniciar el depurador

Para iniciar el depurador, siga estos pasos:

1. Agregue uno o varios puntos de interrupción haciendo clic en el margen de una celda. Para eliminar un punto de interrupción, vuelva a hacer clic en él.

   

2. Realice una de las siguientes acciones:

   • Haga clic en Ejecutar > Depurar celda.
   • Use el método abreviado de teclado Opción + Mayús + D.
   • En el menú para ejecutar una celda, seleccione Depurar celda.

   

Se inicia automáticamente una sesión de depuración y se ejecuta la celda seleccionada.

También puede iniciar el depurador si una celda desencadena un error. En la parte inferior de la salida de la celda, haga clic en .

Cuando una sesión de depuración está activa, la barra de herramientas de depuración aparece en la parte superior de la celda.

Uso del depurador

En una sesión de depuración, puede hacer lo siguiente:

• Establecer o eliminar puntos de interrupción.
• Ver los valores de las variables en un punto de interrupción.
• Recorra el código.
• Entrar o salir de una función.

Cuando el código alcanza un punto de interrupción, se detiene antes de que se ejecute la línea, no después.

Use los botones de la barra de herramientas del depurador para ir pasando por el código. A medida que vaya pasando por el código, la línea actual se resalta en la celda. Puede ver los valores de las variables en el panel del explorador de variables, en la barra lateral derecha.

Al pasar por una función, las variables de función locales aparecen en el panel de variables, marcadas como [local].

Uso de la consola de depuración

Al iniciar una sesión de depuración, la consola de depuración aparece automáticamente en el panel inferior. Esta consola permite ejecutar código de Python para inspeccionar o manipular variables cuando se pausan en un punto de interrupción. El código ejecutado en el cuaderno principal no se ejecuta durante una sesión de depuración. Para ejecutar código en la consola, presione Entrar. Para las expresiones de varias líneas, use Mayús + Entrar para pasar a una nueva línea.

Nota:

• La consola de depuración está diseñada para evaluaciones rápidas y agota el tiempo de espera si la ejecución del código supera los 15 segundos.
• El comando display no se admite en la consola de depuración. Para ver datos de ejemplo de un DataFrame, use df.show() para DataFrames de PySpark o df.head() para DataFrames de Pandas.

Uso del explorador de variables

Puede usar el panel del explorador de variables en el lado derecho para ver los valores de las variables. Al hacer clic en Inspeccionar, se ejecuta código automáticamente en la consola de depuración para generar el valor de la variable.

Finalizar una sesión del depurador

Para finalizar la sesión de depuración, haga clic en en la parte superior izquierda de la celda o haga clic en en la parte superior del cuaderno. La sesión de depuración también finaliza automáticamente después de 30 minutos si el usuario no usa la barra de herramientas de depuración o la consola de depuración.

Limitaciones

Para más información, consulte Limitaciones conocidas de los cuadernos de Databricks.