Cuotas de Earth Engine

Tipos de cuotas

La plataforma de Earth Engine tiene una serie de límites de cuota para garantizar que los recursos se distribuyan de forma equitativa entre los usuarios. Como hay muchos tipos diferentes de recursos disponibles en Earth Engine (procesamiento, almacenamiento, etc.), hay muchos tipos diferentes de límites de cuota.

La distinción principal entre los diferentes tipos de cuotas es si son ajustables. Para algunos tipos de cuota, podemos cambiar los límites por usuario o por proyecto, mientras que otros tipos son límites de todo el sistema que no se pueden cambiar.

Límites de cuota ajustables

Los siguientes límites se aplican por proyecto.

Tipo de cuota Valor predeterminado (por proyecto)
Cantidad máxima de solicitudes simultáneas (extremo estándar) 40 solicitudes simultáneas
Máximo de solicitudes simultáneas (extremo de gran volumen) 40 solicitudes simultáneas
Tasa máxima de solicitudes (por proyecto) 100 solicitudes/s (6,000 solicitudes/min)
Porcentaje máximo de solicitudes (por cuenta) 100 solicitudes/s (6,000 solicitudes/min)
Promedio de tareas por lotes simultáneas 2 tareas (en promedio)
Espacio de almacenamiento máximo para recursos 250 GB
Cantidad máxima de recursos 10,000
Tiempo de procesamiento de Earth Engine (tiempo de EECU) por día en segundos Ilimitado

Solicitudes interactivas simultáneas

Cada proyecto puede realizar solicitudes interactivas en paralelo, hasta un límite de cuota. Si se supera el límite, Earth Engine devolverá errores "HTTP 429: Demasiadas solicitudes". Por lo general, estos errores los controla la biblioteca cliente de Earth Engine, que une las solicitudes en una retirada exponencial y vuelve a intentar la consulta hasta que se realiza correctamente. La biblioteca cliente de Earth Engine reintentará la solicitud hasta cinco veces.

Para evitar recibir estos errores 429, puedes habilitar el almacenamiento en caché para tu aplicación, por ejemplo, con memcache, para evitar consultas redundantes cuando sea posible. Si usas una versión anterior de la biblioteca cliente de Earth Engine que no reintenta las consultas automáticamente o si una consulta aún no se completa después de cinco reintentos, es posible que debas implementar la retirada exponencial en las solicitudes.

Tasa de solicitudes (QPS)

Además de los límites de simultaneidad, Earth Engine limita la tasa de solicitudes interactivas a nivel del proyecto y del usuario. Estos parámetros de configuración se pueden ajustar en la consola de Cloud.

Tareas por lotes simultáneas

Las tareas por lotes están limitadas a una pequeña cantidad de paralelismo, ya que usan más recursos que las solicitudes interactivas.

Cuando usas Earth Engine con fines no comerciales, la cantidad máxima de tareas por lotes que puedes ejecutar de forma simultánea se determina según tu nivel no comercial.

Cuando usas Earth Engine con fines comerciales, la cantidad máxima de tareas por lotes que puedes ejecutar de forma simultánea se determina según el plan de precios, aunque se puede reducir aún más si estableces el límite de simultaneidad de tareas por lotes por proyecto. De forma predeterminada, el límite de simultaneidad de tareas por lotes en un proyecto se establece en el máximo permitido por el plan de pago configurado en la cuenta de facturación del proyecto. Para ver o actualizar este límite en un proyecto, consulta la documentación de la herramienta de línea de comandos.

Cuota de almacenamiento de recursos

Cada recurso de Earth Engine tiene un tamaño de almacenamiento de datos correspondiente medido en bytes. Los recursos pueden ser propiedad de proyectos de Cloud o de personas físicas (recursos heredados), y cada recurso se descuenta del límite de Earth Engine de su propietario en cuanto al almacenamiento general y el recuento de recursos.

Para solicitar una cuota de almacenamiento de recursos adicional para uso no comercial o de investigación, consulta Uso no comercial o de investigación.

Tiempo de EECU por día

Si quieres controlar los costos, puedes limitar la cantidad de tiempo de EECU que un proyecto puede consumir en Earth Engine por día. De forma predeterminada, esta cuota es ilimitada. Los administradores de cuotas pueden establecer este límite en la consola de Cloud filtrando por la métrica de cuota earthengine.googleapis.com/daily_eecu_usage_time. Una vez establecida, esta cuota acumula el tiempo de EECU consumido por las solicitudes exitosas de Earth Engine de todos los usuarios de un proyecto. Cuando se supere la cuota, las solicitudes fallarán hasta que se restablezca la cuota al día siguiente o se aumente el límite. Consulta la guía de controles de costos para obtener más información sobre cómo establecer esta cuota.

