Editor de Consultas do SSMS (SQL Server Management Studio)

aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse Analytics

Este artigo explica os recursos e as funções do editor de consultas no SSMS (SQL Server Management Studio).

Observação

Se você quiser saber como usar a Ajuda F1 do Transact-SQL (T-SQL), veja a seção ajuda doTransact-SQL F1 .

Se você quiser saber mais sobre as tarefas que pode fazer com o editor, visite a seção Tarefas do Editor .

Os editores do SSMS compartilham uma arquitetura típica. O editor de texto implementa o nível base de funcionalidade e pode ser usado como um editor básico para arquivos de texto. Os outros editores ou editores de consultas estendem essa base de funcionalidades incluindo um serviço de idioma que define a sintaxe de um dos idiomas com suporte no SQL Server. Os editores de consulta também implementam vários níveis de suporte para recursos de editor, como o IntelliSense e a depuração. Os editores de consulta incluem o Editor de Consultas do Mecanismo de Banco de Dados para uso na criação de scripts que contêm instruções T-SQL e XQuery, o editor MDX para a linguagem MDX, o editor DMX para a linguagem DMX e o editor XML/A da linguagem XML for Analysis. Você pode usar o Editor de Consultas para criar e executar scripts que contêm instruções Transact-SQL.

Barra de ferramentas do Editor do SQL

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

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

Conectar-se usando a barra de ferramentas do editor

Abre a caixa de diálogo Conectar ao Servidor . Use essa caixa de diálogo para estabelecer uma conexão com um servidor.

Você também pode se conectar ao banco de dados usando o menu de contexto.

Alterar a conexão usando a barra de ferramentas do editor

Abre a caixa de diálogo Conectar ao Servidor . Use essa caixa de diálogo para estabelecer uma conexão com um servidor diferente.

Você também pode alterar conexões usando o menu de contexto.

Bancos de dados disponíveis usando a barra de ferramentas do editor

Altere a conexão para um banco de dados diferente no mesmo servidor.

Executar usando a barra de ferramentas do editor

Executa o código selecionado ou, se nenhum código estiver selecionado, ele executará todo o código do Editor de Consultas.

Você também pode executar uma consulta selecionando F5 ou no menu de contexto.

Cancelar a execução da consulta usando a barra de ferramentas do editor

Envia uma solicitação de cancelamento para o servidor. Algumas consultas não podem ser canceladas imediatamente, mas devem aguardar uma condição de cancelamento adequada. Quando as transações são canceladas, podem ocorrer atrasos durante o processo de reversão das transações.

Você também pode cancelar uma consulta em execução selecionando Alt + Break.

Analisar usando a barra de ferramentas do editor

Verifica a sintaxe do código selecionado. Se nenhum código for selecionado, ele verificará toda a sintaxe do código na janela Editor de Consultas.

Você também pode verificar o código no Editor de Consultas selecionando Ctrl + F5.

Exibir plano de execução estimado usando a barra de ferramentas do editor

Solicita um plano de execução de consulta do processador de consulta sem executar a consulta e exibe o plano na janela Plano de execução . Esse plano usa estatísticas de índice para estimar o número de linhas que devem ser retornadas durante cada parte da execução da consulta. O plano de consulta real usado pode ser diferente do plano de execução estimado. Se o número de linhas retornadas for diferente da estimativa e o processador de consulta alterar o plano para ser mais eficiente, isso poderá ocorrer.

Você também pode exibir um plano de execução estimado selecionando Ctrl + L ou no menu de contexto.

Opções de consulta usando a barra de ferramentas do editor

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

Você também pode selecionar Opções de Consulta no menu de contexto.

IntelliSense habilitado usando a barra de ferramentas do editor

Especifica se a funcionalidade do IntelliSense está disponível no Editor de Consultas do Mecanismo de Banco de Dados. Essa opção é definida por padrão.

Você também pode selecionar IntelliSense Habilitado selecionando Ctrl + B e Ctrl + I ou no menu de contexto.

