Extensão PostgreSQL para Visual Studio Code

A extensão PostgreSQL para Visual Studio Code (ms-ossdata.vscode-pgsql) traz ferramentas de desenvolvimento de bases de dados diretamente para o seu editor. Pode ligar-se a servidores PostgreSQL locais, on-premises ou fornecidos na cloud, escrever consultas com IntelliSense, explorar objetos de base de dados, visualizar planos e esquemas de consulta, e gerir recursos flexíveis do Base de Dados do Azure para PostgreSQL, tudo isto sem sair do VS Code. A extensão integra-se também com assistentes de IA para autoria de consultas, análise assistida por IA e fluxos de trabalho orientados por agentes.

Introdução

Se és novo nesta extensão, começa por um destes guias:

Instalar a extensão

1. Abre Visual Studio Code.
2. Abre a vista de Extensões (Ctrl+Shift+X, ou Cmd+Shift+X no macOS).
3. Pesquisar por postgresql.
4. Selecione PostgreSQL da Microsoft e depois selecione Instalar.

Principais características

As secções seguintes resumem cada área principal de características. Selecione o link no final de cada secção para o artigo completo.

Caixa de diálogo Ligação

A caixa de diálogo de ligação permite ligar-se a servidores PostgreSQL locais, instalados no local e fornecidos pela cloud, com suporte de autenticação integrada para Microsoft Entra ID e AWS IAM (RDS/Aurora). Insira os parâmetros de ligação individualmente, cole uma cadeia de ligação ou navegue pelas suas subscrições do Azure para descobrir servidores flexíveis do Base de Dados do Azure para PostgreSQL e clusters Azure HorizonDB (Preview).

• Três modos de entrada: parâmetros para valores individuais como anfitrião, porta, base de dados e nome de utilizador; Connection String para uma cadeia de ligação completa; ou Navegue pelo Azure para navegar pelos seus ativos Azure e selecionar um recurso com um endpoint PostgreSQL.
• Ligações guardadas e recentes: os perfis guardados aparecem na lista de Ligações para reutilização rápida; As ligações recentemente usadas estão sempre disponíveis.
• Grupos de servidores: organizam as ligações em grupos nomeados com codificação por cores para identificar rapidamente as ligações na árvore de Conexões .

Para mais detalhes, consulte Ligações e identidadee Opções avançadas de ligação.

Pesquisador de objetos

O explorador de objetos fornece uma vista em árvore navegável dos seus servidores PostgreSQL ligados. Expanda servidores, bases de dados e esquemas para inspecionar tabelas, vistas, funções, sequências, tipos, extensões, papéis, espaços de tabelas e acionadores de eventos.

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

Para mais detalhes, veja Object explorer.

Editor de consultas e IntelliSense

O editor de consultas fornece uma superfície de edição rica para PostgreSQL SQL. O IntelliSense oferece sugestões contextuais para nomes de tabelas, nomes de colunas, funções, esquemas, palavras-chave e cláusulas JOIN.

• Executar Consulta e Executar Instrução Atual: execute o conteúdo completo do editor ou apenas a instrução no cursor.
• Excertos de código: inserir padrões SQL comuns como CREATE TABLE, INSERT, e SELECT.
• Histórico de consultas: acede às consultas já executadas anteriormente a partir da Paleta de Comandos para as reexecutar ou modificar.

Para mais detalhes, consulte Editor de Consultas e IntelliSense.

Resultados da consulta

Os resultados aparecem no painel de Resultados da Consulta PostgreSQL abaixo do editor. A grelha de resultados suporta ordenação, filtragem e redimensionamento de colunas.

• Exportar: guardar os resultados para CSV, JSON ou Excel.
• Visualização em gráfico: visualize os resultados como gráficos de linhas, barras, circulares ou de dispersão.
• Vista de grafo: Os resultados das consultas ao grafo do Apache AGE são apresentados automaticamente numa vista de nós e arestas.
• Separador de Mensagens: revê a contagem de linhas, tempos de execução e mensagens do servidor.

Para mais detalhes, consulte Editor de Consultas e IntelliSense.

Visualizador de plano de consulta

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

• Quatro vistas: Vista em Árvore, Vista em Icicle, Vista de Tabela e Vista de Origem.
• Métricas: inspecionem estimativas de custo, contagem real de linhas, tempo de execução e utilização do buffer por nó.
• Importar planos: visualizar ficheiros de planos guardados ou conteúdo do editor sem uma ligação ativa à base de dados.
• Análise do Copilot: selecione Analisar com Copilot (ou Analisar com IA no Cursor) para uma explicação gerada por IA do plano.

Para mais detalhes, veja Visualizador de plano de consulta.

Visualizador de esquema

O visualizador de esquemas gera um diagrama interativo entidade-relação. As tabelas aparecem como nós que podem ser arrastados, com as colunas listadas no seu interior, e as relações de chave estrangeira são apresentadas como arestas de ligação entre elas.

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

