O que é a extensão PostgreSQL para Visual Studio Code? (versão prévia)

A extensão PostgreSQL para Visual Studio Code simplifica o gerenciamento e o desenvolvimento do banco de dados PostgreSQL. Você pode se conectar a bancos de dados PostgreSQL, gravar e executar consultas e gerenciar objetos de banco de dados sem sair Visual Studio Code.

A extensão se integra aos serviços postgreSQL gerenciados por Azure, incluindo:

  • Azure HorizonDB - um serviço PostgreSQL nativo de nuvem criado para cargas de trabalho corporativas de camada 1. O HorizonDB conta com uma arquitetura de armazenamento/computação desagregada, confirmações de baixa latência, failover rápido, expansão de leitura com balanceamento de carga entre réplicas de HA legíveis e integração de IA profunda.

A mesma extensão funciona com ambos os serviços. Quando o comportamento é diferente (por exemplo, pontos de extremidade de conexão ou métodos de autenticação compatíveis), isso é destacado nas seções a seguir.

Como instalar a extensão

Você pode instalar a extensão PostgreSQL diretamente do Extensions Marketplace no Visual Studio Code. Siga estas etapas:

  1. Abra o modo de exibição Extensões no Visual Studio Code selecionando o ícone Extensions na Barra de Atividades ou usando o comando View: Extensions.
  2. Pesquise postgreSQL no Marketplace de Extensões.
  3. Selecione a extensão PostgreSQL criada pela Microsoft e selecione Instalar.

Quando você instala a extensão, um ícone de elefante aparece para representar a página PostgreSQL na barra lateral do Visual Studio Code.

Features

A extensão PostgreSQL para Visual Studio Code fornece os seguintes recursos para Azure HorizonDB.

Gerenciador de Conexões

O Gerenciador de Conexões simplifica a conexão com bancos de dados PostgreSQL locais e hospedados na nuvem. As principais funcionalidades incluem:

  • Suporte para vários perfis de conexão, para que você possa se conectar e gerenciar várias instâncias do PostgreSQL lado a lado, incluindo uma combinação de clusters Azure HorizonDB.
  • Análise da string de conexão para conectividade sem interrupções, seja ao se conectar a um banco de dados local ou a um cluster do Azure HorizonDB.
  • Integração com Azure HorizonDB para navegação direta e filtragem de instâncias por assinatura, grupo de recursos, servidor/cluster e banco de dados.

pontos de extremidade de conexão do Azure HorizonDB

Azure HorizonDB expõe dois pontos de extremidade, que você pode adicionar como perfis de conexão separados na extensão:

  • Ponto de extremidade de leitura/gravação – Conecta-se ao primário, que aceita transações de leitura e gravação. Use esse ponto de extremidade para gravações de aplicativo, alterações de esquema e qualquer carga de trabalho de leitura que exija os dados confirmados mais recentes. O endpoint está listado na página Overview do cluster e na página Replicas do portal do Azure.
  • Ponto de extremidade do leitor – Faz o balanço automático das conexões somente leitura entre todas as réplicas de HA legíveis no cluster. Use esse ponto de extremidade para cargas de trabalho de expansão de leitura, relatórios e análises. Atualmente, há suporte para até quatro réplicas de HA legíveis (aumentando para 8), cada uma dimensionada de forma idêntica à primária.

Um padrão típico é salvar dois perfis no Gerenciador de Conexões - um apontado para o ponto de extremidade de leitura/gravação e outro apontado para o ponto de extremidade do leitor - e alternar entre eles no Pesquisador de Objetos com base na tarefa em questão.

Pesquisador de Objetos

O Pesquisador de Objetos aprimorado fornece uma exibição hierárquica de objetos de banco de dados, facilitando a navegação e o gerenciamento de esquemas, tabelas, exibições e funções. Os recursos notáveis incluem:

  • Opções avançadas de filtragem para localizar rapidamente objetos específicos.
  • Recursos para criar, modificar e excluir objetos de banco de dados, como tabelas, exibições e procedimentos armazenados.
  • Visualização de esquemas de banco de dados e relações para navegação simplificada.
  • Para Azure HorizonDB, você pode inspecionar as mais de 55 extensões listadas em permissão disponíveis no cluster por meio da exibição de catálogo pg_available_extensions diretamente do Editor de Consultas.

