Depurador do Transact-SQL

Aplica-se: SQL Server

O depurador Transact-SQL ajuda a localizar erros em códigos Transact-SQL investigando o comportamento do código em tempo real. Depois de definir a janela do Editor de Consultas do Mecanismo de Banco de Dados para modo de depuração, você pode pausar a execução em linhas específicas do código e inspecionar informações e dados que são usados por essas instruções Transact-SQL ou retornadas por elas.

A depuração do T-SQL está disponível no SQL Server Data Tools para Visual Studio.

Como executar o código Transact-SQL em etapas

O depurador Transact-SQL fornece as seguintes opções, que você pode usar para navegar pelo código Transact-SQL quando a janela Editor de Consultas do Mecanismo de Banco de Dados está em modo de depuração:

• Defina pontos de interrupção em instruções Transact-SQL individuais.

  Um ponto de interrupção especifica um ponto no qual você deseja que a execução seja pausada para que seja possível examinar os dados. Quando você inicia o depurador, ele pausa na primeira linha de código da janela Editor de Consultas. Para executar até o primeiro ponto de interrupção, use Continuar. Você também pode usar Continuar para executar o próximo ponto de interrupção em qualquer local em que a janela esteja pausada no momento. Você pode editar pontos de interrupção para especificar ações, como as condições sob as quais o ponto de interrupção deve pausar a execução, as informações para imprimir na janela Saída e alterar o local do ponto de interrupção.

• Avançar para a próxima instrução.

  Esta opção permite navegar por um conjunto de instruções, uma a uma, e observar o comportamento delas à medida que você avança.

• Avançar para ou passar por uma chamada para um procedimento armazenado ou função.

  Se tiver certeza de que não há erros em um procedimento armazenado, você poderá passar por ele. O procedimento é executado por completo, e os resultados são retornados ao código.

  Se você desejar depurar um procedimento armazenado ou uma função, poderá avançar no módulo. Uma nova janela do Editor de Consultas do Mecanismo de Banco de Dados é aberta e é preenchida com o código-fonte do módulo. A janela está no modo de depuração e a execução pausa na primeira instrução do módulo. Em seguida, você pode navegar pelo código do módulo, por exemplo, definindo pontos de interrupção ou percorrendo o código.

Para obter mais informações sobre como o depurador permite navegar pelo código, veja Percorrer código Transact-SQL.

Como exibir informações do depurador

Toda vez que o depurador pausa a execução em uma instrução Transact-SQL específica, você pode usar as seguintes janelas do depurador para exibir o estado de execução atual:

• Locais e Inspeção. Essas janelas exibem expressões Transact-SQL alocadas no momento. Expressões são cláusulas Transact-SQL que são avaliadas como uma única expressão escalar. O depurador Transact-SQL dá suporte à exibição de expressões que fazem referência a variáveis Transact-SQL, a parâmetros ou a funções internas que têm nomes que começam com @@. Essas janelas também exibem os valores de dados que estão atribuídos às expressões no momento.

• QuickWatch. Essa janela exibe o valor de uma expressão Transact-SQL e permite salvar essa expressão em uma janela Inspeção.

• Pontos de interrupção. Esta janela exibe os pontos de interrupção definidos no momento e permite gerenciá-los.

• Pilha de Chamadas. Esta janela exibe o local de execução atual. Fornece também informações sobre como a execução passou da janela Editor de Consultas original por meio de funções, procedimentos armazenados ou gatilhos para alcançar o local de execução atual.

• Saída. Esta janela exibe várias mensagens e dados de programa, como, por exemplo, mensagens de sistema do depurador.

• Resultados e Mensagens.Essas guias da janela Editor de Consultas exibem os resultados de instruções Transact-SQL executadas anteriormente.

Tarefas do depurador do Transact-SQL

Descrição da tarefa	Artigo
Descreve como configurar o depurador Transact-SQL para a depuração remota.	Configurar regras de firewall antes de executar o depurador do Transact-SQL
Descreve como iniciar, interromper e controlar a operação do depurador.	Executar o depurador do Transact-SQL
Descreve como usar o depurador Transact-SQL para percorrer o código.	Percorrer o código do Transact-SQL
Descreve como usar o depurador Transact-SQL para percorrer o código de procedimento armazenado.	Depurar Procedimentos Armazenados
Descreve como usar o depurador para exibir dados Transact-SQL, como, por exemplo, parâmetros e variáveis e informações do sistema.	Informações do depurador Transact-SQL