Depurador de Transact-SQLTransact-SQL debugger

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions)

El depurador de Transact-SQLTransact-SQL ayuda a buscar errores en el código de Transact-SQLTransact-SQL mediante la investigación del comportamiento en tiempo de ejecución del código.The Transact-SQLTransact-SQL debugger helps you find errors in Transact-SQLTransact-SQL code by investigating the run-time behavior of the code. Después de establecer la ventana del Editor de consultas de Motor de base de datosDatabase Engine 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-SQLTransact-SQL o devueltos por ellas.After you set the Motor de base de datosDatabase Engine Query Editor window to debug mode, you can pause execution on specific lines of code and inspect information and data that is used by or returned by those Transact-SQLTransact-SQL statements.

Esta característica funciona con la versión 17.9.1 de SSMS y versiones anteriores.This feature works with SSMS version 17.9.1 and earlier.

Avance paso a paso por el código Transact-SQLStepping through Transact-SQL Code

El depurador de Transact-SQLTransact-SQL proporciona las siguientes opciones que puede usar para navegar por el código Transact-SQLTransact-SQL cuando la ventana del Editor de consultas de Motor de base de datosDatabase Engine esté en el modo de depuración:The Transact-SQLTransact-SQL debugger provides the following options that you can use to navigate through Transact-SQLTransact-SQL code when the Motor de base de datosDatabase Engine Query Editor window is in debug mode:

  • Establecer puntos de interrupción en instrucciones Transact-SQLTransact-SQL individuales.Set breakpoints on individual Transact-SQLTransact-SQL statements.

    Un punto de interrupción especifica un punto en el que desea que la ejecución se pause para poder examinar los datos.A breakpoint specifies a point at which you want execution to pause so you can examine data. Cuando inicie el depurador, se detiene en la primera línea de código de la ventana del Editor de consultas.When you start the debugger, it pauses on the first line of code in the Query Editor window. Para ejecutar el primer punto de interrupción que haya establecido, puede usar la característica Continuar .To run to the first breakpoint that you have set, you can use the Continue feature. 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.You can also use the Continue feature to run to the next breakpoint from any location at which the window is currently paused. 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.You can edit breakpoints to specify actions such as the conditions under which the breakpoint should pause execution, information to print to the output window, and change the location of the breakpoint.

  • Ir a la siguiente instrucción.Step into the next statement.

    Esta opción permite navegar por un conjunto de instrucciones de una en una, así como observar su comportamiento a medida que avanza.This option enables you to navigate through a set of statements one by one, and to observe their behavior as you go.

  • Ir a una llamada o recorrerla paso a paso en un procedimiento almacenado o función.Step either into or over a call to a stored procedure or function.

    Si está seguro de que no hay errores en un procedimiento almacenado, puede omitirlo.If you're sure there are no errors in a stored procedure, you can step over it. El procedimiento se ejecuta completo y los resultados se devuelven en el código.The procedure is executed in full, and the results are returned to the code.

    Si desea depurar una procedimiento almacenado o una función, puede depurar paso a paso por instrucciones el módulo.If you want to debug a stored procedure or function, you can step into the module. SQL Server Management StudioSQL Server Management Studio abre una nueva ventana del Editor de consultas de Motor de base de datosDatabase Engine que se rellena con el código fuente del módulo, pone la ventana en el modo de depuración y, a continuación, detiene la ejecución en la primera instrucción del módulo.opens a new Motor de base de datosDatabase Engine Query Editor window that is populated with the source code for the module, places the window into debug mode, and then pauses execution on the first statement in the module. Después puede navegar por el código del módulo, por ejemplo, estableciendo puntos de interrupción o recorriendo el código.You can then navigate through the module code, for example, by setting breakpoints or stepping through the code.

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.For more information about how the debugger enables you to navigate code, see Step Through Transact-SQL Code.

Visualización de la información del depuradorViewing debugger information

Siempre que el depurador detenga la ejecución de una instrucción Transact-SQLTransact-SQL específica, puede usar las siguientes ventanas del depurador para ver el estado de la ejecución actual:Each time the debugger pauses execution on a specific Transact-SQLTransact-SQL statement, you can use the following debugger windows to view the current execution state:

  • Variables locales e Inspección.Locals and Watch. Estas ventanas muestran las expresiones de Transact-SQLTransact-SQL asignadas actualmente.These windows display currently allocated Transact-SQLTransact-SQL expressions. Las expresiones son cláusulas de Transact-SQLTransact-SQL que se evalúan en una sola expresión escalar.Expressions are Transact-SQLTransact-SQL clauses that evaluate to a single, scalar expression. El depurador de Transact-SQLTransact-SQL admite la visualización de expresiones que hagan referencia a las variables, parámetros o funciones integradas de Transact-SQLTransact-SQL que tengan nombres que empiecen por @@.The Transact-SQLTransact-SQL debugger supports viewing expressions that reference Transact-SQLTransact-SQL variables, parameters, or the built-in functions that have names that start with @@. Estas ventanas también muestran los valores de los datos asignados actualmente a las expresiones.These windows also display the data values that are currently assigned to the expressions.

  • Inspección rápida.QuickWatch. Esta ventana muestra el valor de una expresión de Transact-SQLTransact-SQL y permite guardarla en una ventana Inspección .This window displays the value of a Transact-SQLTransact-SQL expression, and enables saving that expression to a Watch window.

  • Puntos de interrupción.Breakpoints. Esta ventana muestra los puntos de interrupción establecidos actualmente y permite administrarlos.This window displays the currently set breakpoints and enables you to manage them.

  • Pila de llamadas.Call Stack. Esta ventana muestra la ubicación de ejecución actual.This window displays the current execution location. 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.And also provides information about how execution passed from the original Query Editor window through any functions, stored procedures, or triggers to reach the current execution location.

  • Resultados.Output. Esta ventana muestra diferentes mensajes y datos del programa, como mensajes del sistema enviados desde el depurador.This window displays various messages and program data, such as system messages from the debugger.

  • Resultados y Mensajes.Results and Messages. Estas pestañas de la ventana del Editor de consultas muestran el resultado de las instrucciones de Transact-SQLTransact-SQL ejecutadas previamente.These tabs on the Query Editor window display the results of previously executed Transact-SQLTransact-SQL statements.

Tareas del depurador de Transact-SQLTransact-SQL debugger tasks

Descripción de la tareaTask Description TemaTopic
Describe cómo configurar el depurador de Transact-SQLTransact-SQL para realizar la depuración remota.Describes how to configure the Transact-SQLTransact-SQL debugger for remote debugging. Configurar reglas de firewall antes de ejecutar al depurador de TSQLConfigure firewall rules before running the TSQL Debugger
Describe cómo iniciar, detener y controlar el funcionamiento del depurador.Describes how to start, stop, and control the operation of the debugger. Ejecutar el depurador de Transact-SQLRun the Transact-SQL Debugger
Describe cómo utilizar el depurador de Transact-SQLTransact-SQL para recorrer el código.Describes how to use the Transact-SQLTransact-SQL debugger to step through code. Avanzar paso a paso por el código Transact-SQLStep Through Transact-SQL Code
Describe cómo utilizar el depurador para ver los datos de Transact-SQLTransact-SQL , como los parámetros y las variables, así como la información del sistema.Describes how to use the debugger to view Transact-SQLTransact-SQL data, such as parameters and variables, and system information. Ver información del depurador de Transact-SQLTransact-SQL Debugger Information

Consulte tambiénSee also

Editores de consultas y texto (SQL Server Management Studio)Query and Text Editors (SQL Server Management Studio)