Compartilhar via

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 simplificar o desenvolvimento e o gerenciamento de bancos de dados PostgreSQL. Este guia explica como se conectar a um banco de dados PostgreSQL e executar 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 do PostgreSQL

Para instalar a extensão PostgreSQL:

  1. Abra o Visual Studio Code 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 postgreSQL no Marketplace de Extensões.
  3. Selecione a extensão PostgreSQL criada pela Microsoft e selecione Instalar.

Depois de 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 para gerenciar e interagir com seus dados. Esse processo envolve fornecer os 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 banco de dados e usar ferramentas poderosas para consultar, gerenciar e explorar seus dados com eficiência.

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

  2. Selecione o botão Adicionar Conexão .

  3. Insira os detalhes da conexão manualmente ou use o formato de cadeia de conexã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. Filtrar por assinatura, grupo de recursos, servidor e nome do banco de dados.

Autenticação

A extensão dá suporte a 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 da ID do Microsoft Entra: adicione sua conta da ID do Microsoft Entra para bancos de dados hospedados no Azure.

Captura de tela da extensão PostgreSQL para a caixa de diálogo de conexão do 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 ser 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.

Pesquisar os 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 – Conversar com esse banco de dados (inicia a experiência de chat pgsql) – Conectar-se ao PSQL para iniciar uma conexão de terminal psql
  • Clique com o botão direito do mouse em uma tabela e selecione "Selecionar Top 1000" para exibir 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 elaborar e executar consultas SQL:

  • Aproveite o IntelliSense com reconhecimento de contexto para preenchimento automático de palavras-chave e nomes de objeto do SQL.
  • Realce de sintaxe e formatação automática garantem melhor legibilidade e precisão.
  • Acesse consultas executadas anteriormente por meio do painel Histórico de Consultas.

Examinar os resultados da consulta

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

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

Usar o GitHub Copilot para obter assistência avançada

A integração do GitHub Copilot aprimora sua experiência de desenvolvimento com o PostgreSQL ao fornecer sugestões de código alimentadas por inteligência artificial, dicas de otimização de consultas e assistência interativa em bancos de dados. Esse recurso permite que você simplifique seu fluxo de trabalho, reduza o tempo de desenvolvimento e obtenha informações mais profundas sobre suas operações de banco de dados. Esta seção orienta você pelas etapas para ativar e utilizar o Copilot na extensão PostgreSQL para Visual Studio Code.

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

Entre em sua conta do GitHub e habilite o agente de Chat do @pgsql Copilot nas configurações de extensão.

Prompts de banco de dados interativos

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

Escreva prompts como o exemplo abaixo para receber insights e sugestões detalhados.

@pgsql tell me about the tables in the HR schema

Para saber mais, visite Configurar o GitHub Copilot

Conectar-se a uma instância do Servidor Flexível do Banco de Dados do Azure para PostgreSQL com o VS Code no 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.

Conectar-se com o VS Code

A opção "Conectar com o Visual Studio Code" no portal do Azure simplifica a conexão com o Azure Database for PostgreSQL Flexible Server. Esse recurso simplifica a configuração orientando você pelos 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 Conectar com VS Code proeminente na página Visão Geral.
  • Um painel lateral listando os requisitos para se conectar usando o VS Code é exibido.

Captura de tela do portal do Azure mostrando uma instância do Banco de Dados do Azure para PostgreSQL com o botão Conectar com o VS Code.

Confirmar requisitos

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

  • 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 tela do portal do Azure mostrando uma instância do Banco de Dados do Azure para PostgreSQL com o painel Conectar com o VS Code. O botão abrir no Visual Studio Code está realçado.

Abrir no Visual Studio Code

  • Selecione o botão Abrir no Visual Studio Code no painel lateral.
  • Um botão "Abrir novamente no Visual Studio Code" aparece no painel lateral caso o Visual Studio Code e a extensão estejam levando mais de 40 segundos para serem abertas.

Iniciar 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 estiver aberto, ele será iniciado em aproximadamente 40 segundos, seguido pela caixa de diálogo de conexão.

Detalhes da conexão de preenchimento automático

A caixa de diálogo de conexão na extensão PostgreSQL é aberta e o campo Nome do Servidor preenche automaticamente o ponto de extremidade do servidor.

Captura de tela da extensão do PostgreSQL para o diálogo de conexão no VS Code com os detalhes do nome do servidor preenchidos.

Forneça detalhes de autenticação

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

  • Autenticação de Senha: insira seu nome de usuário e senha manualmente.
  • Autenticação do Entra: insira suas credenciais de 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.

Salvar e conectar

Selecione o botão Salvar & Conectar para estabelecer a conexão. Uma vez conectado, expanda o servidor na árvore 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 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 a repetição da conexão.

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 isso por meio do menu ajuda do VS 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