Incluir plano de execução real usando a barra de ferramentas do editor

Executa a consulta, retorna os resultados da consulta e usa o plano de execução para a consulta. As consultas aparecem como um plano de consulta gráfica na janela Plano de Execução .

Você também pode selecionar Incluir Plano de Execução Atual pressionando Ctrl + M ou no menu de contexto.

Incluir estatísticas de consulta ao vivo usando a barra de ferramentas do editor

Fornece insights em tempo real sobre o processo de execução da consulta à medida que os controles fluem de um operador de plano de consulta para outro.

Você também pode selecionar Incluir Estatísticas de Consulta Dinâmica no menu de contexto.

Incluir estatísticas do cliente usando a barra de ferramentas do editor

Inclui uma janela Estatísticas do Cliente que contém estatísticas sobre a consulta e sobre os pacotes de rede e o tempo decorrido da consulta.

Você também pode selecionar Incluir Estatísticas de Consulta Dinâmica pressionando Shift + Alt + S ou no menu de contexto.

Resultados para texto usando a barra de ferramentas do editor

Retorna os resultados da consulta como texto na janela Resultados .

Você também pode retornar resultados ao texto selecionando Ctrl + T ou no menu de contexto.

Resultados para grade usando a barra de ferramentas do editor

Retorna os resultados da consulta como uma ou mais grades na janela Resultados . Essa opção está habilitada por padrão.

Você também pode retornar resultados ao texto selecionando Ctrl + D ou no menu de contexto.

Salvar resultados em arquivo usando a barra de ferramentas do editor

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

Você também pode retornar resultados ao texto selecionando Ctrl + Shift + F ou no menu de contexto.

Comente as linhas selecionadas usando a barra de ferramentas do editor

Faz da linha atual um comentário adicionando um operador de comentário (--) no início da linha.

Você também pode comentar uma linha selecionando Ctrl + K e, em seguida, Ctrl + C.

Descomentar as linhas selecionadas usando a barra de ferramentas do editor

Torna a linha atual uma declaração fonte ativa ao remover o operador de comentário (--) no início da linha.

Você também pode cancelar o comentário de uma linha selecionando Ctrl + K e, em seguida, Ctrl + U.

Diminuir o recuo usando a barra de ferramentas do editor

Move o texto da linha para a esquerda removendo espaços em branco no início da linha.

Aumentar o recuo de linha usando a barra de ferramentas do editor

Move o texto da linha para a direita adicionando espaços em branco no início da linha.

Especificar valores para parâmetros de modelo usando a barra de ferramentas do editor

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

Menu de contexto

Você pode acessar o menu de contexto clicando com o botão direito do mouse em qualquer lugar no editor de consultas. As opções no menu de contexto são semelhantes à Barra de Ferramentas do Editor do SQL. Com o menu de contexto, você vê as mesmas opções que Conectar e Executar, mas também tem outras opções listadas como Inserir Snippet e Surround With.

Inserir snippet usando o menu de contexto

Transact-SQL Snippets são modelos que você pode usar como ponto de partida ao escrever novas instruções Transact-SQL no Editor de Consultas.

Surround-with usando o menu de contexto

Um snippet Surround With é um modelo que você pode usar como ponto de partida ao colocar um conjunto de instruções Transact-SQL em um bloco BEGIN, IF ou WHILE.

Conexão usando o menu de contexto

Há mais opções de conexão no menu de contexto em comparação com as opções da barra de ferramentas no SSMS.

• Conectar - Abre a caixa de diálogo Conectar ao Servidor. Use essa caixa de diálogo para estabelecer uma conexão com um servidor.

• Desconectar - desconecta o Editor de Consultas atual do servidor.

• Desconectar todas as consultas – desconecta todas as conexões de consulta.

• Alterar Conexão – abre a caixa de diálogo Conectar ao Servidor. Use essa caixa de diálogo para estabelecer uma conexão com um servidor diferente.

