Partilhar via

Início Rápido: Ligue e consulte uma base de dados com a extensão PostgreSQL para 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.

Prerequisites

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 Visual Studio Code e vá à vista de Extensões selecionando o ícone de Extensões na Barra de Atividades ou usando o comando View: Extensions .
  2. Pesquise por PostgreSQL no Marketplace de Extensões.
  3. Selecione a extensão PostgreSQL criada pela Microsoft e selecione Instalar.

Quando a extensão é instalada, a página PostgreSQL, representada por um ícone de elefante, aparece na barra lateral 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.

Authentication

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 ecrã da extensão PostgreSQL para o diálogo de ligação Visual Studio Code.

Testar e salvar a conexão

  1. Selecione Testar Ligação para verificar os detalhes da sua ligaçã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. A sua ligação é guardada automaticamente e aparece na janela de Ligaçõ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 na base de dados para ver as opções para:
    • Lançar uma Nova Consulta
    • Converse com esta base de dados (inicia a experiência de chat pgsql)
    • Ligue-se ao PSQL para iniciar uma ligação de terminal psql
  • Clique com o botão direito 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.
  • Use realce de sintaxe e autoformatação para 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. Esta funcionalidade ajuda-o a simplificar o seu fluxo de trabalho, reduzir o tempo de desenvolvimento e obter uma compreensão mais profunda das operações da sua base de dados. Esta secção guia-o pelos passos para ativar e usar o Copilot na 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 numa base de dados e selecione Chatar com esta base de dados para interagir com o Copilot.

Escreva prompts como o seguinte exemplo para receber insights e sugestões detalhadas.

@pgsql tell me about the tables in the HR schema

Para mais informações, consulte Configurar o GitHub Copilot.

Liga-te ao Azure Database para PostgreSQL com Visual Studio Code

Ligue-se a uma base de dados Azure para uma instância de servidor flexível PostgreSQL usando Visual Studio Code, seguindo estes passos:

  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á à página de Visão Geral da sua instância de servidor.

Liga-te ao Visual Studio Code

A opção "Conectar-se com o Visual Studio Code" no portal do Azure simplifica a conexão com sua instância de servidor flexível do Banco de Dados do Azure para 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 Ligar com destaque com o Visual Studio Code na página visão geral.
  • Aparece um painel lateral que lista os requisitos para se ligar usando o Visual Studio Code.

Captura de ecrã do portal Azure mostrando uma Base de Dados Azure para uma instância PostgreSQL com o botão Ligar ao Visual Studio Code.

Confirmar requisitos

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

  • Se necessário, descarregue 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 Azure a mostrar uma instância de base de dados Azure para PostgreSQL com o painel de Conectar com o Visual Studio Code. O botão de abrir no Visual Studio Code está destacado.

Abrir com o Visual Studio Code

  • Selecione o botão Abrir no Visual Studio Code no painel lateral.
  • Se o Visual Studio Code e a extensão demorarem mais de 40 segundos a abrir, um botão de Abertura de Tentativa no Visual Studio Code aparece no painel lateral.

Abra o Visual Studio Code.

  • Se o Visual Studio Code estiver instalado e a funcionar, a caixa de diálogo de ligação da extensão PostgreSQL inicia-se automaticamente.
  • Se o Visual Studio Code estiver instalado mas não aberto, inicia-se em aproximadamente 40 segundos, seguido da caixa de diálogo de ligação.

Preenchimento automático de detalhes de conexão

A caixa de diálogo de ligação na extensão PostgreSQL abre-se, e o campo Nome do Servidor preenche automaticamente o endpoint do seu servidor.

Captura de ecrã da extensão PostgreSQL para o Visual Studio 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 da ligação, como Nome do Perfil, Nome da Base de Dados (opcional), Grupo de Servidores e Número de 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.

Troubleshoot

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

  • Verifica se o Visual Studio Code e a extensão PostgreSQL estão instalados e ativados.

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

  • Se não cumprires os pré-requisitos, o painel lateral fornece feedback e passos para resolver o problema, incluindo tentar novamente a ligação.

Comentários e suporte

Para bugs, solicitações de recursos e problemas, use a ferramenta de comentários interna no Visual Studio Code. Pode completar este processo de feedback através do menu de Ajuda do Visual Studio 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

  • Last updated on