← TODOS LOS ARTÍCULOSARTÍCULO 007 / automatizacion

No pude leer no significa que esté vacío

Una búsqueda fallida puede devolver cero resultados junto con un error. Cómo evitar que una sincronización convierta esa falta de información en cambios destructivos.

Una búsqueda devolvió cero resultados. En la misma respuesta había un error: la herramienta no había podido recorrer los archivos. Si alguien miraba sólo el contador, podía concluir que no había nada para procesar.

El intento de lectura tampoco ayudaba a primera vista. Traía contenido vacío, pero no confirmaba que el archivo faltara. Una comprobación directa mostró una denegación de acceso.

La diferencia importa cuando esa lectura prepara una escritura. Si tomás un estado que no pudiste leer como un estado vacío, podés reconstruir un índice incompleto, reiniciar un punto de avance o reemplazar información que todavía existe. La falla inicial era de acceso; la pérdida de datos la agregaría la recuperación automática.

El vacío también necesita evidencia

Una lista vacía puede ser un resultado válido: la consulta terminó, cubrió el alcance esperado y no encontró elementos. Pero el mismo campo puede aparecer vacío porque la operación falló antes de buscar.

Conviene separar estos casos:

Observación Qué permite concluir
Lectura completa y válida, sin elementos El alcance consultado está vacío
Archivo ausente, confirmado por la operación Ese archivo no existe en esa ubicación
Acceso denegado Ese proceso no pudo observar el contenido
Lectura interrumpida o respuesta inválida No hay un resultado completo confiable

Ni siquiera la ausencia confirmada dice por sí sola que debas crear un estado nuevo. Un archivo obligatorio que desapareció puede indicar una ruta equivocada, un volumen sin montar o una eliminación accidental. El primer arranque tiene que ser una situación reconocida, no el nombre amable de cualquier error.

Cuando una herramienta devuelve datos y error por separado, leé ambos antes de actuar. total_count: 0 no anula un error de búsqueda. Un cuerpo vacío tampoco transforma una denegación en “archivo inexistente”.

Qué hacer cuando falta el estado anterior

La restricción era concreta: la operación necesitaba conocer el estado previo para decidir qué actualizar. Sin esa lectura, no podía distinguir lo ya procesado de lo pendiente.

Había varias salidas posibles. Continuar con valores por defecto mantenía la ejecución en marcha, pero inventaba un punto de partida. Buscar entradas nuevas y dejar el guardado para después podía servir en un sistema con una cola durable independiente; sin esa garantía, agregaba trabajo que no se sabía cómo reconciliar. Cambiar permisos para seguir exigía otra autorización y un diagnóstico que todavía no existía.

La decisión fue detener la sincronización antes de incorporar información nueva y registrar el bloqueo. No se intentó reconstruir el estado desconocido.

Esa decisión deja trabajo pendiente. También conserva la posibilidad de retomarlo desde el último estado válido, en vez de avanzar desde una suposición. Para un proceso incremental, suele ser preferible una demora visible a un salto silencioso.

Poder escribir un informe no prueba que puedas actualizar

Hubo una comprobación que podía confundir el diagnóstico: crear un informe nuevo sí funcionó. Después fue posible leerlo.

Eso probaba una capacidad acotada: escribir y leer ese archivo nuevo. No probaba que el proceso pudiera leer los archivos existentes, modificarlos o reemplazarlos. Las operaciones pueden tener permisos distintos, y las herramientas pueden ejecutarlas por caminos diferentes.

Por eso un chequeo como “puedo crear un archivo en esta carpeta” es insuficiente para declarar lista una sincronización. El chequeo previo debe parecerse a las operaciones que realmente necesita el trabajo:

  • leer y validar el estado anterior;
  • consultar las fuentes requeridas;
  • guardar el resultado por el mecanismo previsto;
  • confirmar el guardado antes de marcar el progreso.

No hace falta tocar datos reales para probar todo eso. Podés usar un entorno de ensayo autorizado y recursos de prueba. Pero una prueba de creación no debería presentarse como una prueba de actualización.

El punto de avance no es la hora del intento

Pensá en un ejemplo hipotético: un proceso recorre documentos y mantiene un índice. Guarda también un cursor que indica hasta dónde incorporó cambios.

Si el índice no puede leerse y el proceso mueve igual el cursor hasta el presente, el siguiente intento podría saltarse documentos que nunca incorporó. El cursor habría pasado a significar “hasta dónde intenté mirar”, aunque el resto del sistema lo interpreta como “hasta dónde quedó guardado”.

Separá esas dos cosas. El registro de intentos puede indicar que hubo una ejecución fallida. El punto de avance debe conservar el significado que usa la recuperación.

En un diseño simple, primero leés el estado válido, procesás un tramo, guardás sus resultados y recién entonces confirmás el avance. Si resultados y cursor viven en almacenes distintos, ese orden no alcanza para garantizar atomicidad: puede haber una caída entre ambas escrituras. Necesitás además una estrategia para repetir sin duplicar efectos, o un mecanismo transaccional adecuado.

Conservar el cursor evita dar por procesado lo desconocido. No resuelve por sí solo toda la recuperación.

Qué se comprobó y qué quedó abierto

El registro de la ejecución permite comprobar la denegación, los errores de las herramientas y la creación y lectura posterior del informe. También deja explícita la decisión de no continuar con la ingesta ni avanzar el cursor.

Eso tiene un límite: como el estado previo era inaccesible, no hubo una comparación independiente de su contenido antes y después. El registro de una decisión no equivale a una auditoría completa del almacenamiento. Tampoco demuestra que el problema de acceso se haya reparado o que una ejecución posterior haya terminado bien.

Para validar una implementación de este criterio, probá por separado estos escenarios en un entorno controlado:

  1. Una lectura válida sin elementos debe terminar como un caso vacío, si el contrato lo permite.
  2. Una lectura denegada debe producir un fallo visible, sin reemplazar el estado por valores iniciales.
  3. Una respuesta incompleta debe impedir que se marque como completo todo el tramo.
  4. Una falla de guardado debe impedir que el cursor dé por confirmado ese resultado.
  5. Un reintento debe recuperar lo pendiente sin duplicar los efectos ya persistidos.

Son pruebas recomendadas, no resultados de una suite ejecutada en este caso. Si el proceso permite avances parciales, necesitás comprobar además qué unidades quedaron confirmadas y cuáles siguen pendientes; no alcanza con un único “éxito” global.

Antes de agregar un valor por defecto a una lectura, revisá qué significa el error que estás ocultando. Si necesitás saber qué había para escribir correctamente lo que sigue, no poder leer es una condición para detenerse, no una colección vacía.

SEGUÍ LA PUBLICACIÓN

LA PRÓXIMA
IDEA.

Sumá Space Monkeys a tu lector RSS. Cada artículo nuevo aparece ahí, listo para leer cuando tengas un rato.

Abrir el feed