Profundidad, complejidad y coste de una consulta

Un cliente de GraphQL no pide un recurso: pide una forma. Y la misma dirección puede recibir una petición minúscula o una que recorra media base de datos, según lo que el cliente escriba dentro. Por eso el tamaño de la petición no dice nada del trabajo que provoca: hay que medir el trabajo, no el texto.

Se mide de tres maneras y conviene no confundirlas. La profundidad cuenta cuántos niveles se anidan desde la raíz; es la más fácil de calcular y se conoce antes de ejecutar nada. La complejidad o coste asigna un peso a cada campo —más a los que van a la base de datos o a un servicio externo, y multiplicado por el tamaño de la página que se pide— y suma; también se puede estimar antes de ejecutar. El número de nodos devueltos y el tiempo gastado solo se conocen mientras la operación corre o cuando ya terminó: sirven para cortar, no para evitar.

Abre el laboratorio y lee esquema-relaciones.txt. Hay una relación de muchos a muchos que se puede recorrer en los dos sentidos, y eso es lo que permite anidar sin final: se baja de una colección a sus elementos y desde cada elemento se vuelve a subir. Busca el campo que devuelve un tipo por el que la operación ya pasó.

Las notas del incidente dicen qué profundidad necesita de verdad la pantalla más anidada de la aplicación, y esa cifra se quedó en el documento de diseño en vez de llegar a la configuración. Toma esa cifra, no la del archivo de límites, y cuenta en registro-consultas-lentas.txt cuántas operaciones la superan.

En limites.conf hay cinco topes y un interruptor. Cuatro de los topes tienen un valor que corta algo; uno está declarado de forma que no corta nada, y es justamente el que se habría estimado antes de ejecutar la operación. El propio archivo explica en su comentario qué significa ese valor.

El equipo propone bajar el tope de tiempo de ocho segundos a tres. Es una medida de contención razonable y no es el arreglo: con tres segundos, la plataforma habría estado lenta tres segundos en vez de ocho. Lo que evita el daño es rechazar antes de empezar lo que se sabe que va a costar demasiado, y quitar del esquema la posibilidad de pedir colecciones sin límite.