Comandos de psql
Los metacomandos se ejecutan dentro de psql (el cliente de terminal de PostgreSQL), no en el servidor. Empiezan con una barra invertida y no necesitan punto y coma.
| Qué hace | Comando |
|---|
| Listar bases de datos | \l |
| Conectarse a otra base de datos | \c shop |
| Listar tablas | \dt |
| Listar tablas de todos los esquemas | \dt *.* |
| Describir una tabla (columnas, índices, claves) | \d users |
| Describir con almacenamiento y comentarios | \d+ users |
| Listar esquemas | \dn |
| Listar vistas | \dv |
| Listar índices | \di |
| Listar funciones | \df |
| Listar roles (usuarios) | \du |
| Mostrar la conexión actual | \conninfo |
| Ejecutar SQL desde un archivo | \i setup.sql |
| Activar o desactivar el tiempo de las consultas | \timing |
| Salida expandida (una columna por línea) | \x |
| Editar la última consulta en tu editor | \e |
| Ayuda sobre la sintaxis SQL | \h CREATE TABLE |
| Listar todos los metacomandos | \? |
| Salir de psql | \q |
Conectarse desde la terminal
| Qué hace | Comando |
|---|
| Conectarse como un usuario a una base de datos | psql -U postgres -d shop |
| Conectarse a un host y puerto remotos | psql -h db.example.com -p 5432 -U app -d shop |
| Conectarse con una URL de conexión | psql postgresql://app:secret@localhost:5432/shop |
| Ejecutar una consulta y salir | psql -d shop -c "SELECT count(*) FROM users;" |
| Ejecutar un archivo SQL | psql -d shop -f setup.sql |
| Crear una base de datos desde la shell | createdb shop |
| Eliminar una base de datos desde la shell | dropdb shop |
Bases de datos y esquemas
| Qué hace | SQL |
|---|
| Crear una base de datos | CREATE DATABASE shop; |
| Eliminar una base de datos | DROP DATABASE shop; |
| Mostrar la base de datos actual | SELECT current_database(); |
| Crear un esquema | CREATE SCHEMA sales; |
| Mostrar el orden de búsqueda de esquemas | SHOW search_path; |
| Buscar primero en un esquema | SET search_path TO sales, public; |
| Mostrar la versión del servidor | SELECT version(); |
Tablas y tipos de datos
| Qué hace | SQL |
|---|
| Crear una tabla con una clave de identidad | CREATE 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()); |
| Añadir una columna | ALTER TABLE users ADD COLUMN phone text; |
| Renombrar una columna | ALTER TABLE users RENAME COLUMN country TO country_code; |
| Cambiar el tipo de una columna | ALTER TABLE users ALTER COLUMN age TYPE smallint; |
| Definir un valor por defecto | ALTER TABLE users ALTER COLUMN active SET DEFAULT false; |
| Eliminar una columna | ALTER TABLE users DROP COLUMN tags; |
| Vaciar una tabla y reiniciar su identidad | TRUNCATE orders, users RESTART IDENTITY; |
| Eliminar una tabla si existe | DROP TABLE IF EXISTS products; |
| Decimal exacto para dinero | numeric(10,2) |
| Fecha y hora con zona horaria | timestamptz |
| UUID aleatorio | SELECT gen_random_uuid(); |
| Tipo enumerado | CREATE TYPE mood AS ENUM ('happy', 'sad'); |
Restricciones y claves
| Qué hace | SQL |
|---|
| Añadir una clave primaria | ALTER TABLE logs ADD PRIMARY KEY (id); |
| Clave foránea que elimina las filas hijas | CREATE TABLE reviews (id integer PRIMARY KEY, user_id integer REFERENCES users(id) ON DELETE CASCADE); |
| Añadir una restricción CHECK | ALTER TABLE orders ADD CONSTRAINT amount_positive CHECK (amount > 0); |
| Único donde los NULL cuentan como iguales (15+) | CREATE TABLE emails (address text UNIQUE NULLS NOT DISTINCT); |
| Hacer obligatoria una columna | ALTER TABLE users ALTER COLUMN country SET NOT NULL; |
| Eliminar una restricción | ALTER TABLE users DROP CONSTRAINT users_email_key; |
SELECT, WHERE y JOIN estándar están en la hoja de trucos de SQL; estas son las formas propias de PostgreSQL.
| Qué hace | SQL |
|---|
| Coincidencia sin distinguir mayúsculas | SELECT * FROM users WHERE name ILIKE 'a%'; |
| Coincidencia con expresión regular | SELECT * FROM users WHERE email ~ '@example\.com$'; |
| Primera fila de cada grupo | SELECT DISTINCT ON (user_id) user_id, amount FROM orders ORDER BY user_id, amount DESC; |
| Límite y desplazamiento | SELECT * FROM users ORDER BY id LIMIT 10 OFFSET 20; |
| Límite de filas estándar | SELECT * FROM users ORDER BY id FETCH FIRST 5 ROWS ONLY; |
| Conversión con :: | SELECT '42'::integer + 1; |
| Valor alternativo para NULL | SELECT name, COALESCE(email, 'none') FROM users; |
| Comparar tratando los NULL como iguales | SELECT * FROM users WHERE email IS DISTINCT FROM 'asha@example.com'; |
| Generar una serie de números | SELECT * FROM generate_series(1, 5); |
| Agregar en una cadena | SELECT string_agg(name, ', ' ORDER BY name) FROM users; |
| Agregado condicional | SELECT count(*) FILTER (WHERE status = 'paid') AS paid, count(*) AS total FROM orders; |
Insertar, actualizar, eliminar y upsert
| Qué hace | SQL |
|---|
| Insertar y recuperar el nuevo id | INSERT INTO users (name, email) VALUES ('Dana', 'dana@example.com') RETURNING id; |
| Insertar varias filas | INSERT INTO users (name) VALUES ('Eli'), ('Femi'); |
| Upsert (insertar o actualizar) | INSERT INTO users (name, email) VALUES ('Asha K', 'asha@example.com') ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name; |
| Insertar ignorando duplicados | INSERT INTO users (name, email) VALUES ('Ben', 'ben@example.com') ON CONFLICT DO NOTHING; |
| Actualizar y ver las filas modificadas | UPDATE employees SET salary = salary * 1.1 WHERE department = 'IT' RETURNING name, salary; |
| Actualizar desde otra tabla | UPDATE orders SET status = 'vip' FROM users WHERE orders.user_id = users.id AND users.country = 'IN'; |
| Eliminar y ver lo eliminado | DELETE FROM orders WHERE status = 'refunded' RETURNING id; |
| Eliminar usando otra tabla | DELETE FROM orders USING users WHERE orders.user_id = users.id AND users.active = false; |
| Copiar filas a una tabla nueva | CREATE TABLE paid_orders AS SELECT * FROM orders WHERE status = 'paid'; |
JSONB
| Qué hace | SQL |
|---|
| Obtener un campo como JSON | SELECT profile -> 'plan' FROM users; |
| Obtener un campo como texto | SELECT profile ->> 'plan' FROM users; |
| Obtener un campo anidado como texto | SELECT profile #>> '{address,city}' FROM users; |
| Filas cuyo JSON contiene un valor | SELECT * FROM users WHERE profile @> '{"plan": "pro"}'; |
| Filas que tienen una clave | SELECT * FROM users WHERE profile ? 'city'; |
| Asignar una clave | UPDATE users SET profile = jsonb_set(profile, '{plan}', '"team"') WHERE id = 2; |
| Combinar objetos | UPDATE users SET profile = profile || '{"beta": true}'; |
| Quitar una clave | UPDATE users SET profile = profile - 'city'; |
| Construir JSON a partir de columnas | SELECT jsonb_build_object('id', id, 'name', name) FROM users; |
| Filas como un array JSON | SELECT jsonb_agg(users) FROM users; |
| Índice para búsquedas con @> y ? | CREATE INDEX users_profile_idx ON users USING gin (profile); |
Arrays
| Qué hace | SQL |
|---|
| Literal de array | SELECT ARRAY[1, 2, 3]; |
| Filas donde el array tiene un valor | SELECT * FROM users WHERE 'sql' = ANY(tags); |
| Filas donde el array contiene todos estos | SELECT * FROM users WHERE tags @> ARRAY['sql', 'python']; |
| Una fila por elemento | SELECT name, unnest(tags) FROM users; |
| Añadir un elemento al final | UPDATE users SET tags = array_append(tags, 'sql') WHERE id = 2; |
| Longitud del array | SELECT name, cardinality(tags) FROM users; |
Fechas y horas
| Qué hace | SQL |
|---|
| Ahora, con zona horaria | SELECT now(); |
| Hoy | SELECT current_date; |
| Sumar un intervalo | SELECT current_date + INTERVAL '7 days'; |
| Filas de los últimos 30 días | SELECT * FROM orders WHERE created_at > now() - INTERVAL '30 days'; |
| Truncar al mes | SELECT date_trunc('month', created_at) AS month, sum(amount) FROM orders GROUP BY 1 ORDER BY 1; |
| Extraer una parte | SELECT EXTRACT(YEAR FROM hired_on) FROM employees; |
| Diferencia entre fechas (días) | SELECT DATE '2026-12-25' - DATE '2026-11-17'; |
| Edad entre fechas | SELECT name, age(current_date, hired_on) FROM employees; |
| Formatear una fecha como texto | SELECT to_char(hired_on, 'DD Mon YYYY') FROM employees; |
| Convertir texto en fecha | SELECT to_date('17/11/2026', 'DD/MM/YYYY'); |
| Convertir a una zona horaria | SELECT now() AT TIME ZONE 'Asia/Kolkata'; |
Funciones de texto
| Qué hace | SQL |
|---|
| Concatenar (un NULL da NULL) | SELECT name || ' <' || email || '>' FROM users; |
| Concatenar omitiendo los NULL | SELECT concat_ws(' ', name, email) FROM users; |
| Mayúsculas y minúsculas | SELECT upper(name), lower(name) FROM users; |
| Longitud | SELECT name, length(name) FROM users; |
| Parte de una cadena | SELECT substring(name FROM 1 FOR 2) FROM users; |
| Reemplazar | SELECT replace(email, '@example.com', '') FROM users; |
| Dividir y tomar una parte | SELECT split_part(email, '@', 2) FROM users; |
| Reemplazo con expresión regular | SELECT regexp_replace('a1b22c', '[0-9]+', '', 'g'); |
| Quitar espacios | SELECT trim(' hi '); |
CTEs y funciones de ventana
| Qué hace | SQL |
|---|
| Nombrar una subconsulta con WITH | WITH 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 hasta 5) | WITH RECURSIVE n(i) AS (SELECT 1 UNION ALL SELECT i + 1 FROM n WHERE i < 5) SELECT i FROM n; |
| Numerar filas por grupo | SELECT name, department, ROW_NUMBER() OVER (PARTITION BY department ORDER BY salary DESC) FROM employees; |
| Ranking con empates | SELECT name, DENSE_RANK() OVER (ORDER BY salary DESC) FROM employees; |
| Total acumulado | SELECT id, amount, sum(amount) OVER (ORDER BY id) FROM orders; |
| Valor de la fila anterior | SELECT name, salary, LAG(salary) OVER (ORDER BY hired_on) FROM employees; |
| Unir cada fila con su propia subconsulta | SELECT 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
| Qué hace | SQL |
|---|
| Índice B-tree (el predeterminado) | CREATE INDEX orders_user_idx ON orders (user_id); |
| Índice único | CREATE UNIQUE INDEX employees_name_idx ON employees (name); |
| Índice multicolumna | CREATE INDEX orders_user_created_idx ON orders (user_id, created_at); |
| Índice parcial | CREATE INDEX orders_paid_idx ON orders (created_at) WHERE status = 'paid'; |
| Índice de expresión | CREATE INDEX users_lower_email_idx ON users (lower(email)); |
| Índice de cobertura (escaneos solo de índice) | CREATE INDEX orders_user_cover_idx ON orders (user_id) INCLUDE (amount); |
| Crear sin bloquear escrituras | CREATE INDEX CONCURRENTLY orders_status_idx ON orders (status); |
| Eliminar un índice | DROP INDEX IF EXISTS orders_user_idx; |
| Ver el plan | EXPLAIN SELECT * FROM orders WHERE user_id = 1; |
| Ver el plan con tiempos reales | EXPLAIN ANALYZE SELECT * FROM orders WHERE user_id = 1; |
Transacciones y bloqueos
| Qué hace | SQL |
|---|
| Empezar y luego confirmar o deshacer | BEGIN; UPDATE employees SET salary = 0 WHERE id = 3; ROLLBACK; |
| Deshacer parte de una transacción | BEGIN; INSERT INTO users (name) VALUES ('Gil'); SAVEPOINT s1; DELETE FROM users WHERE name = 'Gil'; ROLLBACK TO s1; COMMIT; |
| Aislamiento más estricto | BEGIN ISOLATION LEVEL SERIALIZABLE; SELECT count(*) FROM orders; COMMIT; |
| Bloquear las filas que lees | BEGIN; SELECT * FROM orders WHERE id = 1 FOR UPDATE; COMMIT; |
| Cola de trabajos: saltar filas bloqueadas | BEGIN; SELECT id FROM orders WHERE status = 'paid' ORDER BY id LIMIT 1 FOR UPDATE SKIP LOCKED; COMMIT; |
Usuarios, roles y privilegios
| Qué hace | SQL |
|---|
| Crear un rol con inicio de sesión | CREATE ROLE app LOGIN PASSWORD 'change-me'; |
| Acceso de solo lectura a una tabla | GRANT SELECT ON users TO app; |
| Acceso de lectura a todas las tablas de un esquema | GRANT SELECT ON ALL TABLES IN SCHEMA public TO app; |
| Retirar un privilegio | REVOKE SELECT ON users FROM app; |
| Cambiar una contraseña | ALTER ROLE app PASSWORD 'new-secret'; |
| Mostrar el usuario actual | SELECT current_user; |
Mantenimiento y monitorización
| Qué hace | SQL |
|---|
| Consultas en ejecución | SELECT pid, state, query FROM pg_stat_activity WHERE state <> 'idle'; |
| Cancelar una consulta | SELECT pg_cancel_backend(12345); |
| Terminar una conexión | SELECT pg_terminate_backend(12345); |
| Tamaño de una tabla con sus índices | SELECT pg_size_pretty(pg_total_relation_size('orders')); |
| Tamaño de la base de datos | SELECT pg_size_pretty(pg_database_size(current_database())); |
| Actualizar las estadísticas del planificador | ANALYZE orders; |
| Recuperar filas muertas | VACUUM orders; |
| Reescribir una tabla a su tamaño mínimo (la bloquea) | VACUUM FULL orders; |
| Mostrar un parámetro | SHOW work_mem; |
| Cambiar un parámetro para esta sesión | SET work_mem = '64MB'; |
Copia de seguridad y restauración
Comandos de shell de las herramientas cliente de PostgreSQL.
| Qué hace | Comando |
|---|
| Volcar una base de datos a un archivo SQL | pg_dump -U postgres shop > shop.sql |
| Volcar en el formato personalizado | pg_dump -Fc -U postgres shop > shop.dump |
| Volcar una tabla | pg_dump -t orders shop > orders.sql |
| Restaurar un volcado SQL | psql -d shop -f shop.sql |
| Restaurar un volcado en formato personalizado | pg_restore -d shop shop.dump |
| Volcar todas las bases de datos y roles | pg_dumpall > cluster.sql |
| Exportar una consulta a CSV (desde psql) | \copy (SELECT * FROM orders) TO 'orders.csv' CSV HEADER |
| Importar un CSV (desde psql) | \copy orders (user_id, amount, status) FROM 'orders.csv' CSV HEADER |
Cada comando de psql y cada sentencia de PostgreSQL que necesitas, en tablas listas para copiar y pegar: primero la conexión y los comandos \d, luego tablas, upserts, JSONB, fechas, funciones de ventana, índices, roles, copias de seguridad y mantenimiento.
El SQL de esta página usa la sintaxis de PostgreSQL 17, y la mayor parte también funciona en versiones anteriores. Las sentencias SQL se comprobaron en PostgreSQL 17; para probar una, pégala en el playground de PostgreSQL, que incluye tablas de ejemplo.