Quotas Earth Engine

Types de quotas

La plate-forme Earth Engine applique un certain nombre de limites de quota pour garantir une répartition équitable des ressources entre les utilisateurs. Étant donné qu'il existe de nombreux types de ressources disponibles dans Earth Engine (calcul, stockage, etc.), il existe de nombreux types de limites de quota.

La principale distinction entre les différents types de quotas est qu'ils peuvent être ajustés. Pour certains types de quotas, nous pouvons modifier les limites par utilisateur ou par projet, tandis que d'autres sont des limites système qui ne peuvent pas être modifiées.

Limites de quota ajustables

Les limites suivantes peuvent être ajustées pour chaque projet. Pour savoir comment demander un quota supplémentaire, consultez la page d'aide.

Requêtes interactives simultanées

Chaque projet peut envoyer des requêtes interactives en parallèle, dans la limite d'un quota. Si la limite est dépassée, Earth Engine renvoie des erreurs HTTP 429: trop de requêtes. En général, ces erreurs sont gérées par la bibliothèque cliente Earth Engine, qui encapsule les requêtes dans un délai avant expiration exponentiel, et relance la requête jusqu'à ce qu'elle aboutisse. La bibliothèque cliente Earth Engine relance la requête jusqu'à cinq fois.

Pour éviter de recevoir ces erreurs 429, vous pouvez activer le cache pour votre application, par exemple à l'aide de memcache, afin d'éviter les requêtes redondantes lorsque cela est possible. Si vous utilisez une ancienne version de la bibliothèque cliente Earth Engine qui ne relance pas automatiquement les requêtes ou si une requête n'est toujours pas terminée après cinq nouvelles tentatives, vous devrez peut-être implémenter un intervalle exponentiel entre les requêtes.

Taux de requêtes (RPS)

En plus des limites de simultanéité, Earth Engine limite le débit des requêtes interactives au niveau du projet et de l'utilisateur. Vous pouvez ajuster ces paramètres dans la Cloud Console.

Tâches par lot simultanées

Les tâches par lot sont limitées à une faible quantité de parallélisme, car elles utilisent plus de ressources que les requêtes interactives.

Lorsque vous utilisez Earth Engine à des fins non commerciales, le nombre maximal de tâches par lot que vous pouvez exécuter simultanément est défini sur la valeur par défaut, sauf si vous avez bénéficié d'un quota supérieur.

Lorsque vous utilisez Earth Engine à des fins commerciales, le nombre maximal de tâches par lot que vous pouvez exécuter simultanément est déterminé par le forfait, mais il peut être encore réduit en définissant la limite de simultanéité des tâches par lot par projet. Par défaut, la limite de simultanéité des tâches par lot d'un projet est définie sur la valeur maximale autorisée par le forfait de facturation configuré sur le compte de facturation du projet. Pour afficher ou mettre à jour cette limite sur un projet, consultez la documentation de l'outil de ligne de commande.

Quota de stockage des composants

Chaque composant Earth Engine a une taille de stockage de données correspondante, mesurée en octets. Les éléments peuvent être la propriété de projets Cloud ou d'individus (anciens éléments). Chaque élément est comptabilisé dans la limite de stockage et d'éléments globaux d'Earth Engine de son propriétaire.

Licences utilisateur

Lorsque vous utilisez Earth Engine à des fins commerciales, chaque niveau d'abonnement est associé à un nombre d'utilisateurs, mais vous pouvez également acheter un nombre d'utilisateurs supplémentaires.

Les administrateurs de service doivent acheter un nombre de licences correspondant au nombre d'utilisateurs de l'Éditeur de code au cours d'un cycle de facturation donné.

Questions fréquentes

Q: Qui est comptabilisé comme un siège ?
A: Seuls les utilisateurs humains distincts qui effectuent des calculs Earth Engine à l'aide de l'éditeur de code (afficher des tuiles de carte, envoyer des requêtes de calcul, etc.) sont comptabilisés dans la limite de sièges.

Q: Que se passe-t-il si les utilisateurs changent d'un mois à l'autre ?
A: Les places ne sont pas attribuées à des personnes spécifiques. Il ne s'agit pas d'emplacements nommés. Tant que vous ne dépassez pas le nombre de connexions dans un mois donné, les identités individuelles des utilisateurs n'ont pas d'importance.

Q: Qu'en est-il des comptes de service ?
A: Les comptes de service ne sont pas comptabilisés dans le nombre de sièges. Ils ne sont pas comptabilisés comme des utilisateurs humains effectuant des calculs.

Q: Qu'en est-il des utilisateurs qui accèdent à Earth Engine via Python ?
A: Les utilisateurs qui n'accèdent à Earth Engine que via l'API Python et qui n'utilisent pas l'éditeur de code ne sont pas comptabilisés dans l'utilisation des sièges. Le nombre de sièges est lié à l'utilisation de l'éditeur de code.

