Uso del depurador interactivo de Databricks

  • Artículo

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.

    vídeo de creación y eliminación de puntos de interrupción

  2. Realice una de las siguientes acciones:

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

    elemento de depuración de celdas en el menú de ejecución de celdas

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 Botón Depurar.

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

Uso del depurador

barra de herramientas del depurador anotado

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

Finalizar una sesión del depurador

Para finalizar la sesión de depuración, haga clic en botón de detención del depurador en la parte superior izquierda de la celda o haga clic en botón de detención del cuaderno en la parte superior del cuaderno.

Limitaciones

  • El depurador solo funciona con Python. No admite Scala ni R.
  • El depurador no funciona en clústeres de modo de acceso Compartido.
  • El depurador no admite depurar paso a paso por instrucciones en módulos o archivos externos.
  • Cuando una sesión de depuración está activa, no se pueden ejecutar otros comandos en el cuaderno.