Como Instalar e Configurar o PostgreSQL no Ubuntu: Guia Completo para Iniciantes

1. Introdução

PostgreSQL é um sistema de banco de dados relacional altamente confiável e de alto desempenho, amplamente usado em muitas aplicações e sistemas em ambientes Ubuntu. Este artigo explica como instalar o PostgreSQL no Ubuntu e realizar configurações básicas. Cada passo é explicado claramente para iniciantes, incluindo verificações de instalação e solução de problemas de conectividade, para que você possa configurar seu ambiente com confiança.

2. Pré-requisitos e Preparação

Primeiro, certifique-se de que sua versão do Ubuntu seja 20.04 ou 22.04. Antes de instalar o PostgreSQL, atualize a lista de pacotes para obter as informações mais recentes.

sudo apt update

Isto garante que o processo de instalação prossiga sem problemas.

3. Etapas de Instalação do PostgreSQL

3.1 Adicionar o Repositório PostgreSQL

O repositório padrão do Ubuntu pode não incluir a versão mais recente do PostgreSQL. Adicione o repositório oficial do PostgreSQL para instalar a versão mais atual.

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
sudo wget -qO- https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo tee /etc/apt/trusted.gpg.d/pgdg.asc

3.2 Instalar o PostgreSQL

Depois que o repositório for adicionado, instale o PostgreSQL e ferramentas adicionais com os seguintes comandos:

sudo apt update
sudo apt install postgresql postgresql-contrib

3.3 Verificar a Instalação

Após a instalação, verifique se o PostgreSQL foi instalado corretamente verificando sua versão.

postgres --version

4. Configuração Inicial

4.1 Configurar o Usuário PostgreSQL

Durante a instalação, um usuário do sistema chamado “postgres” é criado. Troque para esse usuário para executar operações no banco de dados.

sudo -i -u postgres

4.2 Editar Configurações de Conexão Local

Edite o arquivo pg_hba.conf para definir os métodos de autenticação. Por padrão, apenas conexões locais são permitidas. Para habilitar acesso remoto, modifique o seguinte arquivo:

sudo nano /etc/postgresql/14/main/pg_hba.conf

Por exemplo, você pode aplicar a autenticação “md5” para melhorar a segurança:

local   all             postgres                                md5
host    all             all             127.0.0.1/32            md5

Após a edição, reinicie o serviço PostgreSQL para aplicar as alterações.

sudo systemctl restart postgresql

5. Verificações de Operação Básicas

5.1 Iniciar e Parar o PostgreSQL

O PostgreSQL inicia automaticamente após a instalação, mas você pode iniciar, parar e verificar seu status manualmente usando os seguintes comandos:

sudo systemctl status postgresql
sudo systemctl start postgresql
sudo systemctl stop postgresql

5.2 Verificar Bancos de Dados

Use o comando psql para conectar ao PostgreSQL e visualizar os bancos de dados existentes.

sudo -u postgres psql

No prompt de comando, digite \l para listar os bancos de dados atuais.

6. Instalar e Configurar o pgAdmin (Opcional)

O pgAdmin é uma ferramenta GUI que simplifica a administração do PostgreSQL. Instale-o com o seguinte comando e gerencie o PostgreSQL através do seu navegador:

sudo apt install pgadmin4

Após a instalação, acesse a interface via http://localhost/pgadmin.

7. Solução de Problemas de Erros Comuns

7.1 Erros de Instalação e Repositório

Se você encontrar erros de dependência ou de repositório durante a instalação, verifique a URL do repositório e atualize a lista de pacotes novamente.

sudo apt update

7.2 Erros de Conexão

Se você receber erros como “Falha na autenticação por senha”, verifique seu arquivo pg_hba.conf, confirme sua senha e reinicie o serviço.

sudo systemctl restart postgresql

7.3 Resolução de Erros de Rede

Se as conexões remotas falharem, o arquivo postgresql.conf pode ter listen_addresses definido como “localhost”. Modifique-o da seguinte forma para permitir conexões remotas:

sudo nano /etc/postgresql/14/main/postgresql.conf

Altere a configuração conforme mostrado abaixo:

listen_addresses = '*'

Reinicie o serviço para aplicar as alterações.

sudo systemctl restart postgresql

8. Conclusão

Este guia explicou como instalar o PostgreSQL no Ubuntu, configurá-lo e realizar verificações básicas de operação. Com o pgAdmin, configurações de acesso remoto e dicas de solução de problemas incluídas, mesmo usuários iniciantes devem ser capazes de configurar o ambiente sem dificuldades.

侍エンジニア塾