Depurador do Transact-SQL – InformaçõesTransact-SQL Debugger - Information

Toda vez que o depurador pausa a execução em uma instrução Transact-SQLTransact-SQL específica, você pode usar as várias janelas do depurador para exibir o estado de execução atual.Every time that the debugger pauses execution on a specific Transact-SQLTransact-SQL statement, you can use the various debugger windows to view the current execution state.

Janelas do depuradorDebugger Windows

Em modo de depurador, o depurador abre duas janelas na parte inferior da janela principal do SQL Server Management StudioSQL Server Management Studio .In debugger mode, the debugger opens two windows at the bottom of the main SQL Server Management StudioSQL Server Management Studio window. O depurador exibe toda as suas informações nessas duas janelas.The debugger displays all its information in these two windows. Cada uma das janelas de depurador tem guias que você pode selecionar para controlar o conjunto de informações exibido na janela.Each of the debugger windows has tabs that you can select to control which set of information is displayed in the window. A janela esquerda do depurador contém as guias Locais, Inspecionar 1, Inspecionar 2, Inspecionar 3e Inspecionar 4 .The left debugger window contains the Locals, Watch1, Watch2, Watch3, and Watch4 tabs. A janela direita do depurador contém as guias Pilha de Chamadas, Threads, Pontos de Interrupção, Janela de Comandoe Saída .The right debugger window contains the Call Stack, Threads, Breakpoints, Command Window, and Output tabs.

Observação

As descrições anteriores aplicam-se aos locais padrões das janelas do depurador.The previous descriptions apply to the default locations of the debugger windows. Você pode arrastar uma guia para movê-la de uma janela para outra ou desencaixar uma guia para criar uma nova janela, que você pode colocar onde desejar.You can drag a tab to move it from one window to another, or you can undock a tab to create a new window that you can put wherever you want.

Por padrão, nem todas essas guias ou janelas são ativas.By default, not all of these tabs or windows are active. Você pode abrir uma janela específica usando qualquer uma das seguintes maneiras:You can open a particular window by using either of the following ways:

  • No menu Depurar , clique em Windowse selecione a janela desejada.On the Debug menu, click Windows, and then select the window you want.

  • Na barra de ferramentas de Depurar , clique em Pontos de Interrupçãoe selecione a janela desejada.On the Debug toolbar, click Breakpoints, and then select the window you want.

Expressões Transact-SQLTransact-SQL Expressions

Expressões são cláusulas Transact-SQLTransact-SQL que são avaliadas como um valor escalar simples, como, por exemplo, variáveis ou parâmetros.Expressions are Transact-SQLTransact-SQL clauses that evaluate to a single, scalar value, such as variables or parameters. A janela esquerda do depurador pode exibir os valores dos dados que são atribuídos no momento a expressões em até cinco guias ou janelas: Locais, Inspecionar 1, Inspecionar 2, Inspecionar 3e Inspecionar 4.The left debugger window can display the data values that are currently assigned to expressions in up to five tabs or windows: Locals, Watch1, Watch2, Watch3, and Watch4.

A janela Locais exibe informações sobre os variáveis locais no escopo atual do depurador Transact-SQLTransact-SQL .The Locals window displays information about the local variables in the current scope of the Transact-SQLTransact-SQL debugger. O conjunto de expressões listadas na janela Locais é alterado à medida que o depurador é executado por meio de partes diferentes do código.The set of expressions that are listed in the Locals window changes as the debugger runs through the different parts of the code.

