Partilhar via

Guia de início rápido: conectar e consultar um banco de dados com a extensão PostgreSQL para visualização do Visual Studio Code

A extensão PostgreSQL para Visual Studio Code é uma ferramenta poderosa projetada para agilizar o desenvolvimento e o gerenciamento de bancos de dados PostgreSQL. Este guia orienta você na conexão com um banco de dados PostgreSQL e na execução de consultas no ambiente do Visual Studio Code.

Pré-requisitos

Antes de começar, verifique se você tem as ferramentas e os recursos adequados baixados e instalados.

Essas ferramentas e recursos ajudam você a acompanhar este artigo e aproveitar ao máximo a integração do GitHub Copilot para a extensão PostgreSQL no Visual Studio Code.

Instalar a extensão PostgreSQL

Para instalar a extensão PostgreSQL:

  1. Abra o Código do Visual Studio e navegue até o modo de exibição Extensões selecionando o ícone Extensões na Barra de Atividades ou usando o comando Exibir: Extensões .
  2. Pesquise por PostgreSQL no Marketplace de Extensões.
  3. Selecione a extensão PostgreSQL criada pela Microsoft e selecione Instalar.

Uma vez instalada, a página PostgreSQL, representada por um ícone de elefante, aparece na barra lateral do Visual Studio Code.

Adicionar uma conexão ao PostgreSQL

Seja hospedado localmente ou em um servidor remoto, conectar-se a um banco de dados PostgreSQL é uma etapa fundamental no gerenciamento e interação com seus dados. Esse processo envolve o fornecimento dos detalhes de conexão necessários, como o endereço do servidor, a porta e as credenciais de autenticação, para estabelecer um vínculo seguro entre o aplicativo cliente e o banco de dados. Com a extensão PostgreSQL para Visual Studio Code, você pode se conectar perfeitamente ao seu banco de dados e usar ferramentas poderosas para consultar, gerenciar e explorar seus dados de forma eficiente.

  1. Selecione o ícone de elefante na barra lateral para abrir a página de extensão do PostgreSQL.

  2. Selecione o botão Adicionar conexão .

  3. Introduza os detalhes da ligação manualmente ou utilize o formato de cadeia de ligação:

      psql -h <server>.postgres.database.azure.com -p 5432 -U

  4. Se estiver usando o Azure, entre em sua conta do Azure e procure a instância do banco de dados. Filtre por assinatura, grupo de recursos, servidor e nome do banco de dados.

Autenticação

A extensão suporta dois métodos de autenticação:

  • Nome de usuário/senha: insira suas credenciais de banco de dados diretamente nos campos de conexão.
  • Autenticação de ID do Microsoft Entra: adicione sua conta de ID do Microsoft Entra para bancos de dados hospedados pelo Azure.

Captura de tela da caixa de diálogo de conexão da extensão PostgreSQL para VS Code.

Testar e salvar a conexão

  1. Selecione "Testar conexão" para verificar os detalhes da conexão.
  2. Após o teste bem-sucedido, a caixa de teste exibe uma marca de seleção.
  3. Selecione "Conectar" para estabelecer a conexão.
  4. Sua conexão é salva automaticamente e aparece na janela Conexões.

Explorar objetos de banco de dados

O Pesquisador de Objetos fornece uma exibição hierárquica de seus objetos de banco de dados:

  • Expanda o item de banco de dados para exibir esquemas, tabelas, exibições, funções e procedimentos armazenados.
  • Clique com o botão direito do mouse no banco de dados e você verá opções para: - Iniciar uma nova consulta - Bate-papo com este banco de dados (inicia a experiência de bate-papo pgsql) - Conecte-se com PSQL para iniciar uma conexão de terminal psql
  • Clique com o botão direito do rato numa tabela e selecione "Selecionar Top 1000" para visualizar os seus dados. A consulta é aberta no Editor de Consultas e os resultados aparecem na guia Visualizador de Resultados.

Executar consultas

Use o Editor de Consultas para rascunhar e executar consultas SQL:

  • Aproveite o IntelliSense sensível ao contexto para preencher automaticamente palavras-chave SQL e nomes de objetos.
  • O realce da sintaxe e a formatação automática garantem uma melhor legibilidade e precisão.
  • Aceda a consultas executadas anteriormente através do painel Histórico de Consultas.

Rever os resultados da consulta

O Visualizador de Resultados oferece recursos avançados para interagir com os resultados da consulta:

  • Exporte os resultados para os formatos CSV, JSON ou Excel para análise posterior.
  • Use as opções de pesquisa, filtro e classificação para refinar seus dados.
  • As visualizações de dados persistentes mantêm o contexto enquanto alternam entre guias.

Use o GitHub Copilot para assistência avançada

A integração do GitHub Copilot aprimora sua experiência de desenvolvimento do PostgreSQL fornecendo sugestões de código alimentadas por IA, dicas de otimização de consultas e assistência interativa de banco de dados. Esse recurso permite que você simplifique seu fluxo de trabalho, reduza o tempo de desenvolvimento e obtenha insights mais profundos sobre suas operações de banco de dados. Esta seção o orienta pelas etapas para ativar e utilizar o Copilot dentro da extensão PostgreSQL para Visual Studio Code.

