Clase 05 · Módulo 07
Diseñar datos que no se duplican
Diseñar datos que no se duplican
Qué logras en esta clase
Diseñas tablas que aguantan que un flujo corra dos veces sin cobrar, avisar ni guardar dos veces.
- Eliges un identificador único para cada dato.
- Haces que la base rechace el duplicado.
- Usas una columna de estado para saber qué falta.
- Separas el estado actual del historial.
02
Tu flujo va a correr dos veces
No es una posibilidad remota. La pregunta útil es qué pasa cuando ocurra.
03
Por qué se repite una ejecución
- Un servicio reenvía el mismo aviso porque no recibió respuesta a tiempo.
- Un nodo reintenta después de un error que en realidad sí guardó.
- Alguien vuelve a ejecutar a mano tras una falla a medio camino.
- Una persona envía el formulario dos veces.
- Un disparador relee elementos que ya había visto.
Ninguna de estas causas es un error tuyo. Todas son normales.
04
La meta tiene nombre: idempotencia
Una operación es idempotente cuando ejecutarla dos veces deja el mismo resultado que ejecutarla una.
05
Las tres piezas
| Pieza | Pregunta que responde |
|---|---|
| Identificador único | ¿Este dato ya lo tengo? |
| Columna de estado | ¿En qué etapa va? |
| Historial | ¿Qué pasó y cuándo? |
Con la primera evitas filas repetidas. Con la segunda, trabajo repetido. Con la tercera puedes reconstruir lo ocurrido cuando algo sale mal.
06
Elegir el identificador
Lo mejor es un identificador que ya traiga el origen:
| Origen | Identificador natural |
|---|---|
| Correo | Identificador del mensaje |
| Pago | Número de transacción |
| Tienda en línea | Número de pedido |
| Mensaje de un bot | Identificador del mensaje |
| Formulario | El que entregue la herramienta por cada envío |
Guárdalo en una columna propia, por ejemplo id_externo. El id automático de la tabla no sirve para esto: cambia en cada inserción.
07
Si el origen no trae identificador
Constrúyelo con campos que no cambian entre un envío y su repetición.
Normaliza antes de armar la clave: minúsculas y sin espacios sobrantes. «Ana@Correo.cl » y «ana@correo.cl» deben dar lo mismo.
08
Que la base lo haga cumplir
Una restricción de unicidad le prohíbe a la tabla tener dos filas con el mismo valor en una columna:
alter table pedidos
add constraint pedidos_id_externo_unico unique (id_externo);Se ejecuta una sola vez, desde el editor SQL de Supabase o con un nodo Postgres en Execute Query. Desde ese momento, el segundo intento falla en vez de duplicar.
09
Revisar antes de insertar no basta
Si dos ejecuciones preguntan al mismo tiempo «¿existe?», las dos reciben «no» y las dos insertan. La restricción sí lo impide.
10
Insertar solo si no existe
insert into pedidos (id_externo, correo, total)
values ($1, $2, $3)
on conflict (id_externo) do nothing
returning id;on conflict ... do nothing salta la fila repetida sin dar error. returning id devuelve el id solo cuando la fila se insertó de verdad.
Si la consulta no devuelve ninguna fila, el pedido ya existía y el flujo no debe seguir.
11
Insertar o actualizar
insert into pedidos (id_externo, correo, total)
values ($1, $2, $3)
on conflict (id_externo)
do update set total = excluded.total;excluded es la fila que intentabas insertar. Postgres garantiza que el resultado sea una inserción o una actualización, también con ejecuciones simultáneas.
Es lo que hace la operación Insert or Update del nodo. En ambos casos necesitas la restricción de unicidad en esa columna.
12
Cuál de los dos conviene
| Situación | Usa |
|---|---|
| El dato llega una vez y no cambia (un pago) | do nothing |
| El dato se corrige con el tiempo (ficha de cliente) | do update |
| Solo quieres saber si es nuevo para seguir | do nothing con returning |
13
La columna de estado
Cada fila dice en qué etapa va. El flujo solo toma las filas pendiente y, al terminar, las deja en listo o en error.
Es la misma idea de la cola de trabajo en Sheets (módulo 6), ahora con una base que hace cumplir las reglas.
14
Tomar una fila sin pisarse
update pedidos
set estado = 'en_proceso'
where id = $1 and estado = 'pendiente'
returning id;El where exige que siga pendiente. Si dos ejecuciones lo intentan, solo una obtiene el id de vuelta; la otra recibe vacío.
15
Lo que no se puede deshacer
Un correo enviado o un cobro hecho no se revierten. Marca la fila antes de la acción, no después.
16
El orden importa
| Orden | Si falla a mitad de camino |
|---|---|
Marcar en_proceso, enviar, marcar listo | Queda en en_proceso: no se envió dos veces, alguien revisa |
Enviar y luego marcar listo | Queda pendiente: la próxima ejecución envía de nuevo |
El primero puede dejar un envío sin hacer; el segundo, uno repetido. Para cobros y mensajes a clientes, casi siempre prefieres el primero y revisar a mano las filas atascadas.
17
Historial: una tabla que solo crece
El estado dice cómo está la fila hoy. El historial guarda cada cosa que pasó, en una tabla aparte:
pedido_id: a qué pedido corresponde.evento: qué ocurrió, por ejemplocorreo_enviado.detalle: lo necesario para entenderlo después.created_at: cuándo, automática.
18
Estado o historial
| Estado | Historial | |
|---|---|---|
| Dónde vive | Columna en la tabla principal | Tabla aparte |
| Cómo cambia | Se sobrescribe | Solo se agregan filas |
| Responde | ¿Qué falta por hacer? | ¿Qué pasó con este pedido? |
Para flujos simples basta el estado. Agrega historial cuando haya plata, reclamos posibles o varios pasos por fila.
19
La misma idea en cada almacén
| Almacén | Cómo evitas el duplicado | Garantía |
|---|---|---|
| Postgres | Restricción única y on conflict | La base lo impide |
| Tablas de n8n | Upsert o If Row Does Not Exist | Depende de que el flujo lo use siempre |
| Sheets | Agregar o actualizar por una columna clave | Ninguna si alguien pega filas a mano |
Mientras más abajo en la tabla, más depende de la disciplina y menos de una regla.
20
Errores comunes
- Crear la restricción cuando la tabla ya tiene duplicados: falla. Limpia primero.
- Armar la clave con la hora de ejecución: cada repetición genera una clave nueva.
- Dejar filas en
en_procesopara siempre, sin un flujo que avise de las atascadas.
21
Cómo probar que quedó bien
- Ejecuta el flujo con un dato de prueba.
- Ejecútalo de nuevo con exactamente el mismo dato.
- Cuenta las filas: debe haber una.
- Revisa cuántos mensajes salieron: debe ser uno.
- Corta el flujo a la mitad a propósito y vuelve a ejecutar.
Si en algún paso aparece una fila o un envío de más, falta una de las tres piezas.
22
Lo que te llevas
- Todo flujo se repite alguna vez: se diseña para eso.
- Cada dato lleva un identificador del origen en su propia columna.
- La restricción única es la que impide el duplicado, no la revisión previa.
- La columna de estado evita repetir acciones que no se deshacen.
- El historial solo crece y explica lo ocurrido.
23
Hazlo ahora
En 15 minutos, sobre la tabla pedidos:
- Agrega la restricción única a
id_externo. - En un nodo Postgres, usa Execute Query con el
insert ... on conflict do nothing returning idy parámetros. - Ejecuta dos veces con el mismo
id_externo. - Comprueba que la segunda vez no vuelve ningún
idy que la tabla tiene una sola fila. - Agrega un IF que solo deje seguir cuando llega
id.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026