As expressões no QuickWatch e nas quatro janelas Inspecionar não se limitam apenas a listar o identificador de uma variável.The expressions in the QuickWatch and the four Watch windows are not limited to just listing the identifier of a variable. Você pode especificar uma expressão Transact-SQLTransact-SQL que é avaliada para um único valor, como somar um número para uma variável, ou uma instrução SELECT que é avaliada para um único valor.You can specify a Transact-SQLTransact-SQL expression that evaluates to a single value, such as adding a number to a variable, or a SELECT statement that evaluates to a single value. Os exemplos incluem:Examples include:

  • O nome de uma variável, como @IntegerCounter.</span><span class="sxs-lookup">The name of a variable, such as @IntegerCounter.</span></span>

  • Uma operação aritmética em uma variável, como @IntegerCounter + 1.An arithmetic operation on a variable, such as @IntegerCounter + 1.

  • Uma operação de cadeia de caracteres em duas variáveis de caractere, como @FirstName + @LastName.</span><span class="sxs-lookup">A string operation on two character variables, such as @FirstName + @LastName.</span></span>

  • Uma instrução SELECT que retorna um único valor, como SELECT CharCol FROM MyTable WHERE PrimaryKey = 1.A SELECT statement that returns a single value, such as SELECT CharCol FROM MyTable WHERE PrimaryKey = 1.

    Você pode usar a janela QuickWatch para exibir o valor de uma expressão Transact-SQLTransact-SQL e salvar essa expressão em uma janela Inspeção .You can use the QuickWatch window to view the value of a Transact-SQLTransact-SQL expression, and then save that expression to a Watch window. Para selecionar uma expressão em QuickWatch, selecione ou digite o nome da expressão na caixa Expressão .To select an expression in QuickWatch, either select or enter the name of the expression in the Expression box.

    As quatro janelas Inspecionar exibem informações sobre variáveis e expressões que você selecionou.The four Watch windows display information about variables and expressions that you have selected. O conjunto de expressões listadas nas janelas Inspecionar só será alterado se você adicionar ou excluir expressões da lista.The set of expressions that are listed in the Watch windows does not change until you either add or delete expressions from the list.

    Para adicionar uma expressão a uma janela Inspeção , você pode selecionar Adicionar Inspeção , na caixa de diálogo QuickWatch , ou inserir o nome da expressão na coluna Nome de uma linha vazia em uma janela Inspeção .To add an expression to a Watch window, you can either select Add Watch in the QuickWatch dialog box, or enter the name of the expression in the Name column of an empty row in a Watch window.

    Você pode definir valores de dados para variáveis nas janelas Locais, Inspecionarou QuickWatch , clicando com o botão direito na linha e selecionando Editar Valor.You can set the data values for variables in the Locals, Watch, or QuickWatch windows by right-clicking the row and then selecting Edit Value. As colunas Valor , na janela Locais , janela Inspeção e a caixa de diálogo QuickWatch dão suporte a visualizadores de dados em texto, XML e HTML.The Value columns in the Locals window, Watch window, and QuickWatch dialog box all support text, XML, and HTML data visualizers. Os visualizadores são representados por um dica de dados à direita da coluna Valores .The visualizers are represented by a magnifying glass data tip on the right side end of the Values column. Você pode usar os visualizadores para exibir valores de dados em texto, XML ou HTML em exibições que correspondam aos tipos de dados, por exemplo, exibindo arquivos XML em uma janela do navegador.You can use the visualizers to view text, XML, or HTML data values in displays that match the data types, for example, viewing XML files in a browser window.

    No modo de depuração, quando você move o ponteiro do mouse sobre um identificador, uma pop-up Informações Rápidas é exibida com o nome da expressão e seu valor atual.In debug mode, when you move the mouse pointer over an identifier, a Quick Info pop up is displayed with the name of the expression and its current value. Para obter mais informações, veja Informações rápidas (IntelliSense).For more information, see Quick Info (IntelliSense).

Pontos de interrupçãoBreakpoints

Você pode usar a janela Pontos de Interrupção para exibir e gerenciar os pontos de interrupção definidos no momento.You can use the Breakpoints window to view and manage the currently set breakpoints. Para obter mais informações, veja Percorrer código Transact-SQL.For more information, see Step Through Transact-SQL Code.

Pilhas de ChamadasCall Stacks

