Percorrendo código Transact-SQL

O depurador Transact-SQL o permite a controlar quais instruções Transact-SQL são executadas em uma janela do Editor de Consultas Mecanismo de Banco de Dados. Você pode pausar o depurador em instruções individuais e exibir o estado dos elementos de código nesse ponto.

Pontos de interrupção

Um ponto de interrupção sinaliza o depurador para pausar a execução em uma instrução Transact-SQL específica. O ato de definir um ponto de interrupção em uma instrução é chamado de alternância de um ponto de interrupção. Você pode alternar um ponto de interrupção em uma instrução Transact-SQL selecionando a instrução e desempenhando uma das seguintes ações:

  • Pressione F9.

  • No menu Depurar, clique em Alternar Ponto de Interrupção.

  • Na janela Editor de Consultas, clique na barra cinza à esquerda da instrução Transact-SQL desejada.

Para exibir e gerenciar todos os pontos de interrupção abertos, você pode usar a janela Pontos de Interrupção. A janela Pontos de Interrupção lista informações como a linha de código em que o ponto de interrupção é localizado. Na janela Pontos de Interrupção, você pode excluir também, desabilitar e habilitar pontos de interrupção. Para obter mais informações sobre a janela Pontos de Interrupção, consulte Janela Pontos de Interrupção..

Você pode abrir a janela Pontos de Interrupção em uma das seguintes maneiras:

  • No menu Depurar, clique em Janelas e em Pontos de Interrupção.

  • Na barra de ferramentas Depurar, clique no botão Pontos de Interrupção.

  • Pressione CTRL+ALT+B.

Você pode desabilitar um ponto de interrupção temporariamente. Isso impede que o ponto de interrupção pause a execução, mas deixa a definição em local no caso de você desejar habilitar o ponto de interrupção novamente.

A tabela a seguir lista as várias maneiras em que você pode desabilitar, reabilitar e excluir pontos de interrupção.

Ação

Procedimento

Desabilitar um ponto de interrupção individual

  • Na janela Editor de Consultas, clique com o botão direito do mouse no ponto de interrupção e clique em Desabilitar Ponto de Interrupção.

  • Na janela Pontos de Interrupção, desmarque a caixa de seleção à esquerda do ponto de interrupção.

Desabilitar todos os pontos de interrupção

  • No menu Depurar, clique em Desabilitar Todos os Pontos de Interrupção.

  • Na barra de ferramentas da janela Pontos de Interrupção, clique no botão Desabilitar Todos os Pontos de Interrupção.

Reabilitar um ponto de interrupção individual

  • Na janela Editor de Consultas, clique com o botão direito do mouse no ponto de interrupção e clique em Habilitar Ponto de Interrupção.

  • Na janela Pontos de Interrupção, clique na caixa de seleção à esquerda do ponto de interrupção.

Reabilitar todos os pontos de interrupção desabilitados

  • No menu Depurar, clique em Habilitar Todos os Pontos de Interrupção.

  • Na barra de ferramentas da janela Pontos de Interrupção, clique no botão Habilitar Todos os Pontos de Interrupção.

Excluir um ponto de interrupção individual

  • Na janela Editor de Consultas, clique com o botão direito do mouse no ponto de interrupção e clique em Excluir Ponto de Interrupção.

  • Na janela Pontos de Interrupção, clique com o botão direito do mouse no ponto de interrupção e em Excluir no menu de atalho.

  • Na janela Pontos de Interrupção, selecione o ponto de interrupção e pressione DELETE.

Excluir todos os pontos de interrupção

  • No menu Depurar, clique em Excluir Todos os Pontos de Interrupção.

  • Na barra de ferramentas da janela Pontos de Interrupção, clique no botão Excluir Todos os Pontos de Interrupção.

ObservaçãoObservação

O depurador Transact-SQL não oferece suporte os recursos do MicrosoftVisual Studio de definição de condições de ponto de interrupção ou contagens de ocorrências.

Controlando a execução de uma instrução

No depurador Transact-SQL, você pode especificar as seguintes opções para executar a partir da instrução atual em código Transact-SQL:

  • Execute o próximo ponto de interrupção.

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

    Se a próxima instrução chamar um procedimento armazenado, uma função ou um gatilho do Transact-SQL, o depurador exibirá uma nova janela do Editor de Consultas que contém o código do módulo. A janela está em modo de depuração e a execução pausa na primeira instrução do módulo. Você pode mover-se pelo código do módulo, por exemplo, definindo pontos de interrupção ou percorrendo o código.

  • Passe pela próxima instrução.

    A próxima instrução é executada. No entanto, se a próxima instrução chamar um procedimento armazenado, uma função ou um gatilho, o código do módulo será executado até o fim, e os resultados serão retornados ao código de chamada. Se você tiver certeza de que não há erros em um procedimento armazenado, poderá passar por ele. A execução pausa na instrução que segue a chamada do procedimento armazenado, da função ou do gatilho.

  • Sair de um procedimento armazenado, uma função ou um gatilho.

    A execução pausa na instrução que segue a chamada do procedimento armazenado, da função ou do gatilho.

  • Execute do local atual ao local atual do ponteiro e ignore todos os pontos de interrupção.

A tabela a seguir lista os vários modos nos quais você pode controlar como as instruções são executadas no depurador Transact-SQL.

Ação

Procedimento

Executar todas as instruções da instrução atual para o próximo ponto de interrupção

  • No menu Depurar, clique em Continuar.

  • Na barra de ferramentas de Depurar, clique no botão Continuar.

Avançar para a próxima instrução ou módulo

  • No menu Depurar, clique em Avançar.

  • Na barra de ferramentas de Depurar, clique no botão Avançar.

  • Pressione F11.

Passar pela próxima instrução ou módulo

  • No menu Depurar, clique em Passar por.

  • Na barra de ferramentas de Depurar, clique no botão Passar por.

  • Pressione F10.

Sair de um módulo

  • No menu Depurar, clique em Sair.

  • Na barra de ferramentas de Depurar, clique no botão Sair.

  • Pressione SHIFT+F11.

Executar para o local do cursor atual

  • Clique com o botão direito do mouse na janela Editor de Consultas e então clique em Executar até o Cursor.

  • Pressione CTRL+F10.