Configurando Spring Boot com PostgreSQL no ambiente Linux: Passo a passo

Jéssica Zucco — Wed, 10 Jul 2024 13:43:28 +0000

Neste guia, vamos juntos desbravar o processo de configurar e conectar uma aplicação Spring Boot ao PostgreSQL no Linux. O que temos pela frente:

Instalar o PostgreSQL no Linux Mint (Ubuntu)
Criar um novo usuário e senha no PostgreSQL
Criar uma base de dados
Dar acesso à base para o usuário criado
Fazer a mágica acontecer: configurar o Spring Boot para se comunicar com nossa base

1. Instalando o PostgreSQL no Linux Mint (Ubuntu)

Abra o terminal e execute os seguintes comandos:

a) Atualize a lista de pacotes:

sudo apt update

b) Instale o PostgreSQL com o pacote contrib:

sudo apt install postgresql postgresql-contrib

c) Instale o cliente PostgreSQL:

sudo apt-get install postgresql-client

2. Criar um novo usuário e senha no PostgreSQL

a) Acesse a conta postgres no terminal:

sudo -i -u postgres

b) Entre no prompt do PostgreSQL:

psql

c) No prompt do PostgreSQL, crie o novo usuário:

CREATE USER ‘nome-usuario’ WITH ENCRYPTED PASSWORD 'suasenha';

Atenção:

Anote o nome de usuário e senha, você precisará deles para configurar o Spring Boot depois
Substitua 'nome_usuario' pelo nome desejado para o seu usuário
Troque 'sua_senha' por uma senha forte de sua escolha

Dicas:

Para sair do prompt PostgreSQL, digite: \q
Para sair da conta postgres, digite: exit

3. Criando uma base de dados

a) Acesse o prompt do PostgreSQL (veja o item 2 para instruções de acesso)

b) No prompt, crie a nova base de dados:

CREATE DATABASE nome-base-de-dados;

Importante:
• Substitua 'nome-base-de-dados' pelo nome que você deseja dar à sua base

Dica:
• Para verificar se a base foi criada, use o comando: \l

4. Concedendo acesso à base de dados para o usuário criado

a) No prompt do PostgreSQL (veja o item 2 para instruções de acesso), execute:

GRANT ALL PRIVILEGES ON DATABASE nome_base_de_dados TO nome_usuario;

Importante:

Substitua 'nome_base_de_dados' pelo nome da base que você criou no passo 3
Substitua 'nome_usuario' pelo nome do usuário que você criou no passo 2

5. Configurando o Spring Boot para se comunicar com nossa base de dados

a) Inicialize uma aplicação Spring Boot:

Acesse https://start.spring.io/
O site já traz como padrão projeto Maven e linguagem Java
Ajuste os metadados do projeto conforme necessário (ou deixe como está, caso esteja apenas testando)

b) Adicione as seguintes dependências:

Spring Web
Spring Data JPA
PostgreSQL Driver
Validation

Para adicionar: Clique em "ADD" na seção de dependências e use a barra de busca

c) Gere e baixe o projeto:

Clique no botão "GENERATE"
Baixe e descompacte o arquivo ZIP gerado

d) Abra o projeto na sua IDE:

Importe o arquivo pom.xml como um projeto (ex: no IntelliJ IDEA)

e) Na estrutura do projeto, localize o arquivo application.properties:

Geralmente em src/main/resources/

f) Configure a conexão com o banco de dados:

Abra application.properties e adicione:

spring.datasource.url=jdbc:postgresql://localhost:5432/nome-bando-de-dados
spring.datasource.username=nome-de-usuário-criado-no-passo-2
spring.datasource.password=senha-criada-no-passo-2
spring.jpa.hibernate.ddl-auto=update

spring.jpa.properties.hibernate.jdbc.lob.non_contextual_creation=true

Após configurar o application.properties, o próximo passo é garantir que o PostgreSQL esteja rodando e pronto para aceitar conexões. Para isso, abra o terminal e execute o comando:

sudo systemctl start postgresql.service

Pronto! Só rodar o projeto na sua IDE e a conexão deve acontecer.

Dica de diagnóstico:

Se encontrar problemas de conexão, verifique: