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.

La depuración de T-SQL 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 hasta el primer punto de interrupción, use Continuar. Asimismo, puede usar Continuar para ejecutar hasta 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 Salida 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. Se abre una nueva ventana del editor de Power Query del Motor de base de datos que se rellena con el código fuente del módulo. La ventana está en el modo de depuración y la ejecución se detiene 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

Descripción de la tarea	Artículo
Describe cómo configurar el depurador de Transact-SQL para realizar la depuración remota.	Configuración de reglas de firewall antes de ejecutar el depurador de Transact-SQL
Describe cómo iniciar, detener y controlar el funcionamiento del depurador.	Ejecutar el depurador de Transact-SQL
Describe cómo utilizar el depurador de Transact-SQL para recorrer el código.	Avanzar paso a paso por el código Transact-SQL
Describe cómo utilizar el depurador de Transact-SQL para recorrer el código de procedimiento almacenado.	Depuración de procedimientos almacenados
Describe cómo utilizar el depurador para ver los datos de Transact-SQL, como los parámetros y las variables, así como la información del sistema.	Ver información del depurador de Transact-SQL