Puerta de calidad automatizada
Cinco controles antes de publicar una receta
Contrato de receta completo
La auditoría requiere una pregunta, un esquema de evento, SQL, un resultado de muestra, visualización, explicación, casos extremos, orientación del panel, orientación de alertas y lecturas relacionadas.
Política de declaración de solo lectura
Las consultas deben comenzar con SELECT o CON. La auditoría rechaza DDL y escribe palabras clave como CREATE, INSERT, UPDATE, DELETE, DROP, ALTER y MERGE.
Ejecución tipo DataFusion
Each schema becomes an empty Apache Arrow record batch. The query is planned and executed with Apache DataFusion 45.2.0, catching invalid columns, types, functions, and syntax.
Accesorios de navegador reproducibles
30 cross-category recipes also execute their complete synthetic input with DuckDB 1.3.2 and compare every expected result value within displayed precision.
Integridad de la página renderizada
La auditoría del sitio representa cada receta y verifica su estado, URL canónica, título, descripción, H1, datos estructurados y enlaces internos.
Lo que prueba el control de ejecución
La auditoría construye cada tabla documentada a partir de los nombres de los campos y los tipos de flechas que se muestran en la página de la receta. Registra un lote vacío en una nueva sesión DataFusion, ejecuta el SQL publicado exacto y falla si el motor rechaza el plan o la ejecución. Esto detecta campos mal escritos, operaciones incompatibles, funciones no admitidas, columnas ambiguas, intervalos mal formados y muchos errores de tipo de retorno sin requerir datos de producción.
La versión fijada es intencional. Los motores SQL evolucionan, por lo que una consulta no se etiqueta como compatible simplemente porque un dialecto similar la acepta. Cuando la aplicación actualiza DataFusion, la colección completa se vuelve a ejecutar antes de que cambie la versión documentada.
Copiar con seguridad no es seguro asumirlo
La consulta no puede conocer su definición de cuenta activa, pago recuperado, falla permanente del webhook o latencia aceptable. Cada receta nombra esas opciones para que los revisores puedan cambiarlas antes de que un panel o una alerta adquieran autoridad.
Revisión humana
Lo que todavía necesita juicio
Una tabla escrita vacía demuestra que una consulta se planifica y ejecuta; no prueba que una definición empresarial sea correcta.
Las filas y gráficos mostrados son ejemplos sintéticos deterministas. Muestran la forma del resultado y la interpretación prevista, no un punto de referencia o un resultado para el cliente.
Los umbrales, volúmenes mínimos, ventanas de tiempo, reglas de identidad, monedas y estados de terminales deben adaptarse al contrato de evento que los posee.
Los eventos tardíos, las entregas de proveedores duplicadas, los depósitos más recientes incompletos y los cambios de esquema pueden alterar los resultados reales incluso cuando el SQL es válido.
Contrato de equipamiento público
Cada receta publica un paquete JSON con su esquema escrito, filas de entrada ilustrativas, SQL exacto, resultado esperado determinista, versión del motor y notas de revisión. Un CSV expone el mismo resultado mostrado, mientras que un SVG estático hace que el gráfico de ejemplo sea indexable y reutilizable. La entrada compacta muestra nombres de campos y tipos JSON; deliberadamente no se presenta como un generador completo del resultado agregado.
el 30 recetas reproducibles van más allá: sus filas sintéticas completas se ejecutan en el área de juegos SQL del navegador y se comparan con los valores esperados. Otras entradas compactas siguen siendo demostraciones de esquemas, lo que evita que un pequeño dispositivo de enseñanza se confunda con un conjunto de validación estadística.
el laboratorio SQL conectado utiliza un conjunto de datos SaaS sintético y versionado por separado para que los alumnos puedan practicar uniones y definiciones comerciales de varias etapas sin confundir los datos de la lección con los puntos de referencia de producción.
Referencias del motor principal
Apache publica la documentación de actualización, función, tipo y sintaxis SQL autorizada. La referencia en vivo puede describir una versión más reciente que el objetivo de prueba fijado de Telemetry, por lo que las afirmaciones de compatibilidad en las páginas de recetas continúan mencionando la versión auditada exacta.
Validar una receta en su propio contrato de evento
Haga coincidir nombres y tipos de campos, envíe un pequeño dispositivo sintético que cubra las rutas de éxito y fracaso, inspeccione CTE intermedios, compare totales con entradas conocidas y documente la definición comercial final junto a la consulta guardada.