Avanzar paso a paso por el código Transact-SQL

El depurador de Transact-SQL permite controlar las instrucciones Transact-SQL que se ejecutan en una ventana del Editor de consultas de Motor de base de datos. Puede detener el depurador en instrucciones individuales y, a continuación, ver el estado de los elementos de código en ese punto.

Puntos de interrupción

Un punto de interrupción indica al depurador que detenga la ejecución en una instrucción Transact-SQL específica. El acto de establecer un punto de interrupción en una instrucción se denomina alternar un punto de interrupción. Puede alternar un punto de interrupción en una instrucción Transact-SQL seleccionando la instrucción y realizando una de las siguientes acciones:

  • Presione F9.

  • En el menú Depurar, haga clic en Alternar punto de interrupción.

  • En la ventana del Editor de consultas, haga clic en la barra gris situada a la izquierda de la instrucción Transact-SQL que desee.

Para ver y administrar todos los puntos de interrupción abiertos, puede usar la ventana Puntos de interrupción. Esta ventana muestra información como la línea de código en la que está ubicado el punto de interrupción. Además en ella, puede eliminar, deshabilitar y habilitar los puntos de interrupción. Para obtener más información sobre la ventana Puntos de interrupción, vea Ventana de puntos de interrupción.

Puede abrir la ventana Puntos de interrupción de una de las siguientes formas:

  • En el menú Depurar, haga clic en Ventanas y, a continuación, en Puntos de interrupción.

  • En la barra de herramientas Depurar, haga clic en el botón Puntos de interrupción.

  • Presione CTRL+ALT+B.

Puede deshabilitar temporalmente un punto de interrupción. De esta forma, evita que el punto de interrupción detenga la ejecución, pero deja la definición en su lugar en caso de que desee volver a habilitar el punto de interrupción posteriormente.

La tabla siguiente muestra las distintas formas en las que puede deshabilitar, volver a habilitar y eliminar puntos de interrupción.

Acción

Procedimiento

Deshabilitar un punto de interrupción individual

  • En la ventana del Editor de consultas, haga clic con el botón secundario y, a continuación, haga clic en Deshabilitar punto de interrupción.

  • En la ventana Puntos de interrupción, desactive la casilla situada a la izquierda del punto de interrupción.

Deshabilitar todos los puntos de interrupción

  • En el menú Depurar, haga clic en Deshabilitar todos los puntos de interrupción.

  • En la barra de herramientas de la ventana Puntos de interrupción, haga clic en el botón Deshabilitar todos los puntos de interrupción.

Volver a habilitar un punto de interrupción individual

  • En la ventana del Editor de consultas, haga clic con el botón secundario y, a continuación, haga clic en Habilitar punto de interrupción.

  • En la ventana Puntos de interrupción, active la casilla situada a la izquierda del punto de interrupción.

Volver a habilitar todos los puntos de interrupción deshabilitados

  • En el menú Depurar, haga clic en Habilitar todos los puntos de interrupción.

  • En la barra de herramientas de la ventana Puntos de interrupción, haga clic en el botón Habilitar todos los puntos de interrupción.

Eliminar un punto de interrupción individual

  • En la ventana del Editor de consultas, haga clic con el botón secundario y, a continuación, haga clic en Eliminar punto de interrupción.

  • En la ventana Puntos de interrupción, haga clic con el botón secundario en el punto de interrupción y, a continuación, haga clic en el comando Eliminar del menú contextual.

  • En la ventana Puntos de interrupción, seleccione el punto de interrupción y, a continuación, presione SUPR.

Eliminar todos los puntos de interrupción

  • En el menú Depurar, haga clic en Eliminar todos los puntos de interrupción.

  • En la barra de herramientas de la ventana Puntos de interrupción, haga clic en el botón Eliminar todos los puntos de interrupción.

Nota

El depurador de Transact-SQL no es compatible con las características de Microsoft Visual Studio de establecimiento de condiciones de puntos de interrupción ni recuentos de visitas.

Controlar la ejecución de instrucciones

En el depurador de Transact-SQL, puede especificar las siguientes opciones para su ejecución desde la instrucción actual del código Transact-SQL:

  • Ejecutar un proceso hasta el siguiente punto de interrupción.

  • Ir a la siguiente instrucción.

    Si la siguiente instrucción invoca un procedimiento almacenado, función o desencadenador de Transact-SQL, el depurador muestra una nueva ventana del Editor de consultas que contiene el código del módulo. La ventana está en el modo de depuración y la ejecución se detiene en la primera instrucción del mismo. Después puede desplazarse por el código del módulo, por ejemplo, estableciendo puntos de interrupción o recorriendo el código.

  • Paso a paso por la siguiente instrucción.

    Se ejecuta la siguiente instrucción. Sin embargo, si la instrucción invoca un procedimiento almacenado, una función o un desencadenador, el código del módulo se ejecuta hasta que termine y los resultados se devuelven al código de llamada. Si está seguro de que no hay errores en un procedimiento almacenado, puede omitirlo. La ejecución se detiene en la instrucción que sigue a la llamada al procedimiento almacenado, a la función o al desencadenador.

  • Salir de un procedimiento almacenado, función o desencadenador.

    La ejecución se detiene en la instrucción que sigue a la llamada al procedimiento almacenado, a la función o al desencadenador.

  • Ejecutar el proceso desde la ubicación actual hasta la ubicación actual del puntero e ignorar todos los puntos de interrupción.

La tabla siguiente muestra las distintas formas en las que puede controlar la ejecución de las instrucciones del depurador de Transact-SQL.

Acción

Procedimiento

Ejecutar todas las instrucciones desde la instrucción actual hasta el siguiente punto de interrupción

  • En el menú Depurar, haga clic en Continuar.

  • En la barra de herramientas Depurar, haga clic en el botón Continuar.

Ir a la siguiente instrucción o módulo

  • En el menú Depurar, haga clic en Paso a paso por instrucciones.

  • En la barra de herramientas Depurar, haga clic en el botón Paso a paso por instrucciones.

  • Presione F11.

Paso a paso por la siguiente instrucción o módulo

  • En el menú Depurar, haga clic en Paso a paso por procedimientos.

  • En la barra de herramientas Depurar, haga clic en el botón Paso a paso por procedimientos.

  • Presione F10.

Salir de un módulo

  • En el menú Depurar, haga clic en Paso a paso para salir.

  • En la barra de herramientas Depurar, haga clic en el botón Paso a paso para salir.

  • Presione MAYÚS+F11.

Ejecutar un proceso hasta la ubicación del cursor actual

  • Haga clic con el botón secundario en la ventana del Editor de consultas y, a continuación, haga clic en Ejecutar hasta el cursor.

  • Presione CTRL+F10.