Extensão postgreSQL para Visual Studio Code

A extensão PostgreSQL para Visual Studio Code (ms-ossdata.vscode-pgsql) traz ferramentas de desenvolvimento de banco de dados diretamente para seu editor. Você pode se conectar a servidores PostgreSQL locais, no local (on-premises) ou fornecidos na nuvem, escrever consultas com IntelliSense, explorar objetos do banco de dados, visualizar planos de consulta e esquemas e gerenciar recursos do Banco de Dados do Azure para PostgreSQL - Servidor Flexível, tudo sem sair do VS Code. A extensão também se integra aos assistentes de IA para criação de consulta assistida por IA, análise e fluxos de trabalho controlados por agente.

Note

A extensão também é executada no Cursor. Os recursos de IA do PostgreSQL são compatíveis com ambos os editores e seguem a experiência nativa de IA de cada editor: o Visual Studio Code inclui o participante de chat @pgsql, juntamente com o modo Agente e o registro de servidor MCP, enquanto o Cursor usa Connect AI (modo Agente) ou o registro de servidor MCP.

Introdução

Se você for novo na extensão, comece com um destes guias:

Objetivo Guide
Executar sua primeira consulta Início Rápido: Conectar e consultar o PostgreSQL
Encontre o artigo certo para sua tarefa Fluxos de trabalho comuns
Configurar identidade, TLS ou perfis salvos Conexões e identidade

Instalar a extensão

  1. Abra o Visual Studio Code.
  2. Abra a exibição Extensões (Ctrl+Shift+X, ou Cmd+Shift+X no macOS).
  3. Pesquise postgresql.
  4. Selecione PostgreSQL Microsoft e selecione Instalar.

Dica

Após a instalação, um ícone do PostgreSQL aparece na Barra de Atividades. Selecione-o para abrir o modo de exibição PostgreSQL, em que você gerencia conexões e explora objetos de banco de dados.

Características principais

As seções a seguir resumem cada principal área de funcionalidade. Selecione o link no final de cada seção para o artigo completo.

Caixa de diálogo de conexão

A caixa de diálogo de conexão conecta você a servidores PostgreSQL locais, on-premises e fornecidos na nuvem, com suporte à autenticação integrada para Microsoft Entra ID e AWS IAM (RDS/Aurora). Insira os parâmetros de conexão individualmente, cole uma cadeia de conexão ou navegue pelas suas assinaturas do Azure para descobrir servidores flexíveis do Banco de Dados do Azure para PostgreSQL e os clusters do Azure HorizonDB (versão prévia).

  • Três modos de entrada: parâmetros para valores individuais, como host, porta, banco de dados e nome de usuário; Connection String para um cadeia de conexão completo; ou procurar Azure para navegar em seus ativos Azure e selecionar um recurso com um ponto de extremidade PostgreSQL.
  • Conexões recentes e salvas: perfis salvos aparecem na lista Conexões para reutilização rápida; conexões usadas recentemente estão sempre disponíveis.
  • Grupos de servidores: organize conexões em grupos nomeados com codificação de cores para identificar rapidamente conexões na árvore Conexões .

Para obter detalhes, consulte Conexões e identidade e opções de conexão avançada.

Pesquisador de objetos

O pesquisador de objetos fornece uma exibição de árvore navegável dos servidores PostgreSQL conectados. Expanda servidores, bancos de dados e esquemas para inspecionar tabelas, exibições, funções, sequências, tipos, extensões, funções, espaços de tabela e gatilhos de evento.

  • Pesquisa: localize objetos por nome em todos os tipos de objeto com suporte com a pesquisa interna.
  • Scripts: clique com o botão direito do mouse em qualquer objeto para gerar SELECT, CREATE, ALTER, DROP ou EXECUTE scripts, que são abertos no editor de consultas.
  • Atualização profunda: atualize qualquer nó para atualizar recursivamente todos os descendentes expandidos, refletindo alterações de esquema sem desconectar.

