Executar o depurador do Transact-SQL

Aplica-se:SQL Server

Você pode iniciar o depurador do 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 o código Transact-SQL no modo de depuração até interromper o depurador.

Iniciar e parar o depurador

Os requisitos para iniciar o depurador 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, veja Configurar regras de firewall antes de executar o Depurador Transact-SQL.

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

  • A janela do 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.

É recomendável depurar o código Transact-SQL em um servidor de teste, não em um 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 frequentemente são executadas por longos períodos de tempo enquanto você investiga as operações de várias instruções Transact-SQL. Os bloqueios adquiridos pela sessão, como os bloqueios de atualização, podem permanecer por períodos prolongados até que a sessão seja encerrada ou a transação seja confirmada ou revertida.

Quando o depurador Transact-SQL é iniciado, a janela do Editor de Consultas é colocada em modo de depuração. Quando a janela do Editor de Consultas entra em modo de depuração, o depurador faz uma pausa na primeira linha de código. Nesse ponto, você pode avançar passo a passo pelo código, fazendo pausas de execução em instruções Transact-SQL específicas, e usar as janelas do depurador para exibir o estado atual de execução. Você pode iniciar o depurador selecionando o botão Depurar da barra de ferramentas Consulta ou selecionando Iniciar Depuração no menu Depurar.

A janela do Editor de Consultas permanece em modo de depuração até que a última instrução na janela do Editor de Consultas seja concluída ou você pare o modo de depuração. Você pode parar o modo de depuração e a execução de instruções por meio de um dos seguintes métodos:

  • No menu Depurar, selecione Interromper 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.

Também é possível parar o modo de depuração e permitir que as instruções Transact-SQL restantes sejam concluídas selecionando Desanexar Tudo no menu Depurar.

Controlar o depurador

Você pode controlar a forma como o depurador Transact-SQL opera por meio do uso dos 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 permanecem inativos até que o foco seja colocado em uma janela do Editor de Consultas aberta. Eles permanecem ativos até que o projeto atual seja fechado.

  • Os atalhos de teclado do depurador.

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

  • Itens de menu e comandos de contexto nas janelas que são abertas pelo depurador, como as janelas de Inspeção ou Pontos de Interrupção .

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

Comando do menu Depurar Comando de atalho do Editor Botão da barra de ferramentas Atalho do teclado Ação
Janelas/Pontos de Interrupção Não disponível Pontos de Interrupção Ctrl+Alt+B Exibir a janela Pontos de Interrupção , que permite exibir e gerenciar pontos de interrupção.
Janelas/Observação/Observação1 Não disponível Pontos de interrupção/Observação/Observação1 Ctrl+Alt+W, 1 Exibir a janela Watch1.
Windows/Watch/Watch2 Não disponível Pontos de interrupção/Watch/Watch2 Ctrl+Alt+W, 2 Exibir a janela Watch2.
Windows/Watch/Watch3 Não disponível Pontos de interrupção/Watch/Watch3 Ctrl+Alt+W, 3 Exibir a janela Watch3.
Windows/Watch/Watch4 Não disponível Pontos de Interrupção/Observação/Observação4 Ctrl+Alt+W, 4 Exibir a janela Watch4.
Windows/Locais Não disponível Pontos de Interrupção/Locais Ctrl+Alt+V, L Exibir a janela Locals.
Windows/Pilha de Chamadas Não disponível Pontos de Interrupção/Pilha de Chamadas Ctrl+Alt+C Exibir a janela Pilha de Chamadas .
Windows/Threads Não disponível Pontos de Interrupção/Threads Ctrl+Alt+H Exibir a janela Threads.
Continuar Não disponível Continuar Alt+F5 Executar até o próximo ponto de interrupção. Continuar permanece inativo até que o foco esteja em uma janela do Editor de Consultas que esteja em modo de depuração.
Iniciar Depuração Não disponível Iniciar Depuração Alt+F5 Coloque uma janela do Editor de Consultas em modo de depuração e execute até o primeiro ponto de interrupção. Se o foco estiver em uma janela do Editor de Consulta que esteja em modo de depuração, Iniciar Depuração é substituído por Continuar.
Interromper Tudo Não disponível Interromper Tudo Ctrl+Alt+Quebrar Esse recurso não é usado pelo depurador Transact-SQL.
Parar Depuração Não disponível Parar depuração Shift+F5 Retirar uma janela do Editor de Consultas do modo de depuração e retorná-la ao modo regular.
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 Executar a próxima instrução e também abrir uma nova janela do Editor de Consultas em modo de depuração se a próxima instrução executar um procedimento armazenado, gatilho, ou função.
Passar por cima Não disponível Contornar F10 Igual a Step Into, exceto que nenhuma função, procedimento armazenado ou gatilho são depurados.
Sair Não disponível Sair da função Shift+F11 Executar o código restante de um gatilho, função ou procedimento armazenado sem fazer uma pausa em qualquer ponto de interrupção. O modo de depuração normal é retomado quando o controle é retornado ao código que chamou o módulo.
Não disponível Executar até o cursor Não disponível Ctrl+F10 Executar todo o código desde o último local de parada até o local atual do cursor sem parar em qualquer ponto de interrupção.
QuickWatch QuickWatch Não disponível Ctrl+Alt+Q Exibir a janela do QuickWatch.
Alternar ponto de interrupção Ponto de Interrupção/Inserir Ponto de Interrupção Não disponível F9 Posicionar 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 Excluir o ponto de interrupção da linha selecionada.
Não disponível Ponto de Interrupção/Desabilitar Ponto de Interrupção Não disponível Não disponível Desabilitar 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 habilitado novamente.
Não disponível Ponto de Interrupção/Habilitar Ponto de Interrupção Não disponível Não disponível Habilitar 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 Excluir todos os pontos de interrupção.
Desabilitar Todos os Pontos de Interrupção Não disponível Não disponível Não disponível Desabilitar todos os pontos de interrupção.
Não disponível Adicionar monitoramento Não disponível Não disponível Adicionar a expressão selecionada à janela Observação.

Conteúdo relacionado

  • Last updated on