Início Rápido: Conectar e consultar o PostgreSQL

Neste início rápido, você usa a extensão PostgreSQL para Visual Studio Code para se conectar a um servidor PostgreSQL, criar uma tabela, inserir linhas e executar uma consulta, tudo de dentro do VS Code.

O que você aprenderá

  • Abra a caixa de diálogo de conexão e conecte-se a um servidor PostgreSQL
  • Criar um banco de dados e uma tabela com o editor de consultas
  • Inserir e consultar dados
  • Exibir resultados no painel Resultados

Pré-requisitos

Antes de começar, certifique-se de que você tenha o seguinte:

Conectar-se a um servidor

  1. Abra o modo de exibição PostgreSQL pressionando Ctrl+Alt+D (Windows/Linux) ou Cmd+Alt+D (macOS) ou selecione o ícone PostgreSQL na Barra de Atividades.

  2. Passe o mouse sobre o cabeçalho da seção Conexões e selecione Adicionar Nova Conexão (o + ícone). A caixa de diálogo de conexão é aberta com a guia Parâmetros selecionada.

    Captura de tela da caixa de diálogo de conexão com a guia Parâmetros visível.

  3. Preencha os campos de conexão do servidor PostgreSQL:

    Campo Valor de exemplo Descrição
    Nome do servidor localhost O nome do host ou o endereço IP do servidor.
    Tipo de Autenticação Senha Escolha Password, Entra Auth, AWS IAM (RDS/Aurora) ou None.
    Nome de usuário postgres Seu logon do PostgreSQL.
    Senha (sua senha) A palavra-passe da conta.
    Nome do banco de dados postgres O banco de dados ao qual se conectar.
    Nome da conexão Local dev server Um nome de exibição opcional para essa conexão.

    Dica

    Selecione Salvar Senha para armazenar a senha com segurança no repositório de credenciais do VS Code para que você não seja solicitado em todas as conexões. Para autenticação do Microsoft Entra ID, autenticação do AWS IAM ou outra configuração de identidade, consulte Conexões e identidade.

  4. Selecione Salvar &conectar.

    O servidor aparece na árvore Conexões com um indicador de status verde quando a conexão é bem-sucedida.

Criar um banco de dados

  1. Clique com o botão direito do mouse no nó do servidor na árvore Conexões e selecione Nova Consulta. Um editor de consultas é aberto que está conectado ao servidor.

  2. Cole a seguinte instrução e pressione Ctrl+Shift+E (Windows/Linux) ou Cmd+Shift+E (macOS) para executá-la:

    CREATE DATABASE tutorialdb;

  3. Clique com o botão direito do mouse no nó do servidor na árvore Conexões e selecione Atualizar para ver o novo banco de dados tutorialdb na árvore.

Criar uma tabela

  1. Altere o contexto do banco de dados para o tutorialdb. Use a lista suspensa do banco de dados na barra de ferramentas do editor de consultas, ou execute pgsql.changeDatabase na Paleta de Comandos (Alterar Banco de Dados PostgreSQL) e selecione tutorialdb.

  2. Cole a seguinte instrução no editor de consultas e execute-a com Ctrl+Shift+E / Cmd+Shift+E:

    CREATE TABLE customers (
    id SERIAL PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    email VARCHAR(50) NOT NULL,
    city VARCHAR(50)
);

    O painel Mensagens confirma que a instrução foi concluída com êxito.

Inserir dados

Substitua o conteúdo do editor de consultas pela seguinte instrução e execute-o:

INSERT INTO customers (name, email, city)
VALUES
    ('Alice Johnson', 'alice@example.com', 'Seattle'),
    ('Bob Smith', 'bob@example.com', 'Portland'),
    ('Carol Williams', 'carol@example.com', 'San Francisco');

O painel Mensagens confirma que três linhas foram inseridas.

Consultar os dados

Substitua o conteúdo do editor de consultas pela seguinte instrução e execute-o:

SELECT * FROM customers;

O painel Resultados exibe as três linhas que você inseriu.

Verifique o resultado

Para confirmar se os dados são persistentes, execute uma consulta filtrada:

SELECT name, city
FROM customers
WHERE city = 'Seattle';

O painel Resultados retorna uma linha para Alice Johnson em Seattle.

Solucionar problemas de conexão

Se você não conseguir se conectar ao servidor, verifique as seguintes causas comuns:

  • Conexão recusada: Verifique se o PostgreSQL está em execução e escutando no host e na porta esperados. Para servidores locais, confirme se o serviço foi iniciado.
  • Falha na autenticação de senha: verifique novamente os valores de nome de usuário e senha . Examine o arquivo do pg_hba.conf servidor para confirmar se o método de autenticação permite sua conexão.
  • Erros de SSL: defina as configurações de SSL nas opções de conexão avançadas. Para obter detalhes, consulte Conexões e identidade: SSL e TLS.

Conteúdo relacionado

  • Last updated on