Límites de cuota fijos

Estos tipos de límites de cuota se establecen a nivel de la plataforma, por lo que no se pueden ajustar por usuario o por proyecto. Es poco probable que cambien significativamente con el tiempo.

Tiempo de procesamiento

Los diferentes tipos de solicitudes tienen diferentes duraciones máximas, que se detallan en la documentación de los entornos de procesamiento.

Para obtener ayuda con la corrección de errores de tiempo de espera, consulta la guía de depuración.

Espacio en memoria por solicitud

Cuando una solicitud falla con el mensaje "Se excedió el límite de memoria del usuario", significa que Earth Engine no pudo calcular la respuesta dentro del espacio en memoria permitido. La plataforma de procesamiento de EE tiene una cantidad limitada de RAM disponible y, para garantizar que el sistema se mantenga estable, cada solicitud solo puede usar una cantidad determinada. La cantidad máxima de memoria disponible depende del tipo de solicitud (p.ej., más para una tarea por lotes que para una tarjeta de mapa), pero estos son límites de todo el sistema.

Para obtener ayuda con la corrección de errores de memoria, consulta la guía de depuración.

Agregaciones

Cuando se procesan las solicitudes de Earth Engine, separamos ciertos tipos de subcálculos que sabemos que requieren un uso intensivo de recursos de procesamiento. Estos cálculos secundarios se denominan "agregaciones" y se controlan de forma especial en el sistema de EE. Los resultados de las agregaciones se almacenan en caché para evitar que se vuelvan a calcular.

Agregaciones simultáneas

Para evitar la distribución computacional descontrolada, limitamos la cantidad de agregaciones que un usuario individual puede ejecutar de forma simultánea, y esto no se puede cambiar. Cuando una solicitud falla con el mensaje "Demasiadas agregaciones simultáneas", significa que el solicitante tenía demasiadas agregaciones en ejecución al mismo tiempo.

Para obtener ayuda con la corrección de errores de agregación simultánea, consulta la guía de depuración.

Resultados de agregación grandes

Cuando una solicitud falla con el mensaje "Computed value too large", significa que la agregación devolvió un resultado demasiado grande para caber en nuestra caché. El límite de tamaño de los resultados calculados es de 100 MiB, y este es un límite para todo el sistema.

Límites de importación de tablas

Los límites de carga de tablas se explican en la guía para importar datos de tablas.

Tamaño de la carga útil de la solicitud

Una sola consulta a Earth Engine está limitada a un tamaño de 10 MB. Por lo general, este límite solo se supera cuando se incluye directamente en la consulta algún dato adicional grande, como un archivo shapefile o una estructura GeoJSON que se intercaló en la consulta. En su lugar, estos objetos se deben subir y convertir en un recurso FeatureCollection, y se debe hacer referencia a ellos con el ID del activo.

Longitud de la lista de tareas en cola

Las tareas que esperan ser programadas (en el estado READY) forman la "lista de tareas en cola". La cola de cada proyecto admite un máximo de 3,000 tareas. Esto significa que no es posible tener más de 3,000 tareas en el estado READY.

Límites de cuota de las funciones de ráster de BigQuery

Las siguientes cuotas se aplican a las llamadas a Earth Engine desde BigQuery, como cuando se usa la función de SQL ST_REGIONSTATS.

Tipo de cuota Valor predeterminado (por proyecto)
Tiempo de ranura de BigQuery por día 1,260,000 segundos de ranura (350 horas de ranura)

Tiempo de ranura de BigQuery por día

La cuota de tiempo de ranura de BigQuery por día es una cuota personalizada que te permite limitar la cantidad de tiempo de ranura de BigQuery que las funciones de ráster de BigQuery pueden consumir en Earth Engine en un día determinado para un proyecto específico. La cuota diaria acumula el tiempo total de todas las consultas, incluso las que fallan. Puedes ver la cuota en la consola de Cloud en la métrica earthengine.googleapis.com/bigquery_slot_usage_time, y un administrador de cuotas puede ajustar el valor hacia arriba o hacia abajo. Para aumentar el valor por encima del valor predeterminado, crea una solicitud de aumento de cuota, que se aprobará automáticamente. El cambio debería aplicarse en un plazo de 10 minutos.

Si excedes esta cuota, BigQuery devolverá el siguiente mensaje de error:

From Earth Engine: Custom quota exceeded: Your usage exceeded the custom quota for'earthengine.googleapis.com/bigquery_slot_usage_time', which is adjustable by your administrator in the Google Cloud console: https://console.cloud.google.com/quotas/?project=_.

Una vez que se supere la cuota, las llamadas a ST_REGIONSTATS fallarán hasta que se restablezca la cuota al día siguiente o un administrador aumente el límite.