Compartilhar via

O que é a extensão MSSQL para Visual Studio Code?

A extensão MSSQL para Visual Studio Code dá suporte à criação de aplicativos que usam o SQL do Azure (incluindo o Banco de Dados SQL do Azure, a Instância Gerenciada de SQL do Azure e o SQL Server em Máquinas Virtuais do Azure), o Banco de Dados SQL no Fabric e o SQL Server. Ele fornece ferramentas para se conectar a bancos de dados, gerenciar e projetar esquemas, explorar objetos de banco de dados, executar consultas Transact-SQL e exibir planos de execução de consulta no Visual Studio Code.

A extensão inclui intelliSense avançado, execução de script Transact-SQL e opções personalizáveis para dar suporte ao desenvolvimento de SQL para bancos de dados locais e baseados em nuvem.

Instalar a extensão MSSQL no Visual Studio Code

Para começar a usar o desenvolvimento do SQL no Visual Studio Code, instale a extensão MSSQL:

  1. Abra o Visual Studio Code.
  2. Selecione o ícone Extensões na Barra de Atividades (Cmd+Shift+X no macOS ou Ctrl+Shift+X no Windows e Linux).
  3. Na barra de pesquisa, digite mssql.
  4. Localize o SQL Server (mssql) nos resultados e selecione-o.
  5. Selecione o botão Instalar.

Captura de tela da extensão MSSQL no Visual Studio Code.

Dica

Você sabe que a extensão é instalada corretamente quando o ícone MSSQL aparece na Barra de Atividades e o modo de exibição Conexões fica disponível.

Interface do usuário moderna

A extensão MSSQL para o Visual Studio Code aprimora a experiência de desenvolvimento em SQL no SQL Server, no Azure SQL e no Banco de Dados SQL do Fabric.

Essa experiência fornece os seguintes recursos integrados, que são habilitados por padrão:

  • Caixa de diálogo de Conexão
  • Pesquisador de Objetos (filtragem)
  • Criador de Tabelas
  • Painel Resultados da Consulta
  • Visualizador de Plano de Consulta

Observação

Para usar recursos de visualização, incluindo Exibir &editar dados (versão prévia), habilite a mssql.enableExperimentalFeatures configuração no Visual Studio Code. Em Configurações>configuração do MSSQL, marque a caixa de seleção Habilitar Recursos Experimentais. Reinicie o Visual Studio Code para que a configuração entre em vigor.

Caixa de diálogo de conexão

A caixa de diálogo Conexão fornece uma interface simples e intuitiva para se conectar a bancos de dados hospedados no SQL do Azure (incluindo o Banco de Dados SQL do Azure, a Instância Gerenciada de SQL do Azure e o SQL Server em VMs do Azure), o Banco de Dados SQL no Fabric ou o SQL Server. Ele oferece várias opções de entrada para atender a diferentes cenários:

  • Parâmetros: insira detalhes de conexão individuais, como nome do servidor, nome de banco de dados, nome de usuário e senha.

  • Cadeia de conexão: insira diretamente uma cadeia de conexão completa para configurações mais avançadas.

  • Navegue pelo Azure: procure instâncias de banco de dados e bancos de dados disponíveis em sua conta do Azure, com opções para filtrar por assinatura, grupo de recursos e localização.

  • Grupos de conexões: organize ambientes agrupando conexões em pastas e atribuindo cores para identificação visual rápida. Atribua ou altere facilmente um grupo ao criar ou editar uma conexão.

A caixa de diálogo de conexão inclui conexões salvas e painéis conexões recentes para simplificar a reconexão a servidores usados anteriormente. O layout dá suporte à edição e ao salvamento de detalhes da conexão e facilita a alternância entre servidores ou bancos de dados.

Captura de tela do recurso de janela de diálogo de conexão.

Pesquisador de Objetos (filtragem)

O Pesquisador de Objetos permite explorar seus objetos de banco de dados, como bancos de dados, tabelas, exibições e itens de programação. A funcionalidade de filtragem aprimorada facilita a localização de objetos específicos em hierarquias de banco de dados grandes e complexas:

  • Aplicar Filtros: filtrar objetos de banco de dados por propriedades como nome, proprietário ou data de criação. Você pode aplicar filtros em vários níveis, incluindo bancos de dados, tabelas, exibições e programação.

  • Editar Filtros: refinar ou atualizar filtros existentes para restringir ainda mais a lista de objetos.

  • Limpar Filtros: Remova os filtros aplicados para exibir todos os objetos dentro da hierarquia.

Esses filtros oferecem flexibilidade e controle, facilitando o gerenciamento de bancos de dados grandes e a localização de objetos relevantes.

Captura de tela do recurso de filtro do pesquisador de objetos.

Criador de Tabelas

