Qué comprobar al dividir una importación grande en lotes

Mide más que el número de filas

Revisa tamaño en bytes, duración, número de peticiones y límites del proveedor. Una fila con adjuntos o muchas relaciones puede pesar más que cientos de fichas sencillas. Elige un tamaño inicial con una muestra representativa y observa errores y tiempo real. Microsoft Graph admite agrupaciones con un máximo documentado de peticiones, pero ese mecanismo no define el tamaño apropiado de cualquier importación ni convierte el grupo en una transacción universal.

Respeta las relaciones del conjunto

Separa cabeceras y líneas si el destino necesita que unas existan antes de las otras. Si hay dependencias internas, utiliza solo los mecanismos que ofrezca la API o ejecuta fases explícitas. No distribuyas al azar registros cuya aplicación requiere un orden de negocio. Identifica el lote, sus miembros y la versión de entrada, de modo que puedas explicar qué quedó dentro incluso si se interrumpe la ejecución.

Lee cada resultado individual

Relaciona respuesta y registro mediante una referencia, no por la posición en la respuesta si el contrato no garantiza orden. Graph documenta resultados individuales y posibles limitaciones dentro de un lote globalmente aceptado. Registra confirmados, rechazados e inciertos. Reintenta los elementos recuperables y respeta las esperas correspondientes; no vuelvas a enviar automáticamente todo el grupo. Si una operación depende de otra fallida, conserva ese motivo separado del error de sus propios datos.

Prueba límites y parciales antes de ampliar

Usa un lote con entradas válidas, una inválida y una dependiente, y provoca una respuesta perdida. Comprueba que cada elemento obtiene una salida visible y que la reanudación no repite confirmados. Mide memoria, duración y presión en el destino. Ajusta tamaño y concurrencia por separado: duplicar trabajadores además de duplicar filas por lote puede multiplicar la carga. Cierra la importación con totales por registro y por lote; comparar solo el número de grupos enviados deja ocultas pérdidas internas.

Fuentes y documentación

• Microsoft Graph: JSON batching — Cada subpetición tiene identidad y respuesta; agrupar no acredita éxito individual.
• Microsoft Graph: throttling — 429, Retry-After y errores individuales dentro de respuestas de lote.