Abrir servidor no Pesquisador de Objetos usando o menu de contexto

O Pesquisador de Objetos fornece uma interface de usuário hierárquica para exibir e gerenciar os objetos em cada instância do SQL Server. O painel Detalhes do Pesquisador de Objetos apresenta uma exibição tabular de objetos de instância e a capacidade de pesquisar objetos específicos. Os recursos do Pesquisador de Objetos variam ligeiramente dependendo do tipo de servidor, mas geralmente incluem os recursos de desenvolvimento para bancos de dados e recursos de gerenciamento para todos os tipos de servidor.

Executar usando o menu de contexto

Executa o código selecionado ou, se nenhum código estiver selecionado, executará todo o código no Editor de Consultas.

Exibir plano de execução estimado usando o menu de contexto

Solicita um plano de execução de consulta do processador de consulta sem realmente executar a consulta e exibe o plano na janela Plano de execução . Esse plano usa estatísticas de índice para estimar o número de linhas que devem ser retornadas durante cada parte da execução da consulta. O plano de consulta real usado pode ser diferente do plano de execução estimado. Se o número de linhas retornadas for diferente da estimativa e o processador de consultas alterar o plano para ser mais eficiente, isso poderá ocorrer.

IntelliSense habilitado usando o menu de contexto

Especifica se a funcionalidade do IntelliSense está disponível no Editor de Consultas do Mecanismo de Banco de Dados. Essa opção é definida por padrão.

Rastrear consulta no SQL Server Profiler usando o menu de contexto

O SQL Server Profiler é uma interface para criar e gerenciar rastreamentos, além de analisar e reproduzir resultados de rastreamento. Os eventos são salvos em um arquivo de rastreamento que pode ser analisado ou usado posteriormente para reproduzir uma série específica de etapas ao tentar diagnosticar um problema.

Analisar a consulta no Orientador de Otimização do Mecanismo de Banco de Dados usando o menu de contexto

O Assistente de Otimização do Mecanismo de Banco de Dados da Microsoft (DTA) analisa bancos de dados e faz recomendações que você usa para otimizar o desempenho da consulta. Use o Orientador de Otimização do Mecanismo de Banco de Dados para selecionar e criar um conjunto ideal de índices, exibições indexadas ou partições de tabela sem ter uma compreensão especializada da estrutura do banco de dados ou dos internos do SQL Server. Usando o DTA, você pode executar as tarefas a seguir.

Elaborar consulta no editor usando o menu de contexto

O Designer de Consulta e Exibição abre quando você abre a definição de uma visualização, mostra os resultados de uma consulta ou visualização, ou cria ou abre uma consulta.

Incluir o plano de execução real usando o menu de contexto

Executa a consulta, retorna os resultados da consulta e usa o plano de execução para a consulta. As consultas aparecem como um plano de consulta gráfica na janela Plano de Execução .

Incluir estatísticas de consulta ao vivo usando o menu de contexto

Fornece insights em tempo real sobre o processo de execução da consulta à medida que os controles fluem de um operador de plano de consulta para outro.

Incluir estatísticas do cliente usando o menu de contexto

Inclui uma janela Estatísticas do Cliente que contém estatísticas sobre a consulta e sobre os pacotes de rede e o tempo decorrido da consulta.

Resultados usando o menu de contexto

Você pode selecionar qualquer uma das opções de Resultado desejadas no menu de contexto.

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

• Resultados para Tabela – Retorna os resultados da consulta como uma ou mais tabelas na janela Resultados.

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

Janela Propriedades usando o menu de contexto

A janela Propriedades descreve o estado de um item no SQL Server Management Studio, como uma conexão ou um operador showplan, e informações sobre objetos de banco de dados, como tabelas, exibições e designers.