O Designer de Tabela fornece uma interface do usuário para criar e gerenciar tabelas para seus bancos de dados. Ele oferece recursos avançados para personalizar todos os aspectos da estrutura da tabela:

  • Colunas: adicione novas colunas, defina tipos de dados, defina a nulidade e especifique valores padrão. Você também pode designar uma coluna como uma chave primária ou coluna de identidade diretamente dentro da interface.

  • Chave Primária: defina uma ou mais colunas como a chave primária da tabela, garantindo que cada linha seja identificável exclusivamente.

  • Índices: crie e gerencie índices para melhorar o desempenho da consulta adicionando colunas extras como índices para recuperação de dados mais rápida.

  • Chaves Estrangeiras: defina relações entre tabelas adicionando chaves estrangeiras que fazem referência a chaves primárias em outras tabelas, garantindo a integridade dos dados entre tabelas.

  • Verificar restrições: configure regras para impor condições específicas nos dados que estão sendo inseridos, como intervalos de valores ou padrões.

  • Opções Avançadas: configure propriedades e comportamentos mais sofisticados, como controle de versão do sistema e tabelas com otimização de memória.

No designer, o painel Script As Create fornece um script T-SQL gerado automaticamente que reflete o design da tabela. Você tem as seguintes opções:

  • Publicar: aplique suas alterações diretamente ao banco de dados selecionando Publicar. Essa ação é alimentada pelo DacFX (Data-tier Application Framework), que garante a implantação suave e confiável de suas atualizações de esquema.

  • Copiar script: copie o script T-SQL gerado do painel de visualização para execução manual ou abra-o diretamente no editor para mais ajustes e modificações, conforme necessário.

Captura de tela do recurso de designer de tabela.

Exibir &editar dados (versão prévia)

Exibir &editar dados (versão prévia) fornece uma maneira intuitiva e interativa de navegar e modificar dados de tabela diretamente no editor sem escrever instruções DML (linguagem de manipulação de dados) Transact-SQL. Os desenvolvedores podem interagir com seus dados em uma interface intuitiva, simplificando tudo, desde edições rápidas até validação detalhada.

Para usar esse recurso, clique com o botão direito do mouse em uma tabela no Pesquisador de Objetos e selecione Exibir &Editar Dados (Versão Prévia). Os dados da tabela são abertos em uma grade de dados dentro de uma nova guia do editor, exibindo o conteúdo em um layout familiar, semelhante a uma planilha, com controles de paginação com base nas linhas configuradas por página.

As principais funcionalidades incluem:

  • Edição embutida: atualizar valores de célula diretamente dentro da grade. As edições são validadas em tempo real e retornam uma mensagem de erro para entradas incorretas, como tipos de dados inválidos ou violações de uma restrição. A grade realça a célula com a entrada incorreta em vermelho.

  • Adicionar e excluir linhas: insira novas linhas ou exclua as existentes, para que você possa ajustar rapidamente os dados durante o desenvolvimento e o teste.

  • Paginação: Carregue e navegue com eficiência grandes conjuntos de dados usando controles de paginação integrados para rolagem e desempenho suaves.

  • Salvar Alterações: todas as edições permanecem em um estado pendente até que você selecione Salvar Alterações, dando controle total sobre quando as atualizações são confirmadas no banco de dados.

  • Mostrar Script: este painel exibe um script DML de apenas leitura que reflete todas as ações realizadas na grade de dados em tempo real. Isso permite que você examine as operações DML subjacentes antes de salvar as alterações

Captura de tela da tela Editar Dados.

Painel de Resultados da Consulta

A extensão MSSQL para Visual Studio Code fornece uma experiência de resultados de consulta aprimorada, ajudando você a visualizar e entender com eficiência sua saída de dados. Os resultados da consulta são exibidos no painel inferior do Visual Studio Code, que também hospeda o terminal integrado, a saída, o console de depuração e outras ferramentas, criando uma interface unificada para facilitar o acesso.

Dica

Você pode abrir os resultados da consulta em uma nova guia para uma exibição expandida, semelhante à experiência anterior.

