Partilhar via

Execute o depurador de Transact-SQL

Aplica-se a:SQL Server

Você pode iniciar o depurador de Transact-SQL depois de abrir uma janela do Editor de Consultas do Mecanismo de Banco de Dados. Você pode definir opções para personalizar como o depurador é executado e executar seu código Transact-SQL no modo de depuração até parar o depurador.

Iniciar e parar o depurador

Os requisitos para iniciar o depurador de Transact-SQL são os seguintes:

  • Se o Editor de Consultas do Mecanismo de Banco de Dados estiver conectado a uma instância do Mecanismo de Banco de Dados em outro computador, você deverá configurar o depurador para depuração remota. Para obter mais informações, consulte Configurar regras de firewall antes de executar o depurador de Transact-SQL.

  • A janela Editor de Consultas do Mecanismo de Banco de Dados deve ser conectada usando um logon de Autenticação do Windows ou Autenticação do SQL Server que seja membro da função de servidor fixa sysadmin .

  • A janela Editor de Consultas do Mecanismo de Banco de Dados deve estar conectada a uma instância do Mecanismo de Banco de Dados do SQL Server. Não é possível executar o depurador quando a janela do Editor de Consultas está conectada a uma instância que está no modo de usuário único.

Recomendamos depurar código Transact-SQL num servidor de teste, não num servidor de produção, pelas seguintes razões:

  • A depuração é uma operação altamente privilegiada. Portanto, somente membros da função de servidor fixa sysadmin têm permissão para depurar no SQL Server.

  • As sessões de depuração geralmente são executadas por longos períodos de tempo enquanto você investiga as operações de várias instruções Transact-SQL. Os bloqueios, como bloqueios de atualização, adquiridos pela sessão podem ser mantidos por períodos prolongados, até que a sessão seja encerrada ou a transação confirmada ou revertida.

Iniciar o depurador de Transact-SQL coloca a janela do Editor de Consultas no modo de depuração. Quando a janela do Editor de Consultas entra no modo de depuração, o depurador pausa na primeira linha de código. Em seguida, você pode percorrer o código, pausar a execução em instruções Transact-SQL específicas e usar as janelas do depurador para exibir o estado de execução atual. Você pode iniciar o depurador selecionando o botão Depurar na barra de ferramentas Consulta ou selecionando Iniciar Depuração no menu Depurar .

A janela do Editor de Consultas permanece no modo de depuração até que a última instrução na janela do Editor de Consultas seja concluída ou até que você pare o modo de depuração. Você pode interromper o modo de depuração e a execução da instrução usando qualquer um dos seguintes métodos:

  • No menu Depurar , selecione Parar Depuração.
  • Na barra de ferramentas Depurar , selecione o botão Parar Depuração .
  • No menu Consulta , selecione Cancelar Execução de Consulta.
  • Na barra de ferramentas Consulta , selecione o botão Cancelar Execução de Consulta .

Você também pode parar o modo de depuração e permitir que as instruções Transact-SQL restantes terminem a execução selecionando Desanexar tudo no menu Depurar .

Controlar o depurador

Você pode controlar como o depurador de Transact-SQL opera usando os seguintes comandos de menu, barras de ferramentas e atalhos:

  • O menu Depurar e a barra de ferramentas Depurar . O menu Depurar e a barra de ferramentas Depurar ficam inativos até que o foco seja colocado em uma janela aberta do Editor de Consultas. Eles permanecem ativos até que o projeto atual seja encerrado.

  • Os atalhos de teclado do depurador.

  • O menu de atalho do Editor de Consultas. O menu de atalho é exibido quando você clica com o botão direito do mouse em uma linha em uma janela do Editor de Consultas. Quando a janela do Editor de Consultas está no modo de depuração, o menu de atalho exibe comandos do depurador que se aplicam à linha ou cadeia de caracteres selecionada.

  • Itens de menu e comandos de contexto nas janelas abertas pelo depurador, como as janelas Watch ou Breakpoints .

A tabela a seguir mostra os comandos de menu do depurador, botões da barra de ferramentas e atalhos de teclado.

