David · Data Architect
Consultas seguras
Las validaciones que pasa cada consulta antes de tocar tus datos: usuario de solo lectura, guardrail sobre el árbol sintáctico, dominios, valores parametrizados y sello de auditoría.
Antes de que una consulta toque tus datos pasa por varias capas de control. La primera y más importante no es de software: el usuario con el que David se conecta solo puede leer.
#Las capas de control
| Capa | Qué hace |
|---|---|
| Usuario de solo lectura | Tu base de datos rechaza cualquier escritura, aunque todo lo demás fallara. Lo crea tu equipo con los permisos mínimos. |
Solo SELECT | Se rechaza cualquier instrucción que modifique datos o estructura: INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE. |
| Filtros obligatorios | Cada consulta lleva el filtro de empresa o de unidad que corresponda, y un límite de filas. |
| Dominios | Cada subagente solo puede leer las tablas de su dominio (mínimo privilegio). |
| Reglas de la capa semántica | Uniones solo por relaciones definidas y agregación en el grano correcto. Ver duplicación silenciosa. |
| Límites | Tiempo máximo de ejecución y cantidad máxima de filas devueltas, para no afectar a tus sistemas. |
| Sello de auditoría | Hora, hash SHA-256 de la consulta y sus parámetros, versión de la capa semántica y linaje de tablas. Ver sello de auditoría. |
#El guardrail sobre el árbol sintáctico
Buscar palabras prohibidas en un texto es frágil: basta un comentario o un cambio de mayúsculas para engañarlo. David analiza cada consulta como un árbol sintáctico (AST) con un parser de SQL real y valida su estructura contra la capa semántica: qué sentencias hay, qué tablas y columnas toca, cómo se une y qué agrega.
Se aplica dos veces: sobre el SQL que compila el propio David y sobre cualquier SQL que se le entregue para validar. La consulta solo se ejecuta si el resultado es APPROVED.
#Códigos del guardrail
| Código | Qué bloquea |
|---|---|
MUTATION_BLOCKED | Cualquier sentencia que no sea SELECT: INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE. |
MULTIPLE_STATEMENTS | Más de una sentencia en la misma solicitud. |
TABLE_NOT_CERTIFIED | Una tabla que no está en la capa semántica. |
UNKNOWN_COLUMN | Una columna que no existe en su tabla certificada. |
OUT_OF_DOMAIN | Una tabla fuera del permiso del dominio que responde. |
CARTESIAN_JOIN | Joins implícitos por coma o CROSS JOIN (producto cartesiano). |
JOIN_WITHOUT_ON | Un join sin condición. |
JOIN_NOT_CERTIFIED | Un join por columnas que no están en el grafo certificado. |
UNSAFE_MULTI_JOIN_DUPLICATION | Agregar una tabla cruzando otra relación de uno a muchos: la duplicación silenciosa. |
TENANT_FILTER_MISSING | Falta el filtro obligatorio de empresa en una tabla que lo exige. |
LIMIT_MISSING | Falta LIMIT. |
PARSE_ERROR | SQL inválido: lo que no se puede analizar no se ejecuta. |
#Valores siempre parametrizados
El compilador nunca concatena valores en el SQL: fechas, filtros e identificadores de empresa viajan como parámetros separados. Así, un texto malicioso en una pregunta no puede convertirse en código SQL.
#Probar la validación
POST https://guren.cl/api/v1/david/demo/validate
Content-Type: application/json
{
"sql": "SELECT SUM(p.payment_value) FROM olist_orders o JOIN olist_order_items i ON o.order_id = i.order_id JOIN olist_order_payments p ON o.order_id = p.order_id LIMIT 10"
}{
"ok": false,
"status": "BLOCKED",
"issues": [
{
"code": "UNSAFE_MULTI_JOIN_DUPLICATION",
"message": "Agregar olist_order_payments cruzando olist_order_items (relación 1:N) duplica filas en silencio. Agrega cada hecho por separado (CTE) y luego une."
}
],
"schema": "olist-demo"
}Esta consulta suma pagos cruzando ítems y pagos de la misma orden: duplicaría filas en silencio. Una consulta segura responde 200 con "status": "APPROVED". Ver Referencia de la API.
#Qué ve cada persona
Los permisos se definen por rol: un gerente de sucursal ve su sucursal; finanzas ve la empresa completa. Si tu empresa ya administra roles en su proveedor de identidad (Google Workspace, Microsoft Entra ID u otro), los usamos como base en el diseño.