Depurador do Transact-SQL – Informações

Aplica-se a: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.

Esse recurso funciona com o SSMS versão 17.9.1 e anterior.

Janelas do depurador

Em modo de depurador, o depurador abre duas janelas na parte inferior da janela principal do SQL Server Management Studio. O depurador exibe toda as suas informações nessas duas janelas. Cada uma das janelas de depurador tem guias que você pode selecionar para controlar o conjunto de informações exibido na janela. A janela esquerda do depurador contém as guias Locais, Inspecionar 1, Inspecionar 2, Inspecionar 3e Inspecionar 4 . A janela direita do depurador contém as guias Pilha de Chamadas, Threads, Pontos de Interrupção, Janela de Comandoe Saída .

Por padrão, nem todas essas guias ou janelas são ativas. Você pode abrir uma janela específica usando qualquer uma das seguintes maneiras:

• No menu Depurar , clique em Windowse selecione a janela desejada.

• Na barra de ferramentas de Depurar , clique em Pontos de Interrupçãoe selecione a janela desejada.

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 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.

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 no QuickWatch e 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.

Você pode usar a janela QuickWatch para exibir o valor de uma expressão Transact-SQL e salvar essa expressão em uma janela Inspeção. Para selecionar uma expressão em QuickWatch, selecione ou digite o nome da expressão na caixa Expressão .

As quatro janelas Inspecionar exibem informações sobre variáveis e expressões que você selecionou. 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 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 .

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 definidos no momento. 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.

• 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.

As expressões nas janelas Locais, Inspecionare 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 . Isso 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, xx Linhas Afetadas e a saída de instruções PRINT e RAISERROR.

Consulte Também

Janela Locais
Janela de Observação
Janela Pontos de Interrupção
Janela Pilha de Chamadas
Janela Threads
Janela Saída
Depurador do Transact-SQL