Compartir vía


Información del depurador de Transact-SQL

Se aplica a: SQL Server

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

Ventanas del depurador

En el modo de depuración, el depurador abre ventanas junto a la ventana del editor de Power Query. El depurador muestra su información en las ventanas seleccionadas. Cada una de ellas tiene pestañas que puede seleccionar para controlar el conjunto de información que se muestra en la ventana. Las pestañas Pila de llamadas, Puntos de interrupción, Configuración de excepciones y Salida se encuentran en una ventana. Las pestañas Watch1, Watch2, Watch3 y Watch4 se encuentran en una ventana. Las ventanas Subprocesos y Variables locales se muestran por separado.

Nota:

Las descripciones anteriores se aplican a las ubicaciones predeterminadas de las ventanas del depurador. Puede arrastrar una pestaña para moverla de una ventana a otra, o puede desacoplar una pestaña para crear una nueva ventana para las pestañas seleccionadas.

De forma predeterminada, no todas estas pestañas o ventanas están activas. Para abrir una ventana determinada, en el menú Depurar, seleccione Ventanas y, a continuación, seleccione la ventana que desea ver.

Expresiones de Transact-SQL

Las expresiones son cláusulas de Transact-SQL que se evalúan en un único valor escalar, como las variables o los parámetros. La ventana del depurador puede mostrar los valores de datos asignados actualmente a expresiones en un máximo de cinco pestañas o ventanas: Variables locales, Inspección1, Inspección2, Inspección3e Inspección4.

La ventana Variables locales muestra información sobre las variables locales del ámbito actual del depurador de Transact-SQL. El conjunto de expresiones que se muestran en esta ventana cambia a medida que el depurador se ejecuta en las distintas partes del código.

Las expresiones de las cuatro ventanas Watch no se limitan únicamente a enumerar el identificador de una variable. Puede especificar una expresión de Transact-SQL que se evalúa como un valor único, por ejemplo, agregar un número a una variable, o una instrucción SELECT que se evalúa como un valor único. Algunos ejemplos son:

  • El nombre de una variable, como @IntegerCounter.

  • Una operación aritmética en una variable, como @IntegerCounter + 1.

  • Una operación de cadena con dos variables de carácter, como @FirstName + @LastName.

  • Una instrucción SELECT que devuelve un valor único, como SELECT CharCol FROM MyTable WHERE PrimaryKey = 1.

Las cuatro ventanas Watch (inspección) muestran información sobre las variables y las expresiones seleccionadas. El conjunto de expresiones que se muestran en estas ventanas no cambian hasta que agregue o elimine expresiones desde la lista.

Para agregar una expresión a una ventana Watch (inspección), escriba el nombre de la expresión en la columna Name (nombre) de una fila vacía en una ventana Watch. También puede seleccionar QuickWatch (inspección rápida) en el menú Depurar, introducir una expresión y, a continuación, seleccionar Add Watch (agregar inspección).

Puede establecer los valores de datos de las variables en las ventanas Variables locales, Inspeccióno Inspección rápida ; para ello, haga clic con el botón derecho en la fila y, después, seleccione Editar valor. La columna Valor de la ventana Variables locales , la ventana Inspección y el cuadro de diálogo Inspección rápida admiten visualizadores de texto, de datos XML y HTML. Los visualizadores se representan mediante una sugerencia de datos de lupa en el extremo derecho de la ventana Valores . Puede usar los visualizadores para ver texto, valores de datos XML o HTML en presentaciones que hagan coincidir los tipos de valores, por ejemplo, ver archivos XML en la ventana de un explorador.

En modo de depuración, al mover el puntero sobre un identificador, aparece la ventana emergente Quick Info con el nombre de la expresión y su valor actual. Para obtener más información, consulte Información rápida (IntelliSense).

Puntos de interrupción

Puede utilizar la ventana Puntos de interrupción para ver y administrar los puntos de interrupción. Para obtener más información, vea Avanzar paso a paso por el código Transact-SQL.

Pilas de llamadas

La ventana Pila de llamadas muestra la ubicación de ejecución actual, así como información sobre el paso de la ejecución desde la ventana del editor original a través de cualquier módulo de Transact-SQL (funciones, procedimientos almacenados o desencadenadores) hasta llegar a la ubicación de ejecución actual. Todas las filas de la ventana Pila de llamadas se denominan marco de pila y representan cualquiera de los siguientes elementos:

  • Ubicación de ejecución actual.

  • Llamada de un módulo a otro.

  • Llamada de una ventana del editor a un módulo de Transact-SQL.

El orden de la pila es el inverso del orden en el que se llamó a los módulos. La ubicación de ejecución actual está en la parte superior de la pila y la llamada original en la inferior. Una flecha amarilla en el margen izquierda del marco de pila identifica el marco en el que el depurador detuvo la ejecución.

La columna Nombre registra la siguiente información:

  • El módulo de origen que contiene la línea de código que invocó el siguiente nivel.

  • La línea de código que llamó al siguiente módulo de la pila.

  • Si la llamada se dirigió a un procedimiento almacenado o a una función que tomó parámetros, se muestran los nombres, tipos de datos y valores de todos los parámetros.

Las expresiones de las ventanas Locals (variables locales), Watch (inspección) y QuickWatch (inspección rápida) se evalúan para el marco de pila actual. De forma predeterminada, este marco es el marco superior de la pila, en el que el depurador detuvo la ejecución. Cuando especifique otro marco de pila como marco actual, las expresiones de las ventanas Variables locales, Inspeccióne Inspección rápida se vuelven a evaluar para el nuevo marco de pila. Puede cambiar el marco de pila actual haciendo doble clic en un marco o haciendo clic en un marco y seleccionando Cambiar a marco. En ese punto, las expresiones de las ventanas Variables locales, Inspeccióne Inspección rápida se vuelven a evaluar para el nuevo marco. Cuando el marco de pila actual no sea el marco superior de la pila, una flecha verde situada en el margen izquierdo del marco de pila identifica el marco de pila actual.

Al hacer clic con el botón derecho en un marco de pila y seleccionar Ir a código fuente, se muestra el código del marco en una ventana del Editor de consultas. Sin embargo, ese marco no es el marco actual y no se modifica el contenido de las ventanas Variables locales, Inspeccióne Inspección rápida.

Información del sistema y resultados de Transact-SQL

El depurador muestra su estado y los mensajes de eventos en la ventana Resultados . La ventana incluye información como el momento en que el depurador se adjunta a otros procesos o cuándo finalizan los subprocesos del depurador.

En el modo de depuración, las pestañas Resultados y Mensajes continúan estando activas en el Editor de consultas. La pestaña Resultados continúa mostrando los conjuntos de resultados de las instrucciones Transact-SQL que se ejecutan durante una sesión de depuración. La pestaña Mensajes continúa mostrando los mensajes del sistema, como el número de filas afectadas y el resultado de las instrucciones PRINT y RAISERROR.