Menu
CoddyTech

Folha de Consulta PostgreSQL

Última atualização

Comandos do psql

Os metacomandos rodam dentro do psql (o cliente de terminal do PostgreSQL), não no servidor. Começam com uma barra invertida e não precisam de ponto e vírgula.

O que fazComando
Listar bancos de dados\l
Conectar a outro banco de dados\c shop
Listar tabelas\dt
Listar tabelas de todos os schemas\dt *.*
Descrever uma tabela (colunas, índices, chaves)\d users
Descrever com armazenamento e comentários\d+ users
Listar schemas\dn
Listar views\dv
Listar índices\di
Listar funções\df
Listar papéis (usuários)\du
Mostrar a conexão atual\conninfo
Executar SQL de um arquivo\i setup.sql
Ligar ou desligar o tempo das consultas\timing
Saída expandida (uma coluna por linha)\x
Editar a última consulta no seu editor\e
Ajuda sobre a sintaxe SQL\h CREATE TABLE
Listar todos os metacomandos\?
Sair do psql\q

Conectar pelo terminal

O que fazComando
Conectar como um usuário a um banco de dadospsql -U postgres -d shop
Conectar a um host e porta remotospsql -h db.example.com -p 5432 -U app -d shop
Conectar com uma URL de conexãopsql postgresql://app:secret@localhost:5432/shop
Executar uma consulta e sairpsql -d shop -c "SELECT count(*) FROM users;"
Executar um arquivo SQLpsql -d shop -f setup.sql
Criar um banco de dados pelo shellcreatedb shop
Excluir um banco de dados pelo shelldropdb shop

Bancos de dados e schemas

O que fazSQL
Criar um banco de dadosCREATE DATABASE shop;
Excluir um banco de dadosDROP DATABASE shop;
Mostrar o banco de dados atualSELECT current_database();
Criar um schemaCREATE SCHEMA sales;
Mostrar a ordem de busca dos schemasSHOW search_path;
Procurar primeiro em um schemaSET search_path TO sales, public;
Mostrar a versão do servidorSELECT version();

Tabelas e tipos de dados

O que fazSQL
Criar uma tabela com chave de identidadeCREATE TABLE products (id integer GENERATED ALWAYS AS IDENTITY PRIMARY KEY, name text NOT NULL, price numeric(10,2) CHECK (price >= 0), created_at timestamptz DEFAULT now());
Adicionar uma colunaALTER TABLE users ADD COLUMN phone text;
Renomear uma colunaALTER TABLE users RENAME COLUMN country TO country_code;
Mudar o tipo de uma colunaALTER TABLE users ALTER COLUMN age TYPE smallint;
Definir um valor padrãoALTER TABLE users ALTER COLUMN active SET DEFAULT false;
Excluir uma colunaALTER TABLE users DROP COLUMN tags;
Esvaziar uma tabela e reiniciar a identidadeTRUNCATE orders, users RESTART IDENTITY;
Excluir uma tabela se existirDROP TABLE IF EXISTS products;
Decimal exato para dinheironumeric(10,2)
Data e hora com fuso horáriotimestamptz
UUID aleatórioSELECT gen_random_uuid();
Tipo enumCREATE TYPE mood AS ENUM ('happy', 'sad');

Restrições e chaves

O que fazSQL
Adicionar uma chave primáriaALTER TABLE logs ADD PRIMARY KEY (id);
Chave estrangeira que exclui as linhas filhasCREATE TABLE reviews (id integer PRIMARY KEY, user_id integer REFERENCES users(id) ON DELETE CASCADE);
Adicionar uma restrição CHECKALTER TABLE orders ADD CONSTRAINT amount_positive CHECK (amount > 0);
Único com NULLs contados como iguais (15+)CREATE TABLE emails (address text UNIQUE NULLS NOT DISTINCT);
Tornar uma coluna obrigatóriaALTER TABLE users ALTER COLUMN country SET NOT NULL;
Excluir uma restriçãoALTER TABLE users DROP CONSTRAINT users_email_key;

Consultas (extras do PostgreSQL)

SELECT, WHERE e JOIN padrão estão na folha de consulta SQL; estas são as formas do PostgreSQL.