Para obter detalhes, consulte Pesquisador de Objetos.

Editor de consultas e IntelliSense

O editor de consultas fornece uma superfície de edição avançada para o SQL do PostgreSQL. O IntelliSense oferece conclusões com reconhecimento de contexto para nomes de tabela, nomes de coluna, funções, esquemas, palavras-chave e cláusulas de junção.

  • Execute a Consulta e Execute a Instrução Atual: execute o conteúdo completo do editor ou apenas a instrução no cursor.
  • Trechos de código: insira padrões SQL comuns, como CREATE TABLE, INSERT e SELECT.
  • Histórico de consultas: acesse consultas executadas anteriormente na Paleta de Comandos para executá-las novamente ou modificá-las.

Para obter detalhes, consulte o Editor de Consultas e o IntelliSense.

Resultados da consulta

Os resultados aparecem no painel Resultados da Consulta PostgreSQL abaixo do editor. A grade de resultados dá suporte à classificação, filtragem e redimensionamento de coluna.

  • Exportação: salve os resultados em CSV, JSON ou Excel.
  • Visualização do gráfico: visualize os resultados como gráficos de linha, barra, pizza ou dispersão.
  • Visualização de grafo: os resultados das consultas de grafo do Apache AGE são alternados automaticamente para uma visualização de nós e arestas.
  • Aba Mensagens: revise as contagens de linhas, os tempos de execução e as mensagens do servidor.

Para obter detalhes, consulte o Editor de Consultas e o IntelliSense.

Visualizador de plano de consulta

O visualizador do plano de consulta apresenta a saída de EXPLAIN em vários formatos interativos para que você possa identificar gargalos de desempenho.

  • Quatro modos de exibição: Exibição em Árvore, Exibição Icicle, Exibição de Tabela e Exibição de Código-fonte.
  • Métricas: inspecione estimativas de custo, contagens reais de linhas, tempo de execução e uso de buffer por nó.
  • Planos de importação: visualizar arquivos de plano salvos ou conteúdo do editor sem uma conexão de banco de dados dinâmica.
  • Análise do Copilot: selecione Analisar com Copilot (ou Analisar com IA no Cursor) para ver uma explicação do plano gerada por IA.

Para obter detalhes, consulte Visualizador de plano de consulta.

Visualizador de esquema

O visualizador de esquema gera um diagrama interativo de relação de entidade. As tabelas aparecem como nós arrastáveis com colunas listadas dentro e relações de chave estrangeira são exibidas como bordas de conexão.

  • Esquemas codificados por cores: cada esquema recebe uma cor distinta para identificação rápida.
  • Alternar legenda: mostrar ou ocultar a legenda do esquema para maximizar o espaço do diagrama.

Para obter detalhes, consulte o visualizador de esquema.

Painel do servidor

O painel do servidor mostra as propriedades de conexão, a versão do servidor e o status SSL para qualquer servidor conectado. Para servidores flexíveis do Banco de Dados do Azure para PostgreSQL, também exibe métricas do Azure Monitor. As guias de investigação permitem que você analise áreas específicas da atividade do servidor.

  • Visão geral: monitorar CPU, memória, armazenamento, conexões, IOPS e outras métricas agrupadas por categoria.
  • Consultas: exiba as principais instruções SQL classificadas por tempo de execução, contagem de chamadas ou outras métricas, com detalhamento em detalhes de consulta individuais.
  • Esperas: analise eventos de espera com uma tabela ranqueada e um gráfico ao longo do tempo.
  • Sessões: inspecione sessões ativas, árvores de bloqueio e atividade de bloqueio.
  • Ações da barra de ferramentas: conectar, desconectar, abrir um novo editor de consultas, iniciar o visualizador de esquema, abrir um chat de IA ou iniciar Azure ações de gerenciamento na barra de ferramentas do painel.

Para obter detalhes, consulte o painel do servidor.

gerenciamento de servidor Azure