Verifique se as extensões GitHub Copilot e Copilot Chat estão instaladas.

Faça login na sua conta do GitHub e ative o agente do @pgsql Copilot Chat nas configurações da extensão.

Prompts de banco de dados interativos

Clique com o botão direito do mouse em um banco de dados e escolha Conversar com esse banco de dados para interagir com o Copilot.

Escreva prompts como o exemplo abaixo para receber informações e sugestões detalhadas.

@pgsql tell me about the tables in the HR schema

Para saber mais, visite Configurar o Copiloto do GitHub

Conectar-se a um Banco de Dados do Azure para instância do Servidor Flexível PostgreSQL com VS Code a partir do portal do Azure

Para se conectar a uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL usando o Visual Studio Code, siga estas etapas:

  1. Entre no portal do Azure e localize sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL.
  2. Vá para a página Visão geral da instância do servidor.

Conecte-se com o VS Code

A opção "Conectar com o Visual Studio Code" no portal do Azure simplifica a conexão ao seu Banco de Dados do Azure para o Servidor Flexível PostgreSQL. Este recurso simplifica a configuração, orientando-o através dos pré-requisitos necessários e configurando automaticamente os detalhes da conexão. Usando essa integração, você pode estabelecer rapidamente uma conexão e gerenciar seu banco de dados diretamente no ambiente do Visual Studio Code.

  • Selecione o botão proeminente Conectar com VS Code na página Visão geral.
  • Um painel lateral listando os requisitos para se conectar usando o VS Code é exibido.

Captura de ecrã do portal do Azure a mostrar uma instância da Base de Dados do Azure para PostgreSQL com o botão Conectar-se com Visual Studio Code.

Confirmar requisitos

  • No painel lateral, confirme se todos os pré-requisitos (VS Code e extensão PostgreSQL) estão satisfeitos marcando as caixas de seleção apropriadas.

  • Se necessário, baixe o Visual Studio Code e a extensão usando os links no painel lateral.

  • Opcionalmente, preencha os parâmetros de conexão, como o nome do banco de dados padrão, o método de autenticação e o pool de conexões.

    Captura de ecrã do portal do Azure que mostra uma instância da Base de Dados do Azure para PostgreSQL com o painel Ligar com VS Code. O botão Abrir no Visual Studio Code é realçado.

Abrir com o Visual Studio Code

  • Selecione o botão Abrir no Visual Studio Code no painel lateral.
  • Um botão "Repetir abertura no Visual Studio Code" aparece no painel lateral caso o Visual Studio Code e a extensão estejam demorando mais de 40 segundos para abrir.

Abra o Visual Studio Code.

  • Se o VS Code estiver instalado e em execução, a caixa de diálogo de conexão da extensão PostgreSQL será iniciada automaticamente.
  • Se o VS Code estiver instalado, mas não aberto, ele será iniciado em aproximadamente 40 segundos, seguido pela caixa de diálogo de conexão.

Preenchimento automático de detalhes de conexão

A caixa de diálogo de conexão da extensão PostgreSQL abre-se, e o campo Nome do Servidor preenche automaticamente o endereço do servidor.

Captura de tela da extensão PostgreSQL para VS Code Connection Dialog com os detalhes do nome do servidor pré-preenchidos.

Fornecer detalhes de autenticação

Selecione o seu método de autenticação preferido:

  • Autenticação de senha: Digite seu nome de usuário e senha manualmente.
  • Autenticação do Entra: Insira as credenciais da sua conta do Azure.

Especifique outros detalhes de conexão, como Nome do Perfil, Nome do Banco de Dados (opcional), Grupo de Servidores e Número da Porta.

Salve e conecte-se

Selecione o botão Salvar & Conectar para estabelecer a conexão. Uma vez conectado, expanda o servidor na árvore do Pesquisador de Objetos para exibir bancos de dados, esquemas e tabelas ou use a ferramenta de consulta interna para gerenciar seus objetos de banco de dados.

Solucionar problemas

Se você encontrar problemas durante o processo de conexão:

  • Verifique se o VS Code e a extensão PostgreSQL estão instalados e habilitados.

  • Verifique se o endereço IP é permitido nas configurações de firewall do seu Banco de Dados do Azure para PostgreSQL.

  • Se os pré-requisitos não forem atendidos, o painel lateral fornecerá comentários e etapas para resolver o problema, incluindo novas tentativas de conexão.

Comentários e suporte

Para bugs, solicitações de recursos e problemas, use a ferramenta de comentários interna no Visual Studio Code. Você pode concluir isso através do menu Ajuda do VS Code ou da paleta de comandos PGSQL.

  • Menu Ajuda

    • Ir para Ajuda > Comunicar Problema

  • Paleta de comandos

    • Abra a Paleta de Comandos com Ctrl + Shift + P e execute: PGSQL: Report Issue

Conteúdo relacionado