Informações do depurador Transact-SQL

Aplica-se a:SQL Server

Sempre que o depurador pausa a execução em uma instrução Transact-SQL específica, você pode usar as várias janelas do depurador para exibir o estado de execução atual.

Janelas do Depurador

No modo de depurador, o depurador abre janelas ao lado da janela do Editor de Consultas. O depurador exibe suas informações nas janelas selecionadas. Cada uma das janelas do depurador tem guias que você pode selecionar para controlar qual conjunto de informações é exibido na janela. As guias Pilha de chamadas, Pontos de interrupção, Configurações de exceção e Saída estão contidas em uma janela. As guias Watch1, Watch2, Watch3 e Watch4 estão contidas em uma janela. As janelas Threads e Locals são exibidas separadamente.

Por padrão, nem todas essas guias ou janelas estão ativas. Para abrir uma janela específica, no menu Depurar , selecione Windows e, em seguida, selecione a janela que deseja exibir.

Transact-SQL expressões

Expressões são Transact-SQL cláusulas que avaliam para um único valor escalar, como variáveis ou parâmetros. A janela do depurador pode exibir os valores de dados atualmente atribuídos a expressões em até cinco guias ou janelas: Locals, Watch1, Watch2, Watch3 e Watch4.

A janela Locais exibe informações sobre as variáveis locais no escopo atual do depurador de Transact-SQL. O conjunto de expressões listadas na janela Locais muda à medida que o depurador executa as diferentes partes do código.

As expressões nas quatro janelas Watch não se limitam apenas a listar o identificador de uma variável. Você pode especificar uma expressão Transact-SQL que seja avaliada como um único valor, como adicionar um número a uma variável ou uma SELECT instrução que seja avaliada como um único valor. Os exemplos incluem:

• O nome de uma variável, como @IntegerCounter.

• Uma operação aritmética em uma variável, como @IntegerCounter + 1.

• Uma operação de cadeia de caracteres em duas variáveis de caracteres, como @FirstName + @LastName.

• Uma SELECT instrução que retorna um único valor, como: SELECT CharCol FROM MyTable WHERE PrimaryKey = 1.

As quatro janelas de observação exibem informações sobre variáveis e expressões selecionadas. O conjunto de expressões listadas nas janelas de observação não é alterado até que você adicione ou exclua expressões da lista.

Para adicionar uma expressão a uma janela Inspeção, insira o nome da expressão na coluna Nome de uma linha vazia numa janela Inspeção. Você também pode selecionar QuickWatch no menu Depurar, inserir uma expressão e selecionar Adicionar Exibição.

Você pode definir os valores de dados para variáveis nas janelas Locais, Observação ou QuickWatch clicando com o botão direito do mouse na linha e selecionando Editar Valor. As colunas Valor na janela Locais , na janela Inspeção e na caixa de diálogo QuickWatch suportam visualizadores de dados de texto, XML e HTML. Os visualizadores são representados por uma ponta de dados de lupa na extremidade direita da coluna Valores . Você pode usar os visualizadores para exibir valores de dados de texto, XML ou HTML em exibições que correspondam aos tipos de dados, por exemplo, exibindo arquivos XML em uma janela do navegador.

No modo de depuração, quando o utilizador move o ponteiro do rato sobre um identificador, é exibido um popup de Informações Rápidas com o nome da expressão e o seu valor atual. Para obter mais informações, consulte Informações rápidas (IntelliSense).

Breakpoints

Você pode usar a janela Pontos de interrupção para exibir e gerenciar pontos de interrupção. Para obter mais informações, veja percorrer o código Transact-SQL passo a passo.

Pilhas de chamadas

A janela Pilha de chamadas exibe o local de execução atual e informações sobre como a execução passou da janela do editor original através de qualquer módulo Transact-SQL (funções, procedimentos armazenados ou gatilhos) para chegar ao local de execução atual. Cada linha na janela Pilha de Chamadas é chamada de quadro de pilha e representa qualquer um dos seguintes itens:

• O local de execução atual.
• Uma chamada de um módulo para outro.
• Uma chamada de uma janela do editor para um módulo Transact-SQL.

A ordem da pilha é o inverso da ordem em que os módulos foram chamados. O local de execução atual está na parte superior da pilha e a chamada original na parte inferior. Uma seta amarela na margem esquerda do quadro da pilha identifica o quadro no qual o depurador pausou a execução.

A coluna Nome registra as seguintes informações:

• O módulo de origem que contém a linha de código que chamou para o nível subsequente.

• A linha de código que chamou o próximo módulo na pilha.

• Os nomes, tipos de dados e valores de todos os parâmetros são listados se a chamada foi para um procedimento armazenado ou função que usa parâmetros.

As expressões nas janelas Locals, Watch e QuickWatch são avaliadas para o quadro de pilha atual. Por padrão, o quadro de pilha atual é o quadro superior na pilha, onde o depurador pausou a execução. Quando você especifica outro quadro de pilha como o quadro atual, as expressões nas janelas Locais, Observação e QuickWatch são reavaliadas para o novo quadro de pilha. Você pode alterar o quadro de pilha atual clicando duas vezes em um quadro ou selecionando um quadro e selecionando Alternar para quadro. Nesse ponto, as expressões nas janelas Locals, Watch e QuickWatch são reavaliadas para o novo quadro. Sempre que o frame de stack atual não for o frame superior da stack, uma seta verde na margem esquerda do frame de stack identificará o frame de stack atual.

Quando você clica com o botão direito do mouse em um quadro de pilha e seleciona Ir para código-fonte, o código desse quadro é exibido em uma janela do Editor de Consultas. No entanto, esse quadro não é transformado no quadro atual e o conteúdo das janelas Locals, Watch e QuickWatch não é alterado.

Informações do sistema e resultados Transact-SQL

O depurador lista suas mensagens de status e eventos na janela Saída . A janela inclui informações como quando o depurador se acopla a outros processos ou quando os threads do depurador terminam.

Enquanto estiver no modo de depuração, as guias Resultados e Mensagens ainda estarão ativas no Editor de Consultas. A guia Resultados continua a exibir os conjuntos de resultados das instruções Transact-SQL executadas durante uma sessão de depuração. A guia Mensagens continua a exibir mensagens do sistema, como o número de linhas afetadas e a saída das instruções de PRINT e RAISERROR.

Conteúdo relacionado

• Transact-SQL depurador
• Transact-SQL pontos de interrupção