Gerencie Banco de Dados do Azure para PostgreSQL recursos de servidor flexíveis sem sair do VS Code.

  • Iniciar, parar e reiniciar: controlar o ciclo de vida do servidor da árvore Conexões ou do painel.
  • Regras de firewall: exibir e atualizar regras de acesso à rede.
  • Parâmetros: procurar e modificar parâmetros.
  • Clonar servidor: duplicar uma configuração de servidor existente.

Para obter detalhes, consulte Azure gerenciamento de servidor.

Criação de servidor

Provisione novos servidores PostgreSQL diretamente do VS Code.

  • Docker: crie um servidor PostgreSQL local em um contêiner do Docker para desenvolvimento e teste.
  • Servidor flexível do Banco de Dados do Azure para PostgreSQL: siga uma configuração guiada para configurar a região, a camada de computação, o armazenamento e a autenticação.
  • Azure HorizonDB (versão prévia): provisione um cluster PostgreSQL nativo de nuvem e altamente escalonável com vCores configuráveis e funcionalidades opcionais de IA.

Para obter detalhes, consulte Criar um servidor PostgreSQL.

Integração do copilot

A extensão se integra com assistentes de IA em chats, ações no editor e fluxos de trabalho de ferramentas em várias etapas.

  • @pgsql participante do Chat: faça perguntas em linguagem natural sobre seus bancos de dados, gere consultas ou obtenha ajuda sobre conceitos do PostgreSQL no painel do GitHub Copilot Chat. Visual Studio Code apenas. Para obter detalhes, consulte @pgsql participante do chat.
  • Ações do editor: clique com o botão direito do mouse no SQL no editor para explicar uma consulta, reescreva-a para otimização ou analise seu plano de execução do submenu ações de consulta de IA . Disponível no Visual Studio Code e no Cursor.
  • Modo de agente: o agente de IA invoca diretamente as ferramentas do PostgreSQL, combinando o raciocínio de IA com operações de banco de dados dinâmicas. Disponível tanto no Visual Studio Code quanto no Cursor. Para obter detalhes, consulte o modo agente.

Para obter uma visão geral de todos os recursos de IA, consulte integração do Copilot.

Servidor MCP

A extensão registra um servidor MCP (Model Context Protocol) que expõe as ferramentas do PostgreSQL, incluindo gerenciamento de conexões, exploração de esquema, execução de consulta e visualização de plano de consulta, para hosts habilitados para IA com suporte. As ferramentas de IA externas podem interagir com suas conexões PostgreSQL programaticamente por meio desse registro.

Para obter detalhes, consulte o servidor MCP.

Usar psql no terminal

Abra uma psql sessão de terminal conectada a qualquer banco de dados da árvore Conexões, ou execute arquivos .sql por meio de psql diretamente no menu de contexto do editor. Isso dá a você acesso total a recursos nativos psql, como \ metacomandos, COPY e scripts interativos.

Para obter detalhes, consulte Usar psql no terminal.

Migração do Oracle para PostgreSQL

Um fluxo de trabalho de migração assistido por IA ajuda você a converter esquemas e objetos de banco de dados Oracle em SQL compatível com PostgreSQL.

  • Migração guiada: conecte-se a uma fonte Oracle, selecione objetos para migrar e examine a saída convertida.
  • Conversão assistida por IA: um modelo Microsoft Foundry converte sintaxe, tipos de dados e código de procedimento específicos do Oracle para equivalentes postgreSQL.

Para obter detalhes, consulte a migração do Oracle para PostgreSQL.

Sistemas operacionais com suporte

Sistema operacional Architecture Observações
Windows x64, Arm64 Arm64 requer Windows 11.
macOS x64, Arm64 -
Linux x64, Arm64 Requer glibc 2.35 ou superior.

Feedback e suporte

Para relatar um bug ou solicitar um recurso, registre um problema no repositório vscode-pgsql GitHub.

Conteúdo relacionado

  • Last updated on