Q: Où les places sont-elles comptabilisées ?
A: Le nombre de sièges s'applique au niveau du compte de facturation. Tous les utilisateurs humains de votre organisation qui utilisent l'Éditeur de code contribuent au nombre total de licences de votre compte de facturation.

Q: Que se passe-t-il si nous dépassons notre limite de places ?
A: Nous surveillons les cas de non-respect systématiques et appliquons des limites au niveau du compte de facturation.

Q: Comment acheter plus ou moins de licences ?
A: Consultez la page des tarifs d'Earth Engine pour en savoir plus.

Limites de quota fixes

Ces types de limites de quota sont définis au niveau de la plate-forme. Par conséquent, ils ne peuvent pas être ajustés par utilisateur ou par projet. Il est peu probable qu'elles changent de manière significative au fil du temps.

Durée de calcul

Les durées maximales des différents types de requêtes sont détaillées dans la documentation sur les environnements de traitement.

Pour obtenir de l'aide pour résoudre les erreurs de délai avant expiration, consultez le guide de débogage.

Espace mémoire utilisé par requête

Lorsqu'une requête échoue avec le message "Limite de mémoire utilisateur dépassée", cela signifie qu'Earth Engine n'a pas pu calculer la réponse dans l'espace mémoire autorisé. La plate-forme de calcul EE dispose d'une quantité limitée de RAM disponible. Pour que le système reste stable, chaque requête ne peut utiliser qu'une certaine quantité. La quantité maximale de mémoire disponible dépend du type de requête (par exemple, plus pour une tâche par lot que pour une tuile de carte), mais il s'agit de limites à l'échelle du système.

Pour obtenir de l'aide pour corriger les erreurs de mémoire, consultez le guide de débogage.

Agrégations

Lorsque nous traitons les requêtes Earth Engine, nous séparons certains types de sous-calculs que nous savons gourmands en calcul. Ces sous-calculs sont appelés "agrégations" et sont gérés de manière spéciale dans le système EE. Les résultats des agrégations sont mis en cache pour éviter tout nouveau calcul.

Agrégations simultanées

Pour éviter un fanage de calcul incontrôlé, nous limitons le nombre d'agrégations qu'un utilisateur individuel peut exécuter simultanément. Ce paramètre est non modifiable. Lorsqu'une requête échoue avec l'erreur "Trop d'agrégations simultanées", cela signifie que le demandeur a exécuté trop d'agrégations en même temps.

Pour obtenir de l'aide pour résoudre les erreurs d'agrégation simultanée, consultez le guide de débogage.

Résultats d'agrégation de grande envergure

Lorsqu'une requête échoue avec le message "Valeur calculée trop élevée", cela signifie que l'agrégation a renvoyé un résultat trop volumineux pour tenir dans notre cache. La limite de taille des résultats calculés est de 100 Mo. Il s'agit d'une limite à l'échelle du système.

Limites d'importation de tableaux

Les limites d'importation de tableaux sont expliquées dans le guide d'importation des données de table.

Taille de la charge utile de la requête

La taille d'une seule requête envoyée à Earth Engine est limitée à 10 Mo. Cette limite n'est généralement dépassée que lorsqu'une grande partie de données supplémentaires est incluse directement dans la requête, comme un fichier de forme ou une structure GeoJSON intégrée à la requête. Ces objets doivent plutôt être importés et transformés en élément FeatureCollection, puis référencés par l'ID de l'élément.

Longueur de la file d'attente des tâches

Les tâches en attente d'être planifiées (dans l'état READY) constituent la "file d'attente de tâches". La file d'attente de chaque projet peut contenir au maximum 3 000 tâches. Cela signifie qu'il n'est pas possible d'avoir plus de 3 000 tâches dans l'état READY.

Limites de quota des fonctions raster BigQuery

Les quotas suivants s'appliquent aux appels d'Earth Engine à partir de BigQuery, par exemple lorsque vous utilisez la fonction SQL ST_REGIONSTATS.

Heure d'emplacement BigQuery par jour

Le quota de temps d'emplacement BigQuery par jour est un quota personnalisé qui vous permet de limiter la quantité de temps d'emplacement que les fonctions de raster BigQuery sont autorisées à consommer sur Earth Engine un jour donné pour un projet donné. Vous pouvez afficher ce quota dans la console Cloud sous la métrique earthengine.googleapis.com/bigquery_slot_usage_time. La valeur peut être ajustée à la hausse ou à la baisse par un administrateur des quotas. Pour augmenter la valeur au-delà de la valeur par défaut, créez une demande d'augmentation de quota, qui sera approuvée automatiquement.

Si vous dépassez ce quota, BigQuery renvoie le message d'erreur suivant:

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=_.

Une fois le quota dépassé, les appels ST_REGIONSTATS échouent jusqu'à ce que le quota soit réinitialisé le jour suivant ou que la limite soit augmentée par un administrateur.