Depurador de Transact-SQL

Aplica-se a:SQL Server

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

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

Executar passo a passo o código Transact-SQL

O depurador de 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 estiver no 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 pause para que você possa examinar os dados. Quando você inicia o depurador, ele pausa na primeira linha de código na janela do Editor de Consultas. Para executar até o primeiro ponto de interrupção, use Continuar. Você também pode usar Continuar para executar até o próximo ponto de interrupção de 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, informações para imprimir na janela Saída e alterar o local do ponto de interrupção.

• Passe para a próxima instrução.

  Esta opção permite-lhe navegar através de um conjunto de declarações, uma a uma, e observar o seu comportamento à medida que avança.

• Avance ou aprofunde-se em uma chamada para um procedimento armazenado ou uma função.

  Se tiver certeza de que não há erros em um procedimento armazenado, você pode passar por cima dele. O procedimento é executado na íntegra e os resultados são retornados ao código.

  Se você quiser depurar um procedimento armazenado ou função, você pode entrar no módulo. É aberta uma nova janela do Editor de Consultas do Mecanismo de Banco de Dados que é 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 no módulo. Em seguida, você pode navegar pelo código do módulo, por exemplo, definindo pontos de interrupção ou passando pelo código.

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

Visualizar informações do depurador

Sempre 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 Observação. Essas janelas exibem expressões Transact-SQL atualmente alocadas. As expressões são cláusulas Transact-SQL que avaliam-se para uma única expressão escalar. O depurador de Transact-SQL suporta a visualização de expressões que fazem referência a variáveis Transact-SQL, parâmetros ou funções internas que têm nomes que começam com @@. Essas janelas também exibem os valores de dados atribuídos atualmente às expressões.

• QuickWatch. Esta janela exibe o valor de uma expressão Transact-SQL e permite guardar essa expressão numa janela Watch.

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

• Pilha de chamadas. Esta janela exibe o local de execução atual. E também fornece informações sobre como a execução passou da janela original do Editor de Consultas através de quaisquer funções, procedimentos armazenados ou gatilhos para chegar ao local de execução atual.

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

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

Problemas conhecidos e limitações

O depurador T-SQL é aplicável somente a instâncias do SQL Server. O depurador não oferece suporte à depuração de código Transact-SQL em execução no Banco de Dados SQL do Azure, na Instância Gerenciada SQL do Azure ou no Banco de Dados SQL em Fabric.

Sob certas condições, o realce da linha do depurador T-SQL e os pontos de interrupção podem ficar fora de sincronia com o ponto de execução real ao percorrer um script SQL. O problema pode surgir em vários cenários, incluindo um comentário no início do script ou linhas vazias após GO declarações.

Tarefas do depurador Transact-SQL

Descrição da Tarefa	Artigo
Descreve como configurar o depurador de Transact-SQL para depuração remota.	Configurar regras de firewall antes de executar o depurador de Transact-SQL
Descreve como iniciar, parar e controlar a operação do depurador.	Execute o depurador de Transact-SQL
Descreve como usar o depurador de Transact-SQL para percorrer o código.	Passo a passo por código Transact-SQL
Descreve como usar o depurador de Transact-SQL para navegar pelo código de procedimentos armazenados.	Depurar procedimentos armazenados
Descreve como usar o depurador para exibir dados Transact-SQL, como parâmetros e variáveis, e informações do sistema.	Informações do depurador Transact-SQL