Janela do Editor de Consultas do Mecanismo de Banco de Dados do SQL Server Management Studio

Use o Editor de Consultas do Mecanismo de Banco de Dados para criar e executar scripts Transact-SQL e sqlcmd.

Obtendo ajuda de Transact-SQL

Este tópico é a localização padrão para a ajuda de F1 que vem da janela do Editor de Consultas do Mecanismo de Banco de Dados. Se você selecionar F1 depois de realçar texto no editor que não corresponde a uma palavra-chave de ajuda aplicada a qualquer tópico de referência de Transact-SQL, a ajuda de F1 exibirá este tópico. Nesse caso, há duas abordagens para obter ajuda adicional:

  • Copie e cole a cadeia de caracteres do editor que você realçou na guia de pesquisa dos Manuais Online do SQL Server e faça uma pesquisa.

  • Realce somente a parte da instrução Transact-SQL que provavelmente corresponderá a uma palavra-chave aplicada a um tópico e selecione F1 novamente. Exemplos de cadeias de caracteres para realçar incluem:

    • O nome de uma instrução Transact-SQL, como CREATE DATABASE ou BEGIN TRANSACTION.

    • O nome de uma função interna, como SERVERPROPERTY, ou @@VERSION.

    • O nome de uma tabela de procedimento armazenado de sistema, ou exibição, como sys.data_spaces ou sp_tableoption.

Recursos

  • Digite os scripts na janela do Editor de Consultas.

  • Para executar scripts, pressione F5 ou clique em Executar na barra de ferramentas ou, no menu Consulta, clique em Executar. Se uma parte do código for selecionada, só essa parte será executada. Se nenhum código for selecionado, todo o código do Editor de Consultas será executado.

  • Para obter ajuda sobre a sintaxe Transact-SQL, selecione uma palavra-chave no Editor de Consultas e clique em F1.

  • Para obter ajuda dinâmica sobre a sintaxe Transact-SQL, no menu Ajuda, clique em Ajuda Dinâmica para abrir o componente da Ajuda Dinâmica. Com a Ajuda Dinâmica, os tópicos da ajuda aparecem na janela Ajuda Dinâmica quando palavras-chave são digitadas no Editor de Consultas.

  • O Editor de Consultas oferece suporte à funcionalidade IntelliSense, como completar palavra e parâmetro. Para obter mais informações, consulte Usando o IntelliSense.

    ObservaçãoObservação

    Ao habilitar o IntelliSense para scripts Transact-SQL grandes, você pode reduzir o desempenho de computadores lentos. Para obter informações sobre como limitar o tamanho de scripts Transact-SQL para os quais o IntelliSense está habilitado, consulte Opções (Editor de Texto/Transact-SQL/IntelliSense).

  • O Editor de Consultas fornece o depurador Transact-SQL que você pode usar para ajudar a depurar scripts e instruções Transact-SQL. Para obter mais informações, consulte Usando o depurador Transact-SQL.

  • Mensagens de erros são exibidas nas seguintes áreas:

    • Na guia Mensagens da parte inferior da janela para erros que retornados pelo Mecanismo de banco de dados do SQL Server.

    • Na janela Lista de Erros para erros gerados pelo IntelliSense. Para obter mais informações, consulte Janela Lista de Erros (Management Studio).

    • Nas janelas Saída ou Imediato para erros gerados pelo depurador Transact-SQL.

Barra de ferramentas Editor SQL

