Informações do depurador Transact-SQL

Aplica-se: SQL Server

Toda vez 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 Editor de Consultas. O depurador exibe as suas informações nas janelas selecionadas. Cada uma das janelas de depurador tem guias que você pode selecionar para controlar o 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 Inspecionar 1, Inspecionar 2, Inspecionar 3 e Inspecionar 4 estão contidas em uma janela. As janelas Threads e Locais são exibidas separadamente.

Observação

As descrições anteriores aplicam-se aos locais padrões das janelas do depurador. Você pode arrastar uma guia para movê-la de uma janela para outra ou desencaixar uma guia para criar uma nova janela para as guias selecionadas.

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

Expressões Transact-SQL

Expressões são cláusulas Transact-SQL que são avaliadas como um valor escalar simples, como, por exemplo, variáveis ou parâmetros. A janela 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.

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

As expressões nas quatro janelas Inspecionar não se limitam apenas a listar o identificador de uma variável. Você pode especificar uma expressão Transact-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. 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 caractere, como @FirstName + @LastName.

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

As quatro janelas Inspecionar exibem informações sobre variáveis e expressões selecionadas. O conjunto de expressões listadas nas janelas Inspecionar só será alterado se você adicionar ou excluir expressões da lista.

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

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. 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. Os visualizadores são representados por um dica de dados à direita da coluna Valores . 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.

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. Para obter mais informações, confira Informações Rápidas (IntelliSense).

Pontos de interrupção

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

Pilhas de chamadas

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-SQL (funções, procedimentos armazenados ou gatilhos) para alcançar o local de execução atual. Cada linha na janela Pilha de Chamadas é chamada de um registro de ativação e representa qualquer um dos seguintes itens:

  • O local de execução atual.

  • Uma chamada de um módulo para outro.

  • Uma chamada em uma janela do editor para um módulo Transact-SQL.

A ordem da pilha é inversa àquela em que os módulos foram chamados. O local de execução atual é na parte superior da pilha, e a chamada original, na parte inferior. Uma seta amarela na margem esquerda do quadro de 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 próximo nível.

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

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

As expressões nas janelas Locais, Inspecionar e QuickWatch são avaliadas quanto ao registro de ativação atual. Por padrão, o quadro de pilhas atual é o quadro superior da pilha, em que o depurador pausou a execução. 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. 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. Nesse ponto, as expressões das janelas Locais, Inspecionare QuickWatch são reavaliadas para o novo quadro. 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.

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. No entanto, esse quadro não se transforma no quadro atual, e o conteúdo das janelas Locais, Inspecionare QuickWatch não é alterado.

Informações do sistema e resultados de Transact-SQL

O depurador lista seu status e mensagens de evento na janela Saída . A janela inclui informações, como, por exemplo, quando o depurador é anexado a outros processos ou quando o thread do depurador termina.

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