O que fazSQL
Busca sem diferenciar maiúsculasSELECT * FROM users WHERE name ILIKE 'a%';
Busca com expressão regularSELECT * FROM users WHERE email ~ '@example\.com$';
Primeira linha de cada grupoSELECT DISTINCT ON (user_id) user_id, amount FROM orders ORDER BY user_id, amount DESC;
Limite e deslocamentoSELECT * FROM users ORDER BY id LIMIT 10 OFFSET 20;
Limite de linhas padrãoSELECT * FROM users ORDER BY id FETCH FIRST 5 ROWS ONLY;
Conversão com ::SELECT '42'::integer + 1;
Valor alternativo para NULLSELECT name, COALESCE(email, 'none') FROM users;
Comparar tratando NULLs como iguaisSELECT * FROM users WHERE email IS DISTINCT FROM 'asha@example.com';
Gerar uma série de númerosSELECT * FROM generate_series(1, 5);
Agregar em uma stringSELECT string_agg(name, ', ' ORDER BY name) FROM users;
Agregação condicionalSELECT count(*) FILTER (WHERE status = 'paid') AS paid, count(*) AS total FROM orders;

Inserir, atualizar, excluir e upsert

O que fazSQL
Inserir e receber o novo idINSERT INTO users (name, email) VALUES ('Dana', 'dana@example.com') RETURNING id;
Inserir várias linhasINSERT INTO users (name) VALUES ('Eli'), ('Femi');
Upsert (inserir ou atualizar)INSERT INTO users (name, email) VALUES ('Asha K', 'asha@example.com') ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name;
Inserir ignorando duplicadosINSERT INTO users (name, email) VALUES ('Ben', 'ben@example.com') ON CONFLICT DO NOTHING;
Atualizar e ver as linhas alteradasUPDATE employees SET salary = salary * 1.1 WHERE department = 'IT' RETURNING name, salary;
Atualizar a partir de outra tabelaUPDATE orders SET status = 'vip' FROM users WHERE orders.user_id = users.id AND users.country = 'IN';
Excluir e ver o que foi excluídoDELETE FROM orders WHERE status = 'refunded' RETURNING id;
Excluir usando outra tabelaDELETE FROM orders USING users WHERE orders.user_id = users.id AND users.active = false;
Copiar linhas para uma nova tabelaCREATE TABLE paid_orders AS SELECT * FROM orders WHERE status = 'paid';

JSONB

O que fazSQL
Obter um campo como JSONSELECT profile -> 'plan' FROM users;
Obter um campo como textoSELECT profile ->> 'plan' FROM users;
Obter um campo aninhado como textoSELECT profile #>> '{address,city}' FROM users;
Linhas cujo JSON contém um valorSELECT * FROM users WHERE profile @> '{"plan": "pro"}';
Linhas que têm uma chaveSELECT * FROM users WHERE profile ? 'city';
Definir uma chaveUPDATE users SET profile = jsonb_set(profile, '{plan}', '"team"') WHERE id = 2;
Mesclar objetosUPDATE users SET profile = profile || '{"beta": true}';
Remover uma chaveUPDATE users SET profile = profile - 'city';
Montar JSON a partir de colunasSELECT jsonb_build_object('id', id, 'name', name) FROM users;
Linhas como um array JSONSELECT jsonb_agg(users) FROM users;
Índice para buscas com @> e ?CREATE INDEX users_profile_idx ON users USING gin (profile);

Arrays

O que fazSQL
Literal de arraySELECT ARRAY[1, 2, 3];
Linhas em que o array tem um valorSELECT * FROM users WHERE 'sql' = ANY(tags);
Linhas em que o array contém todos estesSELECT * FROM users WHERE tags @> ARRAY['sql', 'python'];
Uma linha por elementoSELECT name, unnest(tags) FROM users;
Adicionar um elemento no fimUPDATE users SET tags = array_append(tags, 'sql') WHERE id = 2;
Tamanho do arraySELECT name, cardinality(tags) FROM users;

Datas e horas

O que fazSQL
Agora, com fuso horárioSELECT now();
HojeSELECT current_date;
Somar um intervaloSELECT current_date + INTERVAL '7 days';
Linhas dos últimos 30 diasSELECT * FROM orders WHERE created_at > now() - INTERVAL '30 days';
Truncar para o mêsSELECT date_trunc('month', created_at) AS month, sum(amount) FROM orders GROUP BY 1 ORDER BY 1;
Extrair uma parteSELECT EXTRACT(YEAR FROM hired_on) FROM employees;
Diferença entre datas (dias)SELECT DATE '2026-12-25' - DATE '2026-11-17';
Idade entre datasSELECT name, age(current_date, hired_on) FROM employees;
Formatar uma data como textoSELECT to_char(hired_on, 'DD Mon YYYY') FROM employees;
Converter texto em dataSELECT to_date('17/11/2026', 'DD/MM/YYYY');
Converter para um fuso horárioSELECT now() AT TIME ZONE 'Asia/Kolkata';