Os principais recursos do painel Resultados da Consulta incluem:

  • Exibição de Grade: exibe os resultados da consulta em um formato de grade familiar, para que você possa inspecionar facilmente os dados. Você pode exibir resultados em uma nova guia para uma exibição mais clara e organizada.

  • Opções de Cópia: clique com o botão direito do mouse na grade de resultados para acessar opções como Selecionar Tudo, Copiar, Copiar com Cabeçalhos e Copiar Cabeçalhos, tornando conveniente transferir dados para outros usos.

  • Salvar resultados da consulta: inclui a capacidade de salvar os resultados da consulta em vários formatos, como JSON, Excel e CSV, para que você possa trabalhar com os dados fora do Visual Studio Code.

  • Classificação embutida: você pode classificar os dados selecionando os cabeçalhos de coluna diretamente na exibição de resultados da consulta. A classificação pode ser feita em ordem crescente ou decrescente para facilitar a análise de subconjuntos específicos dos dados.

  • Plano Estimado: o botão Plano Estimado está localizado na barra de ferramentas de consulta, ao lado do botão Executar Consulta. Ele aparece como um ícone de fluxograma e permite que você gere um plano de execução estimado sem executar a consulta em si. Esse recurso fornece informações valiosas sobre o desempenho da consulta, ajudando a identificar possíveis gargalos e ineficiências antes de executar a consulta real.

  • Habilitar Plano Real: um botão rotulado Habilitar Plano Real, localizado logo após o botão Plano Estimado no canto superior direito do painel de resultados, permite exibir o plano de consulta real para consultas executadas. Essa adição fornece informações mais profundas sobre o desempenho da consulta e ajuda a identificar gargalos e ineficiências.

Essa experiência de resultados de consulta dá suporte a fluxos de trabalho comuns para exibir e trabalhar com conjuntos de resultados.

Captura de tela do recurso de resultados da consulta.

Dica

Você pode personalizar o comportamento dos resultados da consulta usando a mssql.openQueryResultsInTabByDefault configuração. Quando definido como true, os resultados da consulta são abertos em uma nova guia por padrão, ajudando a desclutter seu workspace.

Visualizador de Plano de Consulta

Use o Visualizador de Plano de Consulta na extensão MSSQL para Visual Studio Code para analisar o desempenho da consulta SQL exibindo planos de execução detalhados. Essa ferramenta fornece insights sobre como as consultas SQL são executadas, para que você possa identificar gargalos e otimizar suas consultas.

Os principais recursos e recursos incluem:

  • Navegação de nó: cada etapa no plano de execução aparece como um nó. Você pode interagir com o plano de maneiras diferentes. Selecione nós para exibir dicas de ferramentas ou informações detalhadas sobre operações específicas. Recolher ou expandir árvores de nó para simplificar a exibição e focar nas principais áreas do plano de consulta.
  • Controles de zoom: o visualizador oferece opções de zoom flexíveis para ajudar você a analisar o plano em detalhes. Você pode ampliar ou reduzir para ajustar o nível de detalhes. Use o recurso "zoom to fit" para redimensionar a exibição e ajustar todo o plano na tela. Defina níveis de zoom personalizados para examinar elementos específicos com precisão.
  • Métricas e Destaque: A barra de ferramentas de métricas ajuda você a analisar os principais indicadores de desempenho e destacar operações custosas. Selecione métricas como Tempo Decorrido Real, Custo, Custo da Subárvore ou Número de Linhas Lidas na lista suspensa para identificar gargalos. Use essas métricas para pesquisar nós específicos no plano de consulta para uma análise mais profunda.

A barra lateral direita fornece acesso rápido a mais ações:

  • Salvar Plano: salve o plano de execução atual para referência futura.
  • Abra XML: abra a representação XML do plano de consulta para inspecionar detalhes no nível do código.
  • Abrir Consulta: exiba a consulta que gerou o plano de execução diretamente da barra de ferramentas.
  • Alternar dicas de ferramenta: habilite ou desabilite dicas de ferramenta para obter mais detalhes sobre cada nó.
  • Propriedades: exiba as propriedades de cada nó no plano de execução, com opções para classificar por importância ou em ordem alfabética.

Captura de tela do recurso visualizador de plano de consulta.

Sistemas operacionais compatíveis

No momento, essa extensão é compatível com os seguintes sistemas operacionais:

  • Windows (x64, x86, Arm64)
  • macOS (x64, Arm64)
  • Linux Arm64
  • Ubuntu 18.04, 20.04, 22.04
  • Debian 10, 11, 12
  • CentOS 7, 8 e Oracle Linux 7, 8
  • Red Hat Enterprise Linux (RHEL) 8, 9
  • Fedora 35, 36
  • OpenSUSE Leap 15

Instalação offline

A extensão pode baixar e instalar um pacote necessário SqlToolsService durante a ativação. Você ainda pode usar a extensão para computadores sem acesso à Internet escolhendo a opção Instalar do VSIX... no modo de exibição Extensão e instalando uma versão empacotada na página Versões. Cada sistema operacional tem um .vsix arquivo com o serviço necessário incluído. Escolha o arquivo do sistema operacional, baixe-o e instale-o para começar. Escolha uma versão completa e ignore todas as versões alfa ou beta, pois são builds diários usados no teste.

Feedback e suporte

Se você tiver ideias, comentários ou quiser se envolver com a comunidade, participe da discussão no aka.ms/vscode-mssql-discussions. Para relatar um bug, visite https://aka.ms/vscode-mssql-bug. Para solicitar um novo recurso, vá para https://aka.ms/vscode-mssql-feature-request.

Conteúdo relacionado

  • Last updated on