Editor de Consultas

O Editor de Consultas melhora a experiência de elaboração e execução da consulta com:

  • IntelliSense com reconhecimento de contexto para preenchimento automático de palavras-chave, nomes de tabela e funções do SQL.
  • Realce de sintaxe e formatação automática para melhor legibilidade de consulta.
  • Acompanhamento do histórico de consultas, para que você possa reutilizar consultas executadas anteriormente.

Visualizador de Resultados

O Visualizador de Resultados permite que você interaja com os resultados da consulta por meio de recursos como:

  • Exportando resultados para formatos CSV, JSON ou Excel.
  • Pesquise, filtre e classifique as opções para analisar dados com eficiência.
  • Exibições de dados persistentes para manter o contexto durante a navegação entre guias.

Visualização de esquema

O Visualizador de Esquema fornece uma exibição interativa baseada em diagrama da estrutura do banco de dados sem gravar nenhum SQL. Clique com o botão direito do mouse em um banco de dados (ou qualquer objeto abaixo dele) no Pesquisador de Objetos e selecione Visualize Esquema para iniciar o visualizador.

As principais funcionalidades incluem:

  • Exibição de tabela completa – cada tabela é renderizada como um cartão mostrando suas colunas e tipos de dados.
  • Linhas de relação – as relações de chave estrangeira entre tabelas são desenhadas como linhas de conexão, para que você possa ver rapidamente como seu modelo de dados se encaixa.
  • Organização baseada em esquema – as tabelas são agrupadas por seu esquema pai (por exemplo, public, , hr, ), ecomfacilitando a navegação de grandes bancos de dados.
  • Mostrar/ocultar por esquema – ativar ou desativar esquemas inteiros para se concentrar apenas nas partes do modelo que você se importa e manter diagramas legíveis em bancos de dados grandes.
  • Panorâmica e zoom – Navegue por diagramas grandes com controles de panorâmica, zoom e ajuste à tela padrão.

A Visualização de Esquema funciona em qualquer banco de dados conectado, incluindo clusters PostgreSQL locais e Azure HorizonDB.

Visualização do Apache AGE Graph

O Apache AGE Graph Visualizer permite executar consultas do Apache AGE Cypher e explorar os resultados como um grafo interativo de arestas e nós. A extensão detecta automaticamente os resultados das consultas de gráficos e os exibe em um explorador visual com legendas por nó, controles de zoom e deslocamento, suporte à exportação e estilo adaptado ao tema.

A extensão age está na lista de permissões por padrão no Azure HorizonDB, de modo que as cargas de trabalho de grafos podem ser executadas em um cluster do HorizonDB sem configuração adicional. Os mesmos requisitos se aplicam quando você cria consultas cypher no HorizonDB:

  • Retornar objetos completos, não propriedades escalares – o visualizador de grafo precisa de objetos completos de vértice e borda. Consultas que extraem propriedades escalares (RETURN p.name, p.title) retornam valores de texto sem formatação e não são renderizadas no visualizador. Em vez disso, retorne os objetos completos e nomeie a variável de relação:

    SELECT * FROM cypher('my_graph', $$
    MATCH (a:Product)-[r:BOUGHT_TOGETHER]->(b:Product)
    RETURN a, r, b
$$) AS (a agtype, r agtype, b agtype);

  • Defina disp_label para um texto significativo para o nó - Sem disp_label, os nós exibem IDs internas. Defina essa propriedade para que o visualizador mostre rótulos úteis:

    SELECT * FROM cypher('my_graph', $$
    MATCH (a:Product)-[r:BOUGHT_TOGETHER]->(b:Product)
    SET a.disp_label = a.title
    SET b.disp_label = b.title
    RETURN a, r, b
$$) AS (a agtype, r agtype, b agtype);

  • Corresponder colunas de saída a objetos retornados – a cláusula wrapper AS (...) deve ter uma coluna por objeto retornado. Para consultas com vários saltos, inclua todos os nós e arestas intermediários:

    SELECT * FROM cypher('my_graph', $$
    MATCH (a:Product)-[r1:BOUGHT_TOGETHER]->(mid:Product)-[r2:BOUGHT_TOGETHER]->(b:Product)
    RETURN a, r1, mid, r2, b
$$) AS (a agtype, r1 agtype, mid agtype, r2 agtype, b agtype);

