PostgreSQL: Como Instalar o PostgreSQL e Fazer Sua Primeira…

# Baixa e executa o PostgreSQL 17 no Docker
docker run --name my-postgres \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=bob \
  -e POSTGRES_DB=dev_shop \
  -p 5432:5432 \
  -d postgres:17

# Verifica se o contêiner está em execução
docker ps | grep my-postgres

# Passo 1: Baixa a imagem PostgreSQL 17
docker pull postgres:17

# Passo 2: Executa o contêiner com configurações personalizadas
docker run --name pg-dev \
  -e POSTGRES_USER=devuser \
  -e POSTGRES_PASSWORD=devpass123 \
  -e POSTGRES_DB=shopdb \
  -p 5432:5432 \
  -v pgdata:/var/lib/postgresql/data \
  -d postgres:17

# Passo 3: Verifica se o contêiner está em execução
docker ps

# Passo 4: Conecta via psql dentro do contêiner
docker exec -it pg-dev psql -U devuser -d shopdb

psql (17.0)
Type "help" for help.

shopdb=>

1. Baixe o instalador de https://www.enterprisedb.com/downloads/postgres
2. Execute postgresql-17-windows-x64.exe
3. Selecione o diretório de instalação (padrão: C:\Program Files\PostgreSQL\17)
4. Defina a senha do superusuário (postgres)
5. Defina a porta (padrão: 5432)
6. Selecione a localidade (padrão: [Default locale])
7. Marque "Launch Stack Builder at exit" (opcional, para ferramentas adicionais)
8. Clique em Finish

# Instala o PostgreSQL 17 via Homebrew
brew install postgresql@17

# Inicia o serviço PostgreSQL
brew services start postgresql@17

# Conecta ao banco de dados padrão
psql postgres

# Verifica a versão
SELECT version();

# Comando psql executado com sucesso

# Adiciona o repositório APT oficial do PostgreSQL
sudo apt update
sudo apt install -y curl ca-certificates
sudo install -d /usr/share/postgresql-common/pgdg
sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc \
  --fail https://www.postgresql.org/media/keys/ACCC4CF8.asc

sudo sh -c 'echo "deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] \
  https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" \
  > /etc/apt/sources.list.d/pgdg.list'

# Instala o PostgreSQL 17
sudo apt update
sudo apt install -y postgresql-17

# Muda para o usuário postgres e conecta
sudo -u postgres psql

# Verifica a instalação
SELECT version();

# Comando psql executado com sucesso

1. Baixe de https://www.pgadmin.org/download/
2. Instale e inicie o pgAdmin 4
3. Clique em "Add New Server"
4. Aba General: Name = "Local Dev"
5. Aba Connection:
   - Host: localhost (ou 127.0.0.1)
   - Port: 5432
   - Maintenance database: shopdb
   - Username: devuser
   - Password: devpass123
6. Clique em Save

1. Baixe de https://dbeaver.io/download/ (Community Edition)
2. Instale e inicie o DBeaver
3. Clique em "New Database Connection" (ícone de plugue)
4. Selecione PostgreSQL
5. Preencha as configurações de conexão:
   - Host: localhost
   - Port: 5432
   - Database: shopdb
   - Username: devuser
   - Password: devpass123
6. Clique em "Test Connection" (solicita o download do driver JDBC PG)
7. Clique em Finish

# Conecta ao PostgreSQL local
psql -h localhost -p 5432 -U devuser -d shopdb

# Ou use uma URI de conexão
psql "postgresql://devuser:devpass123@localhost:5432/shopdb"

# Ou via Docker
docker exec -it pg-dev psql -U devuser -d shopdb

CONTAINER ID   IMAGE     STATUS    
abc123         latest    Up 2 hours

-- Verifica informações da conexão
\conninfo

-- Lista bancos de dados
\l

-- Cria uma tabela de teste
CREATE TABLE test_greeting (
    id SERIAL PRIMARY KEY,
    message TEXT NOT NULL,
    created_at TIMESTAMP DEFAULT NOW()
);

-- Insere dados
INSERT INTO test_greeting (message) VALUES ('Hello, PostgreSQL!');

-- Consulta dados
SELECT * FROM test_greeting;

-- Remove tabela de teste
DROP TABLE test_greeting;

-- Saída \conninfo:
You are connected to database "shopdb" as user "devuser" on host "localhost" at port "5432".

-- Saída SELECT:
 id |      message       |         created_at
----+--------------------+----------------------------
  1 | Hello, PostgreSQL! | 2026-07-13 10:30:00.123456

# ============================================
# Fluxo de trabalho completo: instalar, conectar, verificar
# Do zero à execução em 5 comandos
# ============================================

# 1. Inicia o PostgreSQL via Docker
docker run --name pg-dev \
  -e POSTGRES_USER=devuser \
  -e POSTGRES_PASSWORD=devpass123 \
  -e POSTGRES_DB=shopdb \
  -p 5432:5432 \
  -d postgres:17

# 2. Aguarda o contêiner ficar pronto (cerca de 5 segundos)
sleep 5

# 3. Conecta via psql
docker exec -it pg-dev psql -U devuser -d shopdb

# 4. Dentro do psql: executa consultas de verificação
# (Digite estes comandos no prompt do psql)

-- Mostra a versão do PostgreSQL
SELECT version();

-- Mostra a conexão atual
\conninfo

-- Lista extensões disponíveis
SELECT name, default_version FROM pg_available_extensions LIMIT 5;

-- Cria uma tabela de teste e insere dados
CREATE TABLE hello_pg (
    id SERIAL PRIMARY KEY,
    greeting TEXT,
    created_at TIMESTAMPTZ DEFAULT NOW()
);

INSERT INTO hello_pg (greeting) VALUES
    ('Hello from PostgreSQL!'),
    ('Docker install works!'),
    ('Ready to learn!');

-- Verifica
SELECT * FROM hello_pg;

-- Limpeza
DROP TABLE hello_pg;

-- Sai do psql
\q

# 5. Para o contêiner quando terminar
docker stop pg-dev

                                                     version
-----------------------------------------------------------------------------------------------------------------
 PostgreSQL 17.0 on x86_64-pc-linux-gnu, compiled by gcc (Debian 12.2.0-14) 12.2.0, 64-bit

     name      | default_version
---------------+-----------------
 plpgsql       | 1.0
 uuid-ossp     | 1.1
 pg_trgm       | 1.6

 id |       greeting        |          created_at
----+-----------------------+-------------------------------
  1 | Hello from PostgreSQL! | 2026-07-13 10:30:00+00
  2 | Docker install works!  | 2026-07-13 10:30:00+00
  3 | Ready to learn!        | 2026-07-13 10:30:00+00