Depurador do Transact-SQL

  • Artigo

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

Esse recurso funciona com o SSMS versão 17.9.1 e anterior. A depuração do T-SQL também 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 ao primeiro ponto de interrupção que você definiu, você pode usar o recurso Continuar . Você também pode usar o recurso 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. O SQL Server Management Studio abre uma nova janela do Editor de Consultas do Mecanismo de Banco de Dados, que é preenchida com o código-fonte do módulo, coloca a janela no modo de depuração e pausa a execução 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 Tópico
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 para exibir dados Transact-SQL, como, por exemplo, parâmetros e variáveis e informações do sistema. Informações do depurador Transact-SQL

Confira também

Editores de Consultas e de Texto (SQL Server Management Studio)