Artículo / Software industrial
SCADA/HMI

Trazabilidad SQL — un evento aunque se reintente la entrega

Identificá cada evento en su origen, separá captura y recepción y resolvé duplicados en la base de datos en lugar de depender de la interfaz.

Publicado: · ING-MC LAB
Un evento de origen repetido llega a una clave única y genera una sola fila en la base.
Diagrama original de recepción de eventos. La clave propuesta es un patrón de integración, no el contrato de un servicio desplegado.

El dispositivo envía un evento, el servidor lo guarda y se pierde la confirmación. El dispositivo reintenta. Si cada solicitud HTTP agrega una fila, una observación física se convierte en dos registros. La trazabilidad correcta comienza por identificar el evento, no por contar sus entregas.

Definí qué estás guardando

Una muestra de estado no equivale a una transición. “La máquina está en marcha” cada segundo constituye una serie de observaciones; “pasó de detenida a marcha” es un evento derivado de observaciones confiables. No contés muestras como arranques ni inventés transiciones durante un vacío de datos.

En un sistema de telemetría de ejemplo, identificá cada observación por device_id, boot_id y sequence. Usá otro identificador de correlación si varios eventos pertenecen a una transferencia o lote. Ninguno autentica al emisor: autorización e integridad se comprueban antes de insertar.

Asegurá la unicidad donde coinciden las escrituras

Este esquema didáctico es para SQLite. Otros motores necesitan revisar tipos y sintaxis de conflictos; no lo copiés sin cambios a SQL Server u Oracle.

CREATE TABLE telemetry_event (
  id INTEGER PRIMARY KEY,
  device_id TEXT NOT NULL,
  boot_id TEXT NOT NULL,
  sequence INTEGER NOT NULL CHECK (sequence >= 0),
  captured_at TEXT,
  received_at TEXT NOT NULL,
  quality TEXT NOT NULL,
  payload_json TEXT NOT NULL,
  UNIQUE (device_id, boot_id, sequence)
);

SQLite permite restricciones únicas y manejo dirigido de conflictos con UPSERT. La clave única evita depender de “consultar y después insertar”: dos solicitudes pueden superar esa consulta a la vez.

Pasá los valores mediante parámetros. No construyás SQL concatenando nombres de dispositivo, JSON o campos del usuario. La API de parámetros depende del driver empleado.

Separá repetición idéntica y repetición conflictiva

La primera llegada guarda el evento. Si vuelve la misma clave, compará el contenido validado contra la observación almacenada. Un payload idéntico es un reintento idempotente. Un contenido distinto con la misma clave es un conflicto que debe investigarse; no reemplaza el evento aceptado.

Si la aplicación considera equivalentes distintas representaciones JSON, normalizalas antes de comparar. Si exige igualdad byte por byte, documentá esa regla. Debe ser determinista y coherente entre autenticación, validación y tratamiento de replay.

Un INSERT OR IGNORE genérico es demasiado amplio: puede ocultar otra falla de integridad. Tratá específicamente la clave duplicada, comprobá la fila existente y respondé según el resultado real. Usá una transacción cuando varios cambios deban completarse juntos.

Conservá dos tiempos

captured_at describe la observación del origen; received_at, la llegada al servidor. Guardá UTC con un formato documentado. Si el reloj de origen no está sincronizado, dejá la captura ausente o marcada como estimada: no la sustituyás silenciosamente por recepción.

Un lote atrasado puede llegar después de una observación nueva. Reconstruí el orden de una sesión por secuencia; apoyate en captura solo cuando su calidad lo permita. El orden de recepción ayuda a diagnosticar transporte, pero no demuestra la cronología del proceso.

Probá fallas con pocos registros

Usá tres casos: inserción inicial, reintento idéntico y payload modificado bajo la misma clave. Agregá un reinicio con boot ID nuevo y secuencia cero: no debe chocar con la sesión previa. Probá después una transacción fallida y la reconexión con reintento.

Definí retención, índices y verificación de respaldo/restauración desde las necesidades reales del reporte. Abrir una conexión no prueba que el historial sea recuperable. Los ejemplos públicos no deben contener clientes, payloads de producción ni credenciales. La guía de telemetría explica por qué un duplicado no debe renovar la vigencia de la pantalla.