A janela Pilha de Chamadas exibe o local de execução atual e informações sobre como a execução foi transmitida da janela do editor original por meio de qualquer módulo do Transact-SQLTransact-SQL (funções, procedimentos armazenados ou gatilhos) para alcançar o local de execução atual.The Call Stack window displays the current execution location, and information about how execution passed from the original editor window through any Transact-SQLTransact-SQL modules (functions, stored procedures, or triggers) to reach the current execution location. Cada linha na janela Pilha de Chamadas é chamada de um registro de ativação e representa qualquer um dos seguintes itens:Each row in the Call Stack window is called a stack frame and represents any one of the following items:

  • O local de execução atual.The current execution location.

  • Uma chamada de um módulo para outro.A call from one module to another.

  • Uma chamada em uma janela do editor para um módulo Transact-SQLTransact-SQL .A call from an editor window to a Transact-SQLTransact-SQL module.

    A ordem da pilha é inversa àquela em que os módulos foram chamados.The order of the stack is the reverse of that in which the modules were called. O local de execução atual é na parte superior da pilha, e a chamada original, na parte inferior.The current execution location is at the top of the stack and the original call at the bottom. Uma seta amarela na margem esquerda do quadro de pilha identifica o quadro no qual o depurador pausou a execução.A yellow arrow on the left margin of the stack frame identifies the frame in which the debugger paused execution.

    A coluna Nome registra as seguintes informações:The Name column records the following information:

  • O módulo de origem que contém a linha de código que chamou para o próximo nível.The source module that contains the line of code that called down to the next level.

  • A linha de código que chamou o próximo módulo na pilha.The line of code that called the next module on the stack.

  • Se a chamada veio de um procedimento armazenado ou de uma função que utilizou os parâmetros, os nomes, os tipos de dados e os valores de todos os parâmetros também são listadas.If the call went to a stored procedure or function that took parameters, the names, data types, and values of all the parameters are also listed.

    As expressões nas janelas Locais, Inspecionare QuickWatch são avaliadas quanto ao registro de ativação atual.The expressions in the Locals, Watch, and QuickWatch windows are evaluated for the current stack frame. Por padrão, o quadro de pilhas atual é o quadro superior da pilha, em que o depurador pausou a execução.By default, the current stack frame is the top frame in the stack, where the debugger paused execution. Quando você especifica outro registro de ativação como o quadro atual, as expressão das janelas Locais, Inspecionare QuickWatch são reavaliadas para o novo registro de ativação.When you specify another stack frame as the current frame, the expressions in the Locals, Watch, and QuickWatch windows are reevaluated for the new stack frame. Você pode alterar o registro de ativação atual clicando duas vezes em um quadro ou clicando em um quadro e selecionando Alternar para Quadro.You can change the current stack frame by either by double-clicking a frame or clicking a frame and selecting Switch To Frame. Nesse ponto, as expressões das janelas Locais, Inspecionare QuickWatch são reavaliadas para o novo quadro.At that point, the expressions in the Locals, Watch, and QuickWatch windows are reevaluated for the new frame. Sempre que um quadro de pilhas atual não está no quadro superior na pilha, uma seta verde na margem esquerda do quadro de pilhas identifica o quadro de pilhas atual.Whenever the current stack frame is not the top frame in the stack, a green arrow on the left margin of the stack frame identifies the current stack frame.

    Quando você clica com o botão direito do mouse no registro de ativação e seleciona Ir para Código-fonte, o código desse quadro é exibido em uma janela do Editor de Consultas.When you right-click a stack frame and select Go To Source Code, the code for that frame is displayed in a Query Editor window. No entanto, esse quadro não se transforma no quadro atual, e o conteúdo das janelas Locais, Inspecionare QuickWatch não é alterado.However, that frame is not made the current frame, and the contents of the Locals, Watch, and QuickWatch windows are not changed.

Informações do sistema e resultados de Transact-SQLSystem Information and Transact-SQL Results

O depurador lista seu status e mensagens de evento na janela Saída .The debugger lists its status and event messages in the Output window. Isso inclui informações, como, por exemplo, quando o depurador é anexado a outros processos ou quando o thread do depurador termina.This includes information such as when the debugger attaches to other processes or when debugger threads end.

Em modo de depuração, as guias Resultados e Mensagens ainda ficam ativas no Editor de Consultas.While in debug mode, the Results and Messages tabs are still active in the Query Editor. A guia Resultados continua a exibir os conjuntos de resultados das instruções Transact-SQLTransact-SQL que são executados durante uma sessão de depuração.The Results tab continues to display the result sets from the Transact-SQLTransact-SQL statements that are executed during a debugging session. A guia Mensagens continua a exibir mensagens de sistema, como, por exemplo, xx Linhas Afetadas e a saída de instruções PRINT e RAISERROR.The Messages tab continues to display system messages, such as xx Rows Affected and the output of PRINT and RAISERROR statements.

Consulte tambémSee Also

Janela Locais Locals Window
Janela de Observação Watch Window
Caixa de diálogo QuickWatch QuickWatch Dialog Box
Janela Pontos de Interrupção Breakpoints Window
Janela Pilha de Chamadas Call Stack Window
Janela Threads Threads Window
Janela Saída Output Window
Depurador do Transact-SQL Transact-SQL Debugger