Saltar al contenido principal

🧩 Recomendaciones para solucionar errores comunes en Salesforce

⚠️ Error System.LimitException: Too many query rows: 50001 en Salesforce (NPSP)

Cuando se produce el siguiente error durante una actualización masiva en Salesforce:

Apex script unhandled exception by user/organization: [ID_USUARIO]/[ID_ORGANIZACION]
System.LimitException: npsp:Too many query rows: 50001

Es importante seguir un conjunto de pasos para identificar la causa y aplicar soluciones efectivas. Este error ocurre cuando una transacción supera el límite de 50.000 filas retornadas por consultas SOQL en Apex.


🔍 1. Revisar el límite de filas de consulta

El mensaje Too many query rows: 50001 significa que una consulta ha devuelto más filas de las permitidas en una sola ejecución.

✅ Acciones:

  • Evaluar cuántos registros se están procesando en la operación masiva.
  • Reducir el tamaño del lote para evitar alcanzar el límite.

⚙️ 2. Modificar el tamaño del lote (batch size)

Salesforce permite configurar lotes de hasta 200 registros. Sin embargo, si hay automatizaciones como Flows o Process Builders, esto puede generar múltiples llamadas y superar fácilmente el límite de filas consultadas.

🔧 Recomendaciones:

  • Utilizar Data Loader o herramientas similares para configurar un batch size menor: 20, 30 o 50.
  • Probar con distintos valores hasta encontrar el óptimo que permita completar la operación sin errores.

🔁 3. Verificar Process Builders y Flujos activos

Los Process Builders y Flows pueden generar consultas y operaciones adicionales cuando se actualizan registros, aumentando el riesgo de alcanzar el límite de filas.

🛠️ Acciones sugeridas:

  • Identificar todos los flujos y procesos activos que afectan los objetos involucrados.
  • Desactivarlos temporalmente para validar si están contribuyendo al error.
  • Documentar qué automatizaciones se ejecutan durante la operación masiva.

🧮 4. Revisar Roll-Ups activos

Los roll-ups pueden ejecutarse automáticamente al modificar ciertos objetos, generando actualizaciones masivas en cascada.

📌 Pasos a seguir:

  • Identificar los roll-ups activos en los objetos afectados.
  • Evaluar si estas reglas están generando múltiples consultas indirectas.
  • Considerar desactivarlos temporalmente o reprogramar su ejecución.

📦 5. Evaluar configuración de lotes en NPSP

El paquete Nonprofit Success Pack (NPSP) posee configuraciones internas de procesamiento por lotes que también pueden influir en este error.

🔍 Acciones:

  • Revisar la configuración del batch size en NPSP.
  • Ajustarlo si se sospecha que está procesando más registros de lo necesario.

🖼️ Imágenes relacionadas

A continuación se presentan ejemplos visuales relacionados con la configuración y monitoreo de lotes:

error
error
error


✅ Conclusión

El error System.LimitException: Too many query rows: 50001 puede resolverse si se implementan medidas preventivas y correctivas como:

  • Reducir el tamaño de los lotes.
  • Identificar automatizaciones innecesarias o redundantes.
  • Ajustar configuraciones específicas del paquete NPSP.
  • Probar por etapas y monitorear los resultados.

🧠 Consejo final: Siempre realizar pruebas controladas antes de ejecutar operaciones masivas en producción.