Para mais detalhes, consulte Visualizador de esquema.

Painel de controlo do servidor

O painel do servidor mostra propriedades de ligação, versão do servidor e estado SSL para qualquer servidor ligado. Para os servidores flexíveis do Base de Dados do Azure para PostgreSQL, também mostra métricas do Azure Monitor. Os separadores de análise permitem aprofundar áreas específicas da atividade do servidor.

• Visão geral: monitorizar CPU, memória, armazenamento, ligações, IOPS e outras métricas agrupadas por categoria.
• Consultas: visualize as principais instruções SQL ordenadas por tempo de execução, número de chamadas ou outras métricas, com detalhe detalhado individual da consulta.
• Esperas: analisar eventos de espera com uma tabela classificada e um gráfico ao longo do tempo.
• Sessões: inspeção de sessões ativas, árvores de bloqueio e atividade de bloqueios.
• Ações da barra de ferramentas: ligar, desligar, abrir um novo editor de consultas, iniciar o visualizador de esquemas, abrir um chat de IA ou iniciar ações de gestão do Azure a partir da barra de ferramentas do dashboard.

Para detalhes, consulte o painel do servidor.

Gestão de servidores do Azure

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

• Iniciar, parar e reiniciar: controla o ciclo de vida do servidor a partir da árvore de Ligações ou do dashboard.
• Regras de firewall: visualizar e atualizar as regras de acesso à rede.
• Parâmetros: navegar e modificar parâmetros.
• Clonar servidor: duplicar uma configuração de servidor existente.

Para mais detalhes, consulte gestão de servidores Azure.

Criação de servidores

Provisionar novos servidores PostgreSQL diretamente a partir do VS Code.

• Docker: criar um servidor PostgreSQL local num contentor Docker para desenvolvimento e testes.
• Servidor flexível do Base de Dados do Azure para PostgreSQL: percorra uma configuração guiada que configura a região, o escalão de computação, o armazenamento e a autenticação.
• Azure HorizonDB (Pré-visualização): aprovisionar um cluster PostgreSQL nativo da nuvem, altamente escalável, com vCores configuráveis e funcionalidades de IA opcionais.

Para mais detalhes, consulte Criar um servidor PostgreSQL.

Integração com Copilot

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

• @pgsql participante no chat: faça perguntas em linguagem natural sobre as suas bases de dados, gere consultas ou obtenha ajuda sobre conceitos do PostgreSQL no painel GitHub Copilot Chat. Apenas Visual Studio Code. Para mais detalhes, veja @pgsql participante do chat.
• Ações do editor: clique com o botão direito em SQL no editor para explicar uma consulta, reescreva-a para otimização ou analise o seu plano de execução a partir do submenu de Ações de Consulta de IA . Disponível tanto no Visual Studio Code como no Cursor.
• Modo agente: o agente de IA invoca diretamente as ferramentas PostgreSQL, combinando raciocínio de IA com operações de base de dados em tempo real. Disponível tanto no Visual Studio Code como no Cursor. Para mais detalhes, veja Modo Agente.

Para uma visão geral de todas as capacidades de IA, veja integração com o Copilot.

Servidor MCP

A extensão regista um servidor Model Context Protocol (MCP) que expõe ferramentas PostgreSQL, incluindo gestão de ligações, exploração de esquemas, execução de consultas e visualização de planos de consulta, a hosts suportados por IA. Ferramentas de IA externas podem interagir programaticamente com as suas ligações PostgreSQL através deste registo.

Para mais detalhes, consulte o servidor MCP.

Usa psql no terminal

Abra uma psql sessão de terminal ligada a qualquer base de dados na árvore de Conexões, ou execute ficheiros .sql através de psql diretamente a partir do menu contextual do editor. Isto dá-lhe acesso total a funcionalidades psql nativas, como \ metacomandos, COPY e criação interativa de scripts.

Para detalhes, veja Usar psql no terminal.

Migração de Oracle para PostgreSQL

Um fluxo de trabalho de migração assistido por IA ajuda-o a converter esquemas e objetos da base de dados Oracle para SQL compatível com PostgreSQL.

• Migração guiada: liga-te a uma fonte Oracle, seleciona objetos a migrar e revê a saída convertida.
• Conversão assistida por IA: Um modelo Microsoft Foundry traduz sintaxe específica da Oracle, tipos de dados e código procedural para equivalentes PostgreSQL.

Para mais detalhes, veja migração de Oracle para PostgreSQL.

Sistemas operativos suportados

Comentários e suporte

Para reportar um bug ou solicitar uma funcionalidade, apresente uma questão no repositório GitHub do vscode-pgsql.

Conteúdo relacionado

• Início Rápido: Ligue e consulte o PostgreSQL
• Ligações e identidade
• Editor de consultas e IntelliSense
• Integração com Copilot