Clase 03 · Módulo 07
Tablas, relaciones y tipos de dato
Tablas, relaciones y tipos de dato
Qué logras en esta clase
Conviertes el modelo de datos que dibujaste en el módulo 2 en tablas reales de Postgres, y sabes revisar el SQL que Claude escribe.
- Eliges clave primaria y tipo de dato con criterio
- Conectas tablas con claves foráneas
- Usas restricciones para que la base rechace datos malos
- Activas RLS en cada tabla desde el inicio
02
Del papel a la base
En el módulo 2 listaste entidades, atributos y relaciones. Aquí cada una tiene una traducción directa.
Usaremos una cafetería que recibe pedidos desde la app: productos, pedidos y las líneas de cada pedido.
03
Anatomía de una tabla
create table productos (
id bigint generated always as identity primary key,
nombre text not null,
precio integer not null check (precio >= 0),
disponible boolean not null default true,
creado_en timestamptz not null default now()
);Cada línea es una columna: nombre, tipo y reglas. Los nombres van en minúsculas y con guion bajo, como recomienda Supabase.
No necesitas escribir esto de memoria. Sí necesitas poder leerlo.
04
La clave primaria
Cada fila necesita una clave primaria: un valor único que la identifica y que no cambia nunca.
05
Qué clave primaria elegir
| Número automático | UUID | |
|---|---|---|
| Se declara | bigint generated always as identity | uuid default gen_random_uuid() |
| Se ve como | 1, 2, 3… | Texto largo aleatorio |
| A favor | Corto y fácil de leer | Puede crearse en el teléfono |
| En contra | Revela cuántas filas hay | Más largo, menos legible |
Si tu app escribe sin conexión (módulo 6), usa UUID: el teléfono crea el identificador antes de sincronizar. Si no, cualquiera de los dos sirve.
06
Tipos de dato que más usarás
| Tipo | Para qué |
|---|---|
text | Cualquier texto |
integer, bigint | Números enteros |
numeric | Decimales exactos |
boolean | Sí o no |
timestamptz | Fecha y hora con zona horaria |
jsonb | Datos con estructura variable |
Postgres tiene decenas más. Con estos seis y uuid construyes casi cualquier primera versión.
07
Tres elecciones que evitan problemas
- Fechas:
timestamptz, notimestamp. Guarda el instante exacto y cada teléfono lo muestra en su hora local - Texto:
text, novarchar(n). Si quieres limitar el largo, usa una restricción - Dinero: nunca decimales aproximados. Usa
numeric, o enteros en la unidad mínima; el peso chileno no tiene decimales, así queintegerbasta
Son las mismas recomendaciones de la documentación de Supabase.
08
Restricciones: la base se defiende sola
| Restricción | Qué garantiza |
|---|---|
not null | El dato no puede faltar |
unique | No hay dos filas con ese valor |
check (...) | Cumple una condición, como precio >= 0 |
default | Valor que se pone si no envías uno |
references | Apunta a una fila que existe |
Una restricción es una regla que Postgres comprueba en cada escritura, venga de donde venga.
09
Por qué no basta con validar en la app
Una regla escrita en la base se cumple siempre, aunque la app tenga un error o alguien llame a la API por fuera.
10
Relación uno a muchos
Un pedido tiene muchas líneas. La línea guarda el id de su pedido:
create table pedido_items (
id bigint generated always as identity primary key,
pedido_id bigint not null references pedidos on delete cascade,
producto_id bigint not null references productos,
cantidad integer not null check (cantidad > 0)
);references pedidos es la clave foránea: Postgres rechaza una línea que apunte a un pedido inexistente.
11
Muchos a muchos: la tabla intermedia
Un pedido incluye muchos productos y un producto aparece en muchos pedidos. Ninguna de las dos tablas puede guardar eso sola.
La solución es una tabla intermedia con dos claves foráneas. pedido_items ya lo es, y además guarda un dato propio de la relación: la cantidad.
12
Qué pasa al borrar una fila
| Opción | Efecto al borrar el padre |
|---|---|
| Sin indicar nada | Se rechaza mientras existan hijos |
on delete cascade | Se borran también los hijos |
on delete set null | Los hijos quedan sin padre |
Criterio: cascade para piezas que no tienen sentido solas, como las líneas de un pedido. Rechazar para lo que no debe perderse, como un producto con ventas registradas.
13
La columna del dueño
Casi toda tabla con datos de personas necesita una columna que diga de quién es la fila.
En Supabase esa columna guarda el identificador del usuario, de tipo uuid, y apunta a la tabla de usuarios de Auth.
Es la pieza sobre la que se escriben las reglas de RLS: «cada uno ve solo sus pedidos». La conectarás en el módulo 8; por ahora, identifica qué tablas la necesitan.
14
Dos formas de crear tablas
| Editor visual | SQL | |
|---|---|---|
| Dónde | «Table Editor» del panel, «New table» | «SQL Editor» o un archivo de migración |
| RLS | Se activa solo | Lo activas tú |
| Queda registro | No | Sí, si usas migraciones |
| Para qué | Mirar datos, probar una idea | Todo lo que va a quedar |
Todo lo que quede en tu app termina en SQL dentro de migraciones (clase 5). El editor visual sirve para explorar.
15
Activa RLS en cada tabla
alter table productos enable row level security;- Sin RLS: cualquiera con tu clave publicable lee y escribe todo
- Con RLS y sin políticas: la API no devuelve ninguna fila
El segundo estado es el seguro. Las políticas que abren el acceso correcto se escriben en el módulo 8.
16
Seguro por defecto
Una tabla cerrada que hay que abrir es un contratiempo. Una tabla abierta que olvidaste cerrar es una filtración.
17
Cómo pedírselo a Claude Code
- Entrégale tu modelo en papel: entidades, atributos y relaciones
- Pídele el SQL de las tablas como una migración
- Pídele que explique cada restricción y cada
on delete - Lee el resultado antes de aplicarlo
18
Qué revisar en el SQL que recibes
- Cada tabla tiene clave primaria
not nullen todo dato que no puede faltar- Cada clave foránea tiene decidido su
on delete - Las fechas usan
timestamptz - Cada tabla termina con RLS activado
Cinco comprobaciones, dos minutos. Detectan la mayoría de los problemas antes de que existan datos.
19
jsonb: útil, pero no para todo
jsonb guarda un objeto completo en una sola columna.
| Sirve para | No sirve para |
|---|---|
| Preferencias que varían por usuario | Datos por los que filtras u ordenas |
| La respuesta cruda de un servicio externo | Datos que se relacionan con otra tabla |
Si te descubres metiendo todo en un jsonb, vuelve al modelo en papel: probablemente falta una tabla.
20
Qué no va en la base
Fotos, documentos y audios no se guardan dentro de una tabla. Van en Storage (módulo 9), y la tabla guarda solo la ruta, en una columna text.
21
Errores comunes
- Tablas sin clave primaria o sin RLS
- Guardar fechas como texto, o precios con decimales aproximados
- Repetir el mismo dato en dos tablas en vez de relacionarlas
- No decidir el
on deletey descubrirlo cuando un borrado falla - Poner listas separadas por comas en una columna de texto: eso es una tabla que falta
22
Lo que te llevas
- Entidad, atributo y relación se traducen a tabla, columna y clave foránea
- Toda tabla lleva clave primaria; UUID si creas datos sin conexión
timestamptz,texty enteros onumericpara dinero- Las restricciones protegen los datos aunque la app falle
- RLS se activa en la misma migración que crea la tabla
23
Hazlo ahora
Quince minutos, con tu modelo del módulo 2:
- Elige las tres tablas centrales de tu app
- Anota columnas, tipos y cuáles son
not null - Marca las claves foráneas, su
on deletey qué tablas llevan columna de dueño - Pídele a Claude Code el SQL y repásalo con las cinco comprobaciones
- Ejecútalo en tu proyecto de pruebas: «SQL Editor», «New Query», pegar y «Run»
En la clase 5 ese mismo SQL quedará guardado como migración.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026