Compartilhar via


Conceitos básicos do depurador Transact-SQL

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.

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:

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

    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.

  • 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 você tiver certeza de que não há erros em um procedimento armazenado, poderá passar por ele. O procedimento é executado por completo, e os resultados são retornados ao código.

    Para depurar um procedimento armazenado ou função, você pode 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 de origem 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, consulte Percorrendo código Transact-SQL.

Exibindo 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 Inspecionar. 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 oferece suporte à exibição de expressões que fazem referência a variáveis Transact-SQL, parâmetros ou as 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. Esta janela exibe o valor de uma expressão Transact-SQL e permite salvar a expressão em uma janela Inspecionar.

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

Para obter mais informações sobre como exibir informações, consulte Exibindo informações do depurador Transact-SQL.