Funções de texto

O que fazSQL
Concatenar (NULL resulta em NULL)SELECT name || ' <' || email || '>' FROM users;
Concatenar ignorando NULLsSELECT concat_ws(' ', name, email) FROM users;
Maiúsculas e minúsculasSELECT upper(name), lower(name) FROM users;
ComprimentoSELECT name, length(name) FROM users;
Parte de uma stringSELECT substring(name FROM 1 FOR 2) FROM users;
SubstituirSELECT replace(email, '@example.com', '') FROM users;
Dividir e pegar uma parteSELECT split_part(email, '@', 2) FROM users;
Substituição com expressão regularSELECT regexp_replace('a1b22c', '[0-9]+', '', 'g');
Remover espaçosSELECT trim(' hi ');

CTEs e funções de janela

O que fazSQL
Nomear uma subconsulta com WITHWITH paid AS (SELECT user_id, sum(amount) AS total FROM orders WHERE status = 'paid' GROUP BY user_id) SELECT * FROM paid WHERE total > 50;
CTE recursiva (contar até 5)WITH RECURSIVE n(i) AS (SELECT 1 UNION ALL SELECT i + 1 FROM n WHERE i < 5) SELECT i FROM n;
Numerar linhas por grupoSELECT name, department, ROW_NUMBER() OVER (PARTITION BY department ORDER BY salary DESC) FROM employees;
Classificar com empatesSELECT name, DENSE_RANK() OVER (ORDER BY salary DESC) FROM employees;
Total acumuladoSELECT id, amount, sum(amount) OVER (ORDER BY id) FROM orders;
Valor da linha anteriorSELECT name, salary, LAG(salary) OVER (ORDER BY hired_on) FROM employees;
Juntar cada linha à sua própria subconsultaSELECT u.name, o.amount FROM users u CROSS JOIN LATERAL (SELECT amount FROM orders WHERE user_id = u.id ORDER BY amount DESC LIMIT 1) o;

Índices

O que fazSQL
Índice B-tree (o padrão)CREATE INDEX orders_user_idx ON orders (user_id);
Índice únicoCREATE UNIQUE INDEX employees_name_idx ON employees (name);
Índice de várias colunasCREATE INDEX orders_user_created_idx ON orders (user_id, created_at);
Índice parcialCREATE INDEX orders_paid_idx ON orders (created_at) WHERE status = 'paid';
Índice de expressãoCREATE INDEX users_lower_email_idx ON users (lower(email));
Índice de cobertura (index-only scans)CREATE INDEX orders_user_cover_idx ON orders (user_id) INCLUDE (amount);
Criar sem bloquear escritasCREATE INDEX CONCURRENTLY orders_status_idx ON orders (status);
Excluir um índiceDROP INDEX IF EXISTS orders_user_idx;
Ver o planoEXPLAIN SELECT * FROM orders WHERE user_id = 1;
Ver o plano com tempos reaisEXPLAIN ANALYZE SELECT * FROM orders WHERE user_id = 1;

Transações e locks

O que fazSQL
Iniciar, depois manter ou desfazerBEGIN; UPDATE employees SET salary = 0 WHERE id = 3; ROLLBACK;
Desfazer parte de uma transaçãoBEGIN; INSERT INTO users (name) VALUES ('Gil'); SAVEPOINT s1; DELETE FROM users WHERE name = 'Gil'; ROLLBACK TO s1; COMMIT;
Isolamento mais rigorosoBEGIN ISOLATION LEVEL SERIALIZABLE; SELECT count(*) FROM orders; COMMIT;
Bloquear as linhas que você lêBEGIN; SELECT * FROM orders WHERE id = 1 FOR UPDATE; COMMIT;
Fila de tarefas: pular linhas bloqueadasBEGIN; SELECT id FROM orders WHERE status = 'paid' ORDER BY id LIMIT 1 FOR UPDATE SKIP LOCKED; COMMIT;

Usuários, papéis e privilégios

