Neste artigo
- O que você precisa antes de começar
- Preparando o banco e a tabela de exemplo
- Create: inserindo dados com INSERT
- Read: consultando dados com SELECT de forma eficiente
- Update e Delete: alterando e excluindo sem afetar outras linhas
- Transações e concorrência: garantindo ACID no CRUD
- Integrando o CRUD com frameworks web (Node.js, Python e PHP)
- Erros comuns, boas práticas e próximos passos
- Como inserir dados em uma tabela do PostgreSQL com INSERT?
- Como recuperar todas as linhas de uma tabela de forma eficiente?
- Como fazer update em uma linha específica sem afetar outras?
- Como excluir um registro de uma tabela usando DELETE?
- Como garantir transações ACID nas operações CRUD?
- Como usar consultas parametrizadas para prevenir injeção SQL?
Aqui você vai montar um CRUD completo no PostgreSQL usando SQL puro: definir o schema, inserir, consultar, atualizar e excluir dados, com transações e consultas parametrizadas. CRUD com PostgreSQL é a combinação Create, Read, Update, Delete (as quatro operações básicas de qualquer aplicação) executadas sobre o banco relacional, e dominá-la em SQL puro antes de partir para ORM é o que separa quem decorou framework de quem entende o que o framework faz por baixo.
Toda API de cadastro, carrinho de e-commerce ou sistema de tickets é um CRUD com validação em cima. Quando o ORM gera uma query estranha e a produção fica lenta, quem sabe SQL puro resolve em minutos.
| Aspecto | Detalhe |
|---|---|
| Nível | Iniciante em backend, SQL básico |
| Banco | PostgreSQL, cliente psql |
| Tempo estimado | 30 a 45 minutos para completar o guia |
| Custo | R$ 0: PostgreSQL é open source |
| Resultado | CRUD funcional em SQL puro + integração com Node.js, Python e PHP |
O que você precisa antes de começar
Você precisa do PostgreSQL instalado (versão 13 ou mais recente resolve), do cliente psql que acompanha a instalação e de um driver na linguagem que vai usar: node-postgres para Node.js, psycopg para Python ou PDO para PHP.
No Linux, o apt já traz o pacote; no Windows e macOS, o instalador oficial do PostgreSQL inclui o psql. Se ainda não tem SQL na base, vale folgar uma tarde no curso gratuito de análise de dados com dashboards no Looker Studio do SENAI antes de seguir, mas o guia é autossuficiente para quem já escreveu um SELECT na vida.
Preparando o banco e a tabela de exemplo
Crie um banco dedicado e entre nele. O resultado esperado é o prompt psql apontando para o banco crud_demo.
CREATE DATABASE crud_demo;
\c crud_demoAgora o schema. A definição de esquemas de tabelas no PostgreSQL usa CREATE TABLE com tipos explícitos e chave primária. Vamos usar uma tabela de produtos, o exemplo clássico que aparece em qualquer CRUD:
Cursos google ciee gratuitos certificado
CREATE TABLE produtos (
id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
nome TEXT NOT NULL,
preco NUMERIC(10,2) NOT NULL CHECK (preco >= 0),
criado_em TIMESTAMPTZ NOT NULL DEFAULT now()
);GENERATED ALWAYS AS IDENTITY é o substituto moderno de SERIAL: o banco gera o id sozinho e, diferente do SERIAL, bloqueia que alguém insira o id manualmente por engano. NUMERIC(10,2) evita erro de arredondamento de float em valores monetários.
Create: inserindo dados com INSERT
Para inserir uma linha, liste as colunas e os valores. O RETURNING id devolve a chave gerada sem precisar de uma segunda query, o que é essencial em fluxos de cadastro:
INSERT INTO produtos (nome, preco)
VALUES ('Teclado mecânico', 349.90)
RETURNING id;Para inserir múltiplas linhas, use uma única instrução com várias tuplas de VALUES. É mais rápido do que N inserts separados porque o banco faz um único round trip:
INSERT INTO produtos (nome, preco) VALUES
('Mouse sem fio', 149.50),
('Monitor 24 polegadas', 899.00),
('Headset USB', 279.90);Em código de aplicação, nunca concatene strings para montar o INSERT. Consultas parametrizadas são o padrão no PostgreSQL porque separam o SQL dos dados e eliminam a injeção SQL. Mostro os exemplos na seção de frameworks.
Read: consultando dados com SELECT de forma eficiente
Resposta rapida: SELECT * FROM produtos; recupera todas as linhas, mas em produção prefira filtrar por id, limitar colunas e paginar com LIMIT e OFFSET.
Databricks cursos gratuitos português
-- uma linha pela chave primária
SELECT id, nome, preco FROM produtos WHERE id = 1;
-- paginação, página 2 com 20 registros
SELECT id, nome, preco FROM produtos
ORDER BY id
LIMIT 20 OFFSET 20;O SELECT * em produção é anti-pattern: traz colunas que você não usa, quebra código quando alguém muda a tabela e impede o banco de usar índices que cobrem só as colunas pedidas. Listar as colunas custa dez segundos de digitação e economiza horas de debug.
Update e Delete: alterando e excluindo sem afetar outras linhas
A regra é uma só: UPDATE e DELETE sempre com WHERE pela chave primária. Sem o WHERE, a operação atinge todas as linhas da tabela, e esse é um dos acidentes mais caros que existem em banco de dados.
UPDATE produtos
SET preco = 329.90
WHERE id = 1;
DELETE FROM produtos
WHERE id = 3;Ambos devolvem quantas linhas foram afetadas. Sua aplicação deve validar esse número: se o update de um único id retorna 0 linhas, o registro não existe ou o id veio errado, e o usuário precisa saber disso. Um truque que eu recomendo de olhos fechados: rode o UPDATE como SELECT primeiro e confira as linhas que ele vai atingir antes de trocar o comando.
Atenção:em alguns clientes de terminal, o comando roda sem confirmação. Num ambiente compartilhado, comece a transação com BEGIN antes do UPDATE ou DELETE: se o número de linhas afetadas vier estranho, um ROLLBACK desfaz tudo.
Transações e concorrência: garantindo ACID no CRUD
Transações garantem que um grupo de operações aconteça tudo ou nada. Se uma falhar no meio, o ROLLBACK volta o banco ao estado anterior, e é isso que sustenta o ACID no CRUD:
Curso gratuito Microsoft analise de dados Power BI certificado
BEGIN;
UPDATE produtos SET preco = 299.00 WHERE id = 1;
INSERT INTO produtos (nome, preco) VALUES ('Produto promoção', 299.00);
COMMIT;Se o INSERT falhar (digamos, violando a constraint de preço negativo), o update também é desfeito. Agrupe operações relacionadas na mesma transação: criar pedido e debitar estoque em transações separadas deixa o banco num estado inválido quando uma das duas falha.
Sobre concorrência: quando duas conexões fazem update na mesma linha, o PostgreSQL não trava a leitura. A segunda escrita espera a primeira commitar ou fazer rollback, e só então aplica sobre a versão mais recente. Para a maioria dos CRUDs, o comportamento padrão é suficiente; bloqueio explícito com SELECT FOR UPDATE entra em cena em fluxos como saldo bancário.
Transação não é acessório de banco, é a diferença entre um bug que conserta dados e um bug que fica registrado para sempre.
Integrando o CRUD com frameworks web (Node.js, Python e PHP)
Prepared statements existem para prevenir injeção SQL: o driver envia o SQL com placeholders e os dados separados, então nada que o usuário digitar vira código. Exemplo mínimo em Node.js com o node-postgres (Exemplo, não validado em produção neste formato):
const { Pool } = require('pg');
const pool = new Pool();
await pool.query(
'SELECT id, nome FROM produtos WHERE preco < $1',
[500]
);O $1 é o placeholder do node-postgres e o array seguinte carrega os valores. Em Python com psycopg, a sintaxe usa %s:
Curso gratuito Power BI analise de dados Bradesco
cur.execute(
"INSERT INTO produtos (nome, preco) VALUES (%s, %s)",
(nome, preco)
)Em PHP, o PDO usa :nome como placeholder:
$stmt = $pdo->prepare(
'UPDATE produtos SET preco = :preco WHERE id = :id'
);
$stmt->execute(['preco' => 299.00, 'id' => 1]);Os três drivers separam SQL de dados do mesmo jeito, então o padrão aprendido aqui transita entre linguagens. ORM como Prisma, SQLAlchemy ou Eloquent é bem-vindo depois, mas o SQL puro continua sendo o idioma comum por baixo de todos.
Erros comuns, boas práticas e próximos passos
Os três erros que mais aparecem em código real: UPDATE ou DELETE sem WHERE, concatenação de strings para montar SQL e operações relacionadas rodando fora de transação. Todos os três viram incidente de produção, não só bug de dev.
WHERE obrigatório: em UPDATE e DELETE, sempre pela chave primária; valide linhas afetadas na aplicação.
Parametrizar sempre: nunca concatene input do usuário no SQL, nem "só essa vez".
Transação por bloco lógico: operações que precisam acontecer juntas ficam juntas.
SELECT com colunas nomeadas: reserva o * para debug ad hoc.
Dica:o psql tem atalhos que economizam tempo no dia a dia: \dt lista tabelas, \d produtos descreve o schema completo e \x alterna exibição expandida, ótima para linhas com muitas colunas.
Quando NÃO usar SQL puro direto: em aplicação grande com regras de negócio espalhadas, ORM e query builder reduzem repetição e erro humano. O SQL puro deste guia é a fundação, não o destino final. Para continuar na direção de dados, o plano de carreira analista de dados com Microsoft Power BI cobre SQL e modelagem com aplicação prática, e o curso de analista de cibersegurança júnior da Cisco complementa a parte de segurança, incluindo injeção SQL, por outro ângulo.
Cursos gratuitos google tecnologia 2026
Perguntas frequentes
Como inserir dados em uma tabela do PostgreSQL com INSERT?
Use INSERT INTO tabela (colunas) VALUES (valores) e acrescente RETURNING id para receber a chave gerada. Para várias linhas, coloque múltiplas tuplas de VALUES numa única instrução.
Como recuperar todas as linhas de uma tabela de forma eficiente?
SELECT * FROM tabela retorna tudo, mas prefira nomear colunas, ordenar por uma chave estável e usar LIMIT/OFFSET para paginar em tabelas grandes.
Como fazer update em uma linha específica sem afetar outras?
Use UPDATE com WHERE pela chave primária e valide o número de linhas afetadas. Rodar o comando como SELECT antes ajuda a conferir o alvo da alteração.
Como excluir um registro de uma tabela usando DELETE?
DELETE FROM tabela WHERE id = X remove o registro específico. Sem o WHERE, todas as linhas são excluídas, então dentro de uma transação é mais seguro testar primeiro.
Como garantir transações ACID nas operações CRUD?
Agrupe as operações relacionadas entre BEGIN e COMMIT e use ROLLBACK quando algo falhar. O PostgreSQL garante atomicidade, consistência, isolamento e durabilidade dentro desse bloco.
Como usar consultas parametrizadas para prevenir injeção SQL?
Use os placeholders do driver ($1 no node-postgres, %s no psycopg, :nome no PDO) e passe os valores separados. O banco nunca interpreta dados como código SQL.