Integração de IA (Azure HorizonDB)

Quando conectada a um cluster Azure HorizonDB, a extensão fornece uma superfície de criação de primeira classe para os recursos de IA do HorizonDB, que são expostos como extensões e funções padrão do PostgreSQL:

  • pgvector
    • Tipos de dados de vetor e operadores de similaridade.
  • pg_diskann
    • Índice de vetor de alto desempenho com Filtragem Avançada, que avalia predicados WHERE durante a passagem do grafo vetor para que as consultas de similaridade filtradas retornem de forma mais rápida e consistente.
  • azure_ai
    • Funções de IA, como azure_ai.generate(), azure_ai.is_true()e azure_ai.extract()azure_openai.create_embeddings().
  • Gerenciamento de Modelo de IA (versão prévia limitada)
    • Quando habilitado no cluster, o HorizonDB provisiona automaticamente um modelo de chat padrão (gpt-5) e um modelo de inserção padrão (text-embedding-3-small) por meio de Microsoft Foundry, instala e configura azure_ai e conecta as Funções de IA a esses modelos gerenciados - sem necessidade de manipulação manual de chaves. Você também pode registrar as próprias implantações do Microsoft Foundry (Traga o seu Próprio Modelo) e chamá-las por alias pelas mesmas funções de IA.

Você pode criar e executar diretamente essas cargas de trabalho de IA pelo Editor de Consultas, e o Visualizador de Resultados renderiza o vetor e a saída JSONB em linha.

Pipelines e fluxos de trabalho

Ao se conectar a um cluster do Azure HorizonDB com pipelines de IA ou pg_durable workflows, a extensão fornece uma visualização Pipelines e Fluxos de Trabalho para inspecionar o histórico de execução e monitorar o status das execuções.

Acesse-o clicando com o botão direito do mouse em seu banco de dados e selecionando Pipelines &Fluxos de Trabalho. Você verá duas guias:

  • Pipelines de IA: exibir definições de pipeline, inspecionar execuções e acompanhar grafos de execução com tipos de etapa codificados por cores (azul para origem/coletor, verde para processamento, rosa para chamadas externas). Use isto para verificar o comportamento do pipeline e consultar o status da execução, os IDs de execução, os horários de início e a duração.
  • Fluxos de trabalho: Inspecione pg_durable instâncias do fluxo de trabalho com guias para gráficos, análise temporal e resultados. Navegue de uma execução de fluxo de trabalho até sua definição de pipeline correspondente para comparar e solucionar problemas.

Essa exibição elimina a necessidade de alternar entre consultas SQL e seu editor, facilitando o monitoramento de cargas de trabalho de IA de longa execução e pg_durable orquestrações.

Integração do GitHub Copilot

Essa extensão se integra ao GitHub Copilot para oferecer assistência orientada por IA adaptada ao desenvolvimento do PostgreSQL. Com comandos como @pgsql, você pode consultar seu banco de dados, otimizar seu esquema e solicitar Copilot para executar operações SQL específicas em um cluster Azure HorizonDB. O Copilot capta o contexto da conexão ativa — incluindo as extensões instaladas no destino —, de modo que as sugestões em uma conexão HorizonDB levam em conta pgvector, pg_diskann, azure_ai e age.

Sistemas operacionais com suporte

A extensão PostgreSQL funciona com os seguintes sistemas operacionais:

  • Windows
  • macOS
  • Linux

A extensão dá suporte a várias distribuições do Linux, incluindo Ubuntu, Fedora e Red Hat Enterprise Linux.

Feedback e suporte

Para bugs, solicitações de recursos e problemas, use a ferramenta de comentários interna no Visual Studio Code. Você pode concluir esses comentários por meio do menu ajuda do Visual Studio Code ou da paleta de comandos PGSQL.

  • Menu Ajuda
    • Vá para Ajuda Relatar Problema>
  • Paleta de comandos
    • Abra a Paleta de Comandos com Ctrl + Shift + P e execute: PGSQL: Report Issue

Conteúdo relacionado

  • Last updated on