Comando do menu Depurar Comando de atalho do editor Botão da barra de ferramentas Atalho de teclado Ação
Windows/Pontos de interrupção Não disponível Pontos de interrupção Ctrl+ AltB Exiba a janela Pontos de interrupção na qual você pode exibir e gerenciar pontos de interrupção.
Windows/Watch/Watch1 Não disponível Pontos de interrupção/Watch/Watch1 + Ctrl+ AltW, 1 Exiba a janela Watch1 .
Windows/Smartwatch/Smartwatch2 Não disponível Pontos de interrupção/Observação/Observação2 + Ctrl+ AltW, 2 Exiba a janela Watch2 .
Windows/Watch/Watch3 Não disponível Pontos de interrupção/Observação/Observação3 + Ctrl+ AltW, 3 Exiba a janela Watch3 .
Windows/Watch/Watch4 Não disponível Pontos de interrupção/Observador/Observador4 + Ctrl+ AltW, 4 Exiba a janela Watch4 .
Windows/Locais Não disponível Pontos de interrupção/Locais + Ctrl+ AltV, L Exiba a janela Locais .
Windows/Pilha de chamadas Não disponível Pontos de interrupção/pilha de chamadas + Ctrl+ AltO Exiba a janela Pilha de chamadas .
Windows/Threads Não disponível Pontos de interrupção/Threads + Ctrl+ AltH Exiba a janela Threads .
Continuar Não disponível Continuar + AltF5 Corra para o próximo ponto de interrupção. Continue não está ativo até que você esteja focado em uma janela do Editor de Consultas que esteja no modo de depuração.
Iniciar depuração Não disponível Iniciar depuração + AltF5 Coloque uma janela do Editor de Consultas no modo de debug e execute até alcançar o primeiro ponto de interrupção. Se você estiver focado em uma janela do Editor de Consultas que esteja no modo de depuração, Iniciar Depuração será substituído por Continuar.
Interromper tudo Não disponível Interromper tudo CtrlAltBreak Esse recurso não é usado pelo depurador de Transact-SQL.
Parar depuração Não disponível Parar Depurar Shift+F5 Tire uma janela do Editor de Consultas do modo de depuração e devolva-a ao modo normal.
Desanexar tudo Não disponível Não disponível Não disponível Interrompe o modo de depuração, mas executa as instruções restantes na janela do Editor de Consultas.
Entre em Não disponível Entre em F11 Execute a próxima instrução e também abra uma nova janela do Editor de Consultas no modo de depuração se a próxima instrução executar um procedimento armazenado, gatilho ou função.
Avançar Não disponível Passo por cima F10 O mesmo que Step Into, exceto que nenhuma função, procedimentos armazenados ou gatilhos são depurados.
Sair para fora Não disponível Saia Shift+F11 Execute o código restante em um gatilho, função ou procedimento armazenado sem pausar para quaisquer pontos de interrupção. O modo de depuração regular é retomado quando o controle é retornado ao código que chamou o módulo.
Não disponível Executar para Cursor Não disponível + CtrlF10 Execute todo o código desde o último local de parada até o local atual do cursor sem parar em nenhum ponto de interrupção.
Relógio rápido Relógio rápido Não disponível Ctrl+Alt+Q Exiba a janela QuickWatch .
Alternar ponto de interrupção Ponto de interrupção/Inserir ponto de interrupção Não disponível F9 Posicione um ponto de interrupção na instrução Transact-SQL atual ou selecionada.
Não disponível Ponto de interrupção/Excluir ponto de interrupção Não disponível Não disponível Exclua o ponto de interrupção da linha selecionada.
Não disponível Ponto de interrupção/Desativar ponto de interrupção Não disponível Não disponível Desative o ponto de interrupção na linha selecionada. O ponto de interrupção permanece na linha de código, mas a execução não para até que seja reativada.
Não disponível Ponto de interrupção/Ativar ponto de interrupção Não disponível Não disponível Habilite o ponto de interrupção na linha selecionada.
Excluir todos os pontos de interrupção Não disponível Não disponível Ctrl+Shift+F9 Exclua todos os pontos de interrupção.
Desativar todos os pontos de interrupção Não disponível Não disponível Não disponível Desative todos os pontos de interrupção.
Não disponível Adicionar relógio Não disponível Não disponível Adicione a expressão selecionada à janela Espiar.

Conteúdo relacionado

  • Last updated on