Compartilhar via

Início Rápido: Conectar e consultar um banco de dados com a extensão PostgreSQL para 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.

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á para 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.

Quando a extensão é 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.

Authentication

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 caixa de diálogo de conexão da extensão PostgreSQL para Visual Studio 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 e aparece automaticamente 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 para ver as opções para:
    • Iniciar uma nova consulta
    • Converse 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.
  • Use realce de sintaxe e formatação automática para 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 ajuda você a simplificar seu fluxo de trabalho, reduzir o tempo de desenvolvimento e obter insights mais profundos sobre suas operações de banco de dados. Esta seção orienta você pelas etapas para ativar e usar o Copilot dentro da 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 selecione Chat com este banco de dados para interagir com Copilot.

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

@pgsql tell me about the tables in the HR schema

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

Conectar-se ao Banco de Dados do Azure para PostgreSQL com o Visual Studio Code

Conecte-se a uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL usando o Visual Studio Code seguindo 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 ao Visual Studio Code

A opção "Conectar com o Visual Studio Code" no portal do Azure simplifica a conexão com a sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL. 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 o Visual Studio Code proeminente na página Visão Geral .
  • Um painel lateral é exibido que lista os requisitos para se conectar usando o Visual Studio Code.

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 Visual Studio Code.

Confirmar requisitos

  • No painel lateral, confirme se todos os pré-requisitos (extensão Do Visual Studio Code e PostgreSQL) estão satisfeitos selecionando 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 tela do portal do Azure mostrando uma instância do Banco de Dados do Azure para PostgreSQL com o painel Conectar com o Visual Studio 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.
  • Se o Visual Studio Code e a extensão levarem mais de 40 segundos para serem abertos, um botão Tentar Novamente no Visual Studio Code será exibido no painel lateral.

Iniciar o Visual Studio Code

  • Se o Visual Studio Code estiver instalado e em execução, a caixa de diálogo de conexão da extensão PostgreSQL será iniciada automaticamente.
  • Se o Visual Studio 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 é automaticamente preenchido com o ponto de extremidade do seu servidor.

Captura de tela da extensão PostgreSQL para a Caixa de Diálogo de Conexão do Visual Studio Code com os detalhes do nome do servidor pré-preenchidos.

Fornecer 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.

Troubleshoot

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

  • Verifique se o Visual Studio 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 você não atender aos pré-requisitos, 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 esse processo de 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