DEV Community

Cover image for Configurando o Postgres e DBeaver no macOS através do Homebrew
Jonathas Rocha
Jonathas Rocha

Posted on

Configurando o Postgres e DBeaver no macOS através do Homebrew

#tutorial #postgres #macos #homebrew

Subir o PostgreSQL no macOS não é nadinha complicado. Com os passos certos, em minutos você terá o banco rodando e pronto para ser usado no DBeaver.

1. Verificando se o Postgres já está instalado

Primeiro, confirme se o cliente do PostgreSQL (psql) já existe:

psql --version
Enter fullscreen mode Exit fullscreen mode

Se aparecer algo como psql (PostgreSQL) 14.12 (Homebrew), significa que o Postgres está instalado.

Caso não esteja, você pode instalar via Homebrew:

brew install postgresql@14
Enter fullscreen mode Exit fullscreen mode

2. Iniciando o servidor do PostgreSQL

Para iniciar o Postgres como serviço no macOS:

brew services start postgresql@14
Enter fullscreen mode Exit fullscreen mode

Se quiser rodar apenas no terminal, sem manter em background:

pg_ctl -D /opt/homebrew/var/postgresql@14 start
Enter fullscreen mode Exit fullscreen mode

Verifique se o servidor está ativo:

brew services list | grep postgres
Enter fullscreen mode Exit fullscreen mode

3. Lidando com erros comuns

Ao tentar conectar, talvez você encontre mensagens como:

Role inexistente:

FATAL: role "postgres" does not exist
Enter fullscreen mode Exit fullscreen mode

Database inexistente:

FATAL: database "seu_usuario" does not exist
Enter fullscreen mode Exit fullscreen mode

Isso significa que o cluster do Postgres foi iniciado sem as roles ou bancos padrões.

4. Inicializando o cluster manualmente

Se necessário, inicialize o cluster para garantir a estrutura básica:

initdb --locale=C -D /opt/homebrew/var/postgresql@14
Enter fullscreen mode Exit fullscreen mode

E inicie novamente o servidor:

pg_ctl -D /opt/homebrew/var/postgresql@14 start
Enter fullscreen mode Exit fullscreen mode

5. Criando a role e o banco 

postgres

Agora conecte-se ao servidor:

psql -d postgres
Enter fullscreen mode Exit fullscreen mode

Dentro do console do psql, crie a role e o banco de forma explícita:

CREATE ROLE postgres WITH LOGIN SUPERUSER PASSWORD 'sua_senha_aqui';
CREATE DATABASE postgres OWNER postgres;
Enter fullscreen mode Exit fullscreen mode

Depois disso, você já consegue acessar normalmente:

psql -U postgres -h localhost
Enter fullscreen mode Exit fullscreen mode

6. Conectando via DBeaver

Com o Postgres rodando e configurado, basta abrir o DBeaver e criar uma nova conexão:

  • Host: localhost
  • Porta: 5432
  • Database: postgres
  • Usuário: postgres
  • Senha: a que você definiu no passo anterior

Teste a conexão e pronto: o DBeaver estará conectado ao seu banco local.

Conclusão

Esse passo a passo é simples, mas cobre os erros mais comuns ao configurar o PostgreSQL no macOS via Homebrew.

Top comments (0)