Clase 06 · Módulo 07
Consultas rápidas: índices, vistas y funciones
Consultas rápidas: índices, vistas y funciones
Qué logras en esta clase
Reconoces una consulta lenta, encuentras la causa y eliges la herramienta de Postgres que corresponde.
- Lees el plan de una consulta con
explain - Decides qué columnas necesitan un índice
- Usas vistas para consultas que se repiten
- Sabes cuándo una función de base de datos conviene y qué riesgo trae
02
Por qué todo es rápido al principio
Con 100 filas, cualquier consulta responde al instante. Postgres revisa la tabla completa y no se nota.
Con 100.000 filas hace lo mismo: recorrer todo para encontrar las diez que pediste. Eso se llama recorrido secuencial, y es la causa más frecuente de una pantalla que antes cargaba bien y ahora tarda.
El problema no aparece en tus pruebas. Aparece con el éxito.
03
Primero mide
Mide antes de optimizar. Un índice puesto por intuición puede no servir de nada, y aun así cuesta.
04
Ver qué hace Postgres: explain
explain select * from pedidos where estado = 'pendiente';explain no ejecuta la consulta: muestra el plan que Postgres seguiría. Busca dos señales:
- la expresión
Seq Scansobre una tabla grande - números de costo altos
En el panel, la página «Query Performance» lista tus consultas más pesadas. Al abrir una, la pestaña «Indexes» ofrece el Index Advisor, que sugiere índices.
05
Qué es un índice
create index idx_pedidos_estado on pedidos (estado);Un índice es como el índice de un libro: una estructura aparte que le dice a Postgres dónde están las filas, sin leer la tabla entera.
Se crea sobre una o más columnas. Tu consulta no cambia: Postgres decide solo cuándo usarlo.
Va en una migración, como todo cambio de la base.
06
Qué columnas indexar
| Uso de la columna | Ejemplo | Conviene índice |
|---|---|---|
| Filtro frecuente | .eq('estado', ...) | Sí |
| Clave foránea | pedido_id | Sí |
| Orden con límite | .order('creado_en').limit(20) | Sí |
| Rara vez consultada | nota | No |
Parte por las consultas de tus pantallas principales: la lista de inicio, el detalle, la búsqueda.
07
La clave primaria sí, la foránea no
La clave primaria ya tiene índice. La clave foránea no lo recibe sola: se lo creas tú.
08
Dónde más se nota: relaciones y RLS
Dos lugares donde un índice faltante pesa más:
- Consultas con tablas relacionadas: traer cada pedido con sus líneas usa
pedido_iduna y otra vez - Políticas de RLS: la regla «solo tus filas» compara la columna del dueño en cada consulta
09
Índice compuesto e índice parcial
create index idx_pedidos_estado_fecha
on pedidos (estado, creado_en);
create index idx_pedidos_pendientes
on pedidos (creado_en)
where estado = 'pendiente';- Compuesto: cuando siempre filtras por dos columnas juntas
- Parcial: cuando solo te interesa un grupo de filas; ocupa menos
Para que Postgres use el parcial, tu consulta debe incluir la misma condición.
10
El costo de un índice
- Cada escritura actualiza también los índices: insertar y modificar se vuelve más lento
- Ocupan espacio, y en el plan gratuito tienes 500 MB
- En tablas pequeñas Postgres puede ignorarlos: leer todo le resulta más rápido
- Crear uno sobre una tabla grande bloquea las escrituras mientras se construye, salvo que uses
create index concurrently
Si un índice no baja el costo en explain, bórralo.
11
El equilibrio
Un índice acelera leer y encarece escribir. Crea los que tus consultas reales piden, no más.
12
Paginar: no traigas todo
const { data, error } = await supabase
.from('pedidos')
.select('id, estado, creado_en')
.order('creado_en', { ascending: false })
.range(0, 19);Una lista de 5.000 pedidos no se pide completa: se pide por tramos de 20 a medida que el usuario baja.
Ningún índice compensa traer miles de filas que nadie va a mirar. Combina siempre range con un order sobre una columna indexada.
13
Vistas: una consulta con nombre
create view pedidos_resumen
with (security_invoker = true) as
select p.id, p.estado, sum(i.cantidad) as unidades
from pedidos p
join pedido_items i on i.pedido_id = p.id
group by p.id;Una vista guarda una consulta y se lee desde la app como si fuera una tabla: .from('pedidos_resumen').
Sirve cuando varias pantallas necesitan el mismo cálculo. No guarda datos: se recalcula en cada lectura.
14
El riesgo de una vista
En Postgres, una vista se ejecuta por defecto con los permisos de quien la creó. En la práctica, eso puede saltarse RLS y mostrar filas ajenas.
La opción security_invoker = true hace que respete los permisos de quien consulta.
15
Funciones: lógica dentro de la base
create or replace function total_unidades(pedido bigint)
returns bigint
language sql
as $$
select coalesce(sum(cantidad), 0)
from pedido_items
where pedido_id = pedido;
$$;Una función es código guardado en Postgres. Desde la app se llama con rpc:
const { data, error } = await supabase
.rpc('total_unidades', { pedido: 12 });16
Cuándo conviene una función
- Varios pasos que deben ocurrir juntos: crear el pedido y sus líneas, o no crear nada
- Cálculos sobre muchas filas: mejor sumar en la base que traer todo al teléfono
- Reglas que la app no debe poder saltarse: descontar stock, por ejemplo
Para una lectura simple, una consulta normal o una vista bastan. Una función es más difícil de leer y de probar: úsala cuando resuelva algo que lo demás no puede.
17
Invoker o definer
security invoker | security definer | |
|---|---|---|
| Corre como | Quien la llama | Quien la creó |
| RLS | La respeta | Puede saltársela |
| Es | El valor por defecto | Una excepción |
Supabase recomienda invoker salvo necesidad concreta. Si usas definer, fija set search_path = '', nombra cada tabla con su esquema (public.pedidos) y comprueba dentro de la función quién la está llamando.
18
Quién puede ejecutar una función
Por defecto, cualquier rol puede ejecutar una función, incluido el de un visitante sin sesión.
revoke execute on function public.total_unidades from public;
revoke execute on function public.total_unidades from anon;
grant execute on function public.total_unidades to authenticated;Así solo la llaman usuarios con sesión iniciada.
19
Qué herramienta para qué problema
| Problema | Herramienta |
|---|---|
| Un filtro o un orden lento | Índice |
| La lista trae demasiado | Paginación |
| El mismo cálculo en varias pantallas | Vista |
| Varios pasos que van juntos | Función |
| Usar un secreto o llamar a otro servicio | Edge Function (módulo 10) |
Casi todos los problemas de velocidad de una primera app se resuelven con las dos primeras filas.
20
Trabajarlo con Claude Code
- Identifica la pantalla lenta y la consulta que hace
- Ejecuta
explainen el «SQL Editor» y copia el resultado - Entrégale a Claude la consulta, el plan y el tamaño de la tabla
- Pídele la causa antes que la solución
- Aplica el índice como migración en pruebas
- Repite
explainy compara el costo
Sin el paso 6 no sabes si arreglaste algo.
21
Errores comunes
- Indexar todas las columnas «por si acaso»
- Olvidar el índice de las claves foráneas y de la columna de dueño
- Pedir listas completas en vez de paginar
- Crear vistas sin
security_invoker - Usar
security definerpara esquivar una política que molestaba - Optimizar sin medir antes y después
22
Lo que te llevas
- Una consulta lenta casi siempre es un recorrido secuencial sobre una tabla grande
explainy la página «Query Performance» muestran dónde está el costo- Indexa filtros frecuentes, claves foráneas y órdenes con límite; nada más
- Vistas con
security_invoker; funcionesinvokerpor defecto y con permisos cerrados - Se mide antes y después de cada cambio
23
Hazlo ahora
Diez minutos, en tu proyecto de pruebas:
- Elige la consulta de tu pantalla principal
- Escríbela en SQL con ayuda de Claude Code y ejecútala con
explain - Anota si aparece
Seq Scany el costo - Lista tus claves foráneas y marca cuáles no tienen índice
- Crea una migración con esos índices y aplícala
Con pocas filas, Postgres puede seguir eligiendo Seq Scan: es normal. El índice queda listo para cuando la tabla crezca.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026