Depurador de Transact-SQL

Se aplica a:SQL Server

El depurador de Transact-SQL ayuda a buscar errores en el código de Transact-SQL mediante la investigación del comportamiento del código en tiempo de ejecución. Después de establecer la ventana del Editor de consultas de Motor de base de datos en el modo de depuración, puede detener la ejecución de líneas específicas de código e inspeccionar la información y los datos usados por las instrucciones Transact-SQL o devueltos por ellas.

Esta característica funciona con la versión 17.9.1 de SSMS y versiones anteriores. La depuración de T-SQL también está disponible en SQL Server Data Tools para Visual Studio.

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

El depurador de Transact-SQL proporciona las opciones siguientes que puede usar para navegar por el código Transact-SQL cuando la ventana del Editor de consultas del Motor de base de datos esté en el modo de depuración:

• Establecer puntos de interrupción en instrucciones Transact-SQL individuales.

  Un punto de interrupción especifica un punto en el que desea que la ejecución se pause para poder examinar los datos. Cuando inicie el depurador, se detiene en la primera línea de código de la ventana del Editor de consultas. Para ejecutar el primer punto de interrupción que haya establecido, puede usar la característica Continuar . Asimismo puede usar esta característica para ejecutar el siguiente punto de interrupción desde cualquier ubicación en la que esté detenida la ventana. Puede modificar los puntos de interrupción para especificar acciones como las condiciones en las que el punto de interrupción debe pausar la ejecución, la información que se va a imprimir en la ventana de resultados y para cambiar la ubicación del punto de interrupción.

• Ir a la siguiente instrucción.

  Esta opción permite navegar por un conjunto de instrucciones de una en una, así como observar su comportamiento a medida que avanza.

• Ir a una llamada o recorrerla paso a paso en un procedimiento almacenado o función.

  Si está seguro de que no hay errores en un procedimiento almacenado, puede omitirlo. El procedimiento se ejecuta completo y los resultados se devuelven en el código.

  Si desea depurar una procedimiento almacenado o una función, puede depurar paso a paso por instrucciones el módulo. SQL Server Management Studio abre una nueva ventana del Editor de consultas de Motor de base de datos que se rellena con el código fuente del módulo, pone la ventana en el modo de depuración y, después, detiene la ejecución en la primera instrucción del módulo. Después puede navegar por el código del módulo, por ejemplo, estableciendo puntos de interrupción o recorriendo el código.

Para obtener más información sobre cómo el depurador le permite navegar por el código, vea Avanzar paso a paso por el código Transact-SQL.

Visualización de la información del depurador

Siempre que el depurador detenga la ejecución de una instrucción Transact-SQL específica, puede usar las ventanas del depurador siguientes para ver el estado de la ejecución actual:

• Variables locales e Inspección. Estas ventanas muestran las expresiones Transact-SQL actualmente asignadas. Las expresiones son cláusulas de Transact-SQL que se evalúan en una expresión escalar única. El depurador de Transact-SQL admite la visualización de expresiones que hagan referencia a las variables, parámetros o funciones integradas de Transact-SQL que tengan nombres que empiecen por @@. Estas ventanas también muestran los valores de los datos asignados actualmente a las expresiones.

• Inspección rápida. Esta ventana muestra el valor de una expresión Transact-SQL y permite guardarla en una ventana Inspección.

• Puntos de interrupción. Esta ventana muestra los puntos de interrupción establecidos actualmente y permite administrarlos.

• Pila de llamadas. Esta ventana muestra la ubicación de ejecución actual. Además, proporciona información sobre el paso de la ejecución desde la ventana del Editor de consultas por las funciones, procedimientos administrados o desencadenadores hasta llegar a la ubicación de ejecución actual.

• Salida. Esta ventana muestra diferentes mensajes y datos del programa, como mensajes del sistema enviados desde el depurador.

• Resultados y Mensajes. Estas pestañas de la ventana Editor de consultas muestran el resultado de las instrucciones Transact-SQL previamente ejecutadas.

Tareas del depurador de Transact-SQL

Consulte también

Editores de consultas y texto (SQL Server Management Studio)