O que fazSQL
Criar um papel com loginCREATE ROLE app LOGIN PASSWORD 'change-me';
Acesso somente leitura a uma tabelaGRANT SELECT ON users TO app;
Acesso de leitura a todas as tabelas de um schemaGRANT SELECT ON ALL TABLES IN SCHEMA public TO app;
Revogar um privilégioREVOKE SELECT ON users FROM app;
Alterar uma senhaALTER ROLE app PASSWORD 'new-secret';
Mostrar o usuário atualSELECT current_user;

Manutenção e monitoramento

O que fazSQL
Consultas em execuçãoSELECT pid, state, query FROM pg_stat_activity WHERE state <> 'idle';
Cancelar uma consultaSELECT pg_cancel_backend(12345);
Encerrar uma conexãoSELECT pg_terminate_backend(12345);
Tamanho de uma tabela com seus índicesSELECT pg_size_pretty(pg_total_relation_size('orders'));
Tamanho do banco de dadosSELECT pg_size_pretty(pg_database_size(current_database()));
Atualizar as estatísticas do planejadorANALYZE orders;
Recuperar linhas mortasVACUUM orders;
Reescrever uma tabela no tamanho mínimo (bloqueia a tabela)VACUUM FULL orders;
Mostrar uma configuraçãoSHOW work_mem;
Alterar uma configuração nesta sessãoSET work_mem = '64MB';

Backup e restauração

Comandos de shell das ferramentas cliente do PostgreSQL.

O que fazComando
Fazer dump de um banco de dados em um arquivo SQLpg_dump -U postgres shop > shop.sql
Fazer dump no formato personalizadopg_dump -Fc -U postgres shop > shop.dump
Fazer dump de uma tabelapg_dump -t orders shop > orders.sql
Restaurar um dump SQLpsql -d shop -f shop.sql
Restaurar um dump em formato personalizadopg_restore -d shop shop.dump
Fazer dump de todos os bancos e papéispg_dumpall > cluster.sql
Exportar uma consulta para CSV (pelo psql)\copy (SELECT * FROM orders) TO 'orders.csv' CSV HEADER
Importar um CSV (pelo psql)\copy orders (user_id, amount, status) FROM 'orders.csv' CSV HEADER

Cada comando do psql e cada instrução PostgreSQL que você usa, em tabelas prontas para copiar e colar: primeiro a conexão e os comandos \d, depois tabelas, upserts, JSONB, datas, funções de janela, índices, papéis, backups e manutenção.

O SQL aqui usa a sintaxe do PostgreSQL 17, e a maior parte também funciona em versões anteriores. As instruções SQL foram verificadas no PostgreSQL 17; para testar uma, cole-a no playground de PostgreSQL, que vem com tabelas de exemplo.

Perguntas frequentes sobre a folha de consulta PostgreSQL

O que são comandos do psql?
O psql é o cliente de terminal do PostgreSQL. Além de SQL, ele entende metacomandos que começam com uma barra invertida: \l lista os bancos de dados, \c conecta a um deles, \dt lista as tabelas, \d users descreve uma tabela e \q sai. Eles rodam no próprio psql, por isso não precisam de ponto e vírgula e não funcionam em outros clientes.
Como listo todas as tabelas no PostgreSQL?
No psql, digite \dt (ou \dt *.* para todos os schemas). Em SQL, de qualquer cliente: SELECT table_name FROM information_schema.tables WHERE table_schema = 'public';
O SQL do PostgreSQL é diferente do MySQL?
O núcleo (SELECT, JOIN, GROUP BY) é o mesmo. O PostgreSQL adiciona ILIKE, conversões com ::, RETURNING, DISTINCT ON, upserts com ON CONFLICT, arrays e JSONB, e usa colunas de identidade onde o MySQL usa AUTO_INCREMENT.
Qual é a diferença entre JSON e JSONB?
json guarda o texto como foi escrito; jsonb guarda uma forma binária já interpretada, descarta chaves duplicadas e espaços em branco, e suporta índices (GIN) e operadores como @> e ?. Use jsonb, a menos que precise do texto original exato.
Posso praticar estas consultas online?
Sim. O playground de PostgreSQL executa qualquer consulta em um banco de dados PostgreSQL 17 real no seu navegador, com tabelas de exemplo que você pode editar. Instruções que exigem privilégios de servidor, como CREATE DATABASE ou CREATE ROLE, precisam do seu próprio PostgreSQL.
Esta folha de consulta PostgreSQL é gratuita?

Sim. Ela é gratuita para ler, copiar e imprimir, sem cadastro.

Ilustração das linguagens de programação do Coddy

Aprenda PostgreSQL com a Coddy

Começar