Use a janela Propriedades para exibir as propriedades da conexão atual. Muitas propriedades são de leitura apenas na janela Propriedades, mas podem ser alteradas em outras partes do Management Studio. Por exemplo, a propriedade Banco de Dados de uma consulta é somente leitura na janela Propriedades, mas pode ser alterada na barra de ferramentas.

Opções de consulta usando o menu de contexto

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

Ajuda F1 do Transact-SQL

O Editor de Consultas oferece suporte à vinculação ao artigo de referência de uma instrução Transact-SQL específica quando você seleciona F1. Para fazer isso, destaque o nome de uma instrução Transact-SQL e selecione F1. Em seguida, o mecanismo de pesquisa de ajuda procura por um artigo que tenha um atributo de ajuda F1 que corresponda à cadeia de caracteres realçada.

Se o mecanismo de pesquisa de ajuda não encontrar um artigo com uma palavra-chave de ajuda F1 que corresponda exatamente à cadeia de caracteres realçada, este artigo será exibido. Nesse caso, há duas abordagens para encontrar a ajuda que você está procurando:

• Copie e cole a cadeia de caracteres destacada do editor na guia de pesquisa da Documentação Online do SQL Server e pesquise.

• Realce apenas a parte da instrução Transact-SQL que provavelmente corresponderá a uma palavra-chave de ajuda F1 aplicada a um artigo e selecione F1 novamente. O mecanismo de pesquisa requer uma correspondência exata entre a cadeia de caracteres realçada e uma palavra-chave de ajuda F1 atribuída a um artigo. Se a cadeia de caracteres realçada contiver elementos exclusivos para seu ambiente, como nomes de coluna ou parâmetro, o mecanismo de pesquisa não obterá uma correspondência. Exemplos das cadeias de caracteres a serem realçadas incluem:

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

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

  • O nome de uma tabela de procedimento armazenado do sistema, ou exibições, como sys.data_spaces ou sp_tableoption.

Tarefas do editor

Descrição da tarefa	Artigo
Descreve as várias maneiras de abrir os editores no SSMS.	Abrir um editor (SQL Server Management Studio)
Configure opções para os vários editores, como numeração de linha e opções do IntelliSense.	Configurar Editores (SQL Server Management Studio)
Como gerenciar o modo de exibição, como quebra automática de linha, divisão de uma janela ou guias.	Gerenciar o editor e o modo de exibição
Defina opções de formatação, como texto oculto ou recuo.	Gerenciar formatação de código
Navegar pelo texto em uma janela do editor usando recursos como pesquisa incremental ou ir para.	Navegar por Código e Texto
Defina opções de codificação de cores para várias classes de sintaxe, o que facilita a leitura de instruções complexas.	codificação de cores em editores de consulta
Arraste o texto de um local em um script e solte-o em um novo local.	Arrastar e Soltar Texto
Como definir marcadores para localizar mais facilmente partes importantes do código.	Gerenciar Indicadores
Como imprimir scripts ou os resultados em uma janela ou grade.	Imprimir Código e Resultados
Exiba e use os recursos básicos no Editor de Consultas MDX.	Criar Scripts do Analysis Services
Exiba e use os recursos básicos no Editor de Consultas DMX.	Criar uma consulta DMX
Exiba e use os recursos básicos no Editor XML/A.	XML Editor (SQL Server Management Studio)
Como usar os recursos sqlcmd no Editor de Consultas do Mecanismo de Banco de Dados.	Editar scripts SQLCMD com o Editor de Consultas
Como usar trechos de código no Editor de Consultas do Mecanismo de Banco de Dados. Os snippets são modelos para instruções ou blocos geralmente usados, e podem ser personalizados ou estendidos para incluir snippets específicos de site.	Adicionar Snippets do Transact-SQL
Como usar o depurador Transact-SQL para percorrer o código e exibir informações de depuração, como os valores em variáveis e parâmetros.	Depurador do Transact-SQL

Conteúdo relacionado

• Personalizar Menus e Teclas de Atalho
• Atalhos de teclado do SQL Server Management Studio