Saltar al contenido
GUREN AI Docs

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.

Actualizado el

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

CapaQué hace
Usuario de solo lecturaTu base de datos rechaza cualquier escritura, aunque todo lo demás fallara. Lo crea tu equipo con los permisos mínimos.
Solo SELECTSe rechaza cualquier instrucción que modifique datos o estructura: INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE.
Filtros obligatoriosCada consulta lleva el filtro de empresa o de unidad que corresponda, y un límite de filas.
DominiosCada subagente solo puede leer las tablas de su dominio (mínimo privilegio).
Reglas de la capa semánticaUniones solo por relaciones definidas y agregación en el grano correcto. Ver duplicación silenciosa.
LímitesTiempo máximo de ejecución y cantidad máxima de filas devueltas, para no afectar a tus sistemas.
Sello de auditoríaHora, 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ódigoQué bloquea
MUTATION_BLOCKEDCualquier sentencia que no sea SELECT: INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE.
MULTIPLE_STATEMENTSMás de una sentencia en la misma solicitud.
TABLE_NOT_CERTIFIEDUna tabla que no está en la capa semántica.
UNKNOWN_COLUMNUna columna que no existe en su tabla certificada.
OUT_OF_DOMAINUna tabla fuera del permiso del dominio que responde.
CARTESIAN_JOINJoins implícitos por coma o CROSS JOIN (producto cartesiano).
JOIN_WITHOUT_ONUn join sin condición.
JOIN_NOT_CERTIFIEDUn join por columnas que no están en el grafo certificado.
UNSAFE_MULTI_JOIN_DUPLICATIONAgregar una tabla cruzando otra relación de uno a muchos: la duplicación silenciosa.
TENANT_FILTER_MISSINGFalta el filtro obligatorio de empresa en una tabla que lo exige.
LIMIT_MISSINGFalta LIMIT.
PARSE_ERRORSQL 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

demo pública · POST /api/v1/david/demo/validate
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"
}
respuesta 422
{
  "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.