MySQL Read-Only para Dashboards

Guía práctica para consultas MySQL 5.6.x en dashboards Streamlit, enfocada en seguridad, rendimiento y diagnóstico.

Reglas Fundamentales

Parametrización

Usar placeholders estilo SQLAlchemy (:param). La capa de ejecución convierte a %(param)s cuando corresponde.

-- ✅ Correcto
SELECT * FROM vista WHERE id_operacion BETWEEN :op_ini AND :op_fin;

-- ❌ Incorrecto (interpolación directa)
SELECT * FROM vista WHERE id_operacion BETWEEN {op_ini} AND {op_fin};

Patrones de Consulta

Conteos por Estado

Usar COUNT(DISTINCT id) para contar entidades únicas cuando la vista tiene múltiples filas por entidad (ej: ítems por comanda).

SELECT
    COUNT(DISTINCT CASE WHEN estado = 'PENDIENTE' THEN id END) AS pendientes,
    COUNT(DISTINCT CASE WHEN estado = 'ANULADO' THEN id END) AS anulados,
    COUNT(DISTINCT CASE WHEN estado IS NULL THEN id END) AS sin_estado
FROM vista
WHERE id_operacion = :op;

Inspección de Detalle (Top N)

Siempre ordenar descendente y limitar para obtener los más recientes.

SELECT DISTINCT id
FROM vista
WHERE id_operacion = :op
  AND estado <> 'ANULADO'
ORDER BY id DESC
LIMIT 50;

Diagnóstico Vista vs Tabla Base

Cuando la vista muestra un valor diferente al esperado, comparar múltiples fuentes.

SELECT
    v.id,
    v.estado AS estado_vista,
    t.estado AS estado_tabla,
    CASE 
        WHEN v.estado = t.estado THEN 'OK'
        WHEN v.estado IS NULL AND t.estado IS NOT NULL THEN 'VISTA_NULL'
        WHEN v.estado IS NOT NULL AND t.estado IS NULL THEN 'TABLA_NULL'
        ELSE 'DIFERENTE'
    END AS diagnostico
FROM (
    SELECT id, MAX(estado) AS estado
    FROM vista
    WHERE id IN (/* lista de IDs */)
    GROUP BY id
) v
LEFT JOIN tabla_base t ON t.id = v.id
ORDER BY v.id DESC;

JOINs con Catálogos (parameter_table)

Siempre filtrar por id_master y estado='HAB' para evitar duplicados y registros deshabilitados.

-- ✅ Correcto
LEFT JOIN parameter_table pt
    ON pt.id = t.estado_id
   AND pt.id_master = 10
   AND pt.estado = 'HAB'

-- ❌ Incorrecto (puede traer duplicados o registros deshabilitados)
LEFT JOIN parameter_table pt
    ON pt.id = t.estado_id

Agregaciones Temporales

Para métricas por entidad (no por ítem), agrupar primero.

-- Timestamp único por entidad
SELECT
    id,
    MIN(fecha) AS primera_fecha,
    MAX(fecha) AS ultima_fecha
FROM vista
WHERE id_operacion = :op
GROUP BY id
ORDER BY ultima_fecha DESC
LIMIT 100;

Checklist Pre-Ejecución

Antes de considerar válido un resultado, verificar:

• • ¿Estoy consultando la base de datos correcta? (SELECT DATABASE())
• • ¿Estoy usando la vista correcta? (real-time vs histórico)
• • ¿La consulta respeta los filtros estándar? (operación o fechas)
• • ¿Los JOINs a catálogos filtran id_master y estado?
• • ¿Hay LIMIT si es inspección de detalle?
• • ¿Las agregaciones usan COUNT(DISTINCT id) cuando corresponde?

Errores Comunes

Rendimiento

• •Preferir agregaciones sobre COUNT(DISTINCT id) vs contar filas
• •Evitar ORDER BY sin LIMIT en vistas grandes
• •Para queries pesadas, ejecutar bajo demanda (checkbox/botón en UI)
• •En producción, evitar consultas de estructura (SHOW CREATE VIEW) durante operación

Interpretación de Estados NULL