Quando o Editor de Consultas Mecanismo de Banco de Dados está aberto, a barra de ferramentas Editor SQL é exibida com os botões a seguir.

  • Conectar
    Abra a caixa de diálogo Conectar ao Servidor. Use esta caixa de diálogo para estabelecer uma conexão a um servidor.

  • Desconectar
    Desconecta o Editor de Consultas do servidor.

  • Alterar Conexão
    Abra a caixa de diálogo Conectar ao Servidor. Use esta caixa de diálogo para estabelecer uma conexão a um servidor diferente.

  • Nova Consulta com Conexão Atual
    Abre uma nova janela do Editor de Consultas e usa as informações de conexão da janela atual do Editor de Consultas.

  • Bancos de Dados Disponíveis
    Alteram a conexão com um banco de dados diferente do mesmo servidor.

  • Executar
    Executa o código selecionado ou, se nenhum código estiver selecionado, executa todo o código no Editor de Consultas.

  • Depurador
    Habilita o depurador Transact-SQL. Este depurador dá suporte a ações de depuração, como definir pontos de interrupção, detectar variáveis e depurar através de código.

  • Cancelar Consulta de Execução
    Envia uma solicitação de cancelamento ao servidor. Algumas consultas não podem ser canceladas imediatamente, mas precisam esperar por uma condição de cancelamento satisfatória. Quando transações são canceladas, podem ocorrer atrasos enquanto as transações são revertidas.

  • Analisar
    Verifica a sintaxe do código selecionado. Se nenhum código estiver selecionado, esta opção verificará a sintaxe de todo o código na janela Editor de Consultas.

  • Exibir Plano de Execução Estimado
    Solicita um plano de execução de consulta do processador de consultas sem executar realmente a consulta e exibe o plano na janela Plano de execução. Esse plano usa estatísticas de índice como uma estimativa do número de linhas que se espera que retornem durante cada parte da execução da consulta. O plano de consulta real que é usado pode ser diferente do plano de execução estimado. Isso pode ocorrer se o número de linhas retornadas for consideravelmente diferente da estimativa e o processador de consultas alterar o plano para torná-lo mais eficiente.

  • Opções de consulta
    Abra a caixa de diálogo Opções de Consulta. Use esta caixa de diálogo para configurar as opções padrão para execução da consulta e para resultados da consulta.

  • IntelliSense habilitado
    Especifica se a funcionalidade IntelliSense está disponível no Editor de Consultas do Mecanismo de Banco de Dados.

  • Incluir Plano de Execução Real
    Executa a consulta e retorna os resultados da consulta e o plano de execução usado para a consulta. Estes aparecem como um plano gráfico de consulta na janela Plano de Execução.

  • Incluir Estatísticas do Cliente
    Inclui a janela Estatísticas do Cliente com estatísticas sobre a consulta e sobre os pacotes de rede, além do tempo decorrido da consulta.

  • Resultados em Texto
    Retorna os resultados da consulta como texto na janela Resultados.

  • Resultados em Grade
    Retorna os resultados da consulta como uma ou mais grades na janela Resultados.

  • Resultados em Arquivo
    Quando a consulta é executada, a caixa de diálogo Salvar Resultados é exibida. Em Salvar em, selecione a pasta na qual você deseja salvar o arquivo. Em Nome do arquivo, digite o nome do arquivo e clique em Salvar para salvar os resultados da consulta como um arquivo de Relatório com a extensão .rpt. Para opções avançadas, clique na seta para baixo no botão Salvar e clique em Salvar com Codificação.

  • Comentário de seleção
    Transforma a linha atual em um comentário adicionando um operador de comentário (--) no começo da linha.

  • Remover comentário de seleção
    Transforma a linha atual em uma instrução de fonte ativa ao remover um operador de comentário (--) do começo da linha.

  • Diminuir Recuo de Linha
    Move o texto da linha para a esquerda ao remover espaços em branco no começo da linha.

  • Aumentar Recuo de Linha
    Move o texto da linha para a direita ao adicionar espaços em branco no começo da linha.

  • Especificar Valores para Parâmetros de Modelo
    Abre uma caixa de diálogo que você pode usar para especificar valores para parâmetros em procedimentos e funções armazenados.

Você também pode adicionar a barra de ferramentas Editor de Consultas selecionando o menu Exibir, Barras de Ferramentas e, em seguida, Editor SQL. Se você adicionar a barra de ferramentas do SQL Editor quando nenhuma janela do Editor de Consultas do Mecanismo de Banco de Dados estiver aberta, todos os botões ficarão indisponíveis.

Barra de ferramentas Editor SQL

Quando uma janela do Editor de Consultas do Mecanismo de Banco de Dados está aberta, você também pode adicionar a barra de ferramentas Depurar selecionando o menu Exibir, Barras de Ferramentas e, em seguida, Depurar. Se você adicionar a barra de ferramentas Depurar quando nenhuma janela do Editor de Consultas do Mecanismo de Banco de Dados estiver aberta, todos os botões ficarão indisponíveis.

  • Continuar
    Executa o código na janela do Editor de Consultas do Mecanismo de Banco de Dados até encontrar um ponto de interrupção. 

  • Interromper Tudo
    Define o depurador para interromper todos os processos aos quais o depurador está anexado quando ocorrer uma interrupção.

  • Parar Depuração
    Retira a janela selecionada do Editor de Consultas do Mecanismo de Banco de Dados do modo de depuração e restaura o modo de execução padrão.

  • Mostrar Próxima Instrução
    Move o cursor para a próxima instrução a ser executada.

  • Depuração Total
    Executa a instrução após a instrução atual. Se a próxima instrução chamar um procedimento armazenado de Transact-SQL, uma função ou um gatilho, 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.

  • Depuração Parcial
    Executa a instrução após a instrução atual. Se a próxima instrução chamar um procedimento armazenado do Transact-SQL, uma função ou um gatilho, o código do módulo será executado até ser concluído, e os resultados serão retornados ao código de chamada. Se você tiver certeza de que não há erros no módulo, poderá passar por ele. A execução pausa na instrução que segue a chamada para o módulo.

  • Depuração Circular
    Retorna para o próximo nível de chamada mais alto (função, procedimento armazenado ou gatilho). A execução pausa na instrução que segue a chamada para o módulo.

  • Windows
    Abre a janela Ponto de Interrupção ou a janela Imediato.

Histórico de alterações

Conteúdo atualizado

Corrigidas as descrições de Depuração Total e Depuração Parcial.