Quote di Earth Engine

Tipi di quota

La piattaforma Earth Engine ha una serie di limiti di quota per garantire che le risorse siano distribuite equamente tra gli utenti. Poiché in Earth Engine sono disponibili molti tipi diversi di risorse (calcolo, archiviazione e così via), esistono molti tipi diversi di limiti di quota.

La distinzione principale tra i diversi tipi di quote è se sono regolabili. Per alcuni tipi di quota, possiamo modificare i limiti in base all'utente o al progetto, mentre altri tipi sono limiti a livello di sistema che non possono essere modificati.

Limiti di quota regolabili

I seguenti limiti si applicano a livello di progetto.

Tipo di quota Valore predefinito (per progetto)
Numero max richieste in parallelo (endpoint standard) 40 richieste in parallelo
Numero max richieste in parallelo (endpoint ad alto volume) 40 richieste in parallelo
Frequenza massima di richieste (per progetto) 100 richieste/s (6000 richieste/min)
Frequenza massima delle richieste (per account) 100 richieste/s (6000 richieste/min)
Media delle attività batch simultanee 2 attività (in media)
Spazio di archiviazione massimo per gli asset 250 GB
Numero massimo di asset 10.000
Tempo di calcolo di Earth Engine (tempo EECU) al giorno in secondi Illimitato

Richieste interattive simultanee

Ogni progetto può effettuare richieste interattive in parallelo, fino a un limite di quota. Se il limite viene superato, Earth Engine restituirà errori "HTTP 429: Troppe richieste". In genere, questi errori vengono gestiti dalla libreria client di Earth Engine, che esegue il wrapping delle richieste nel backoff esponenziale, riprovando la query fino a quando non viene eseguita correttamente. La libreria client di Earth Engine riproverà a inviare la richiesta fino a cinque volte.

Per evitare di ricevere questi errori 429, ti consigliamo di attivare la memorizzazione nella cache per la tua applicazione, ad esempio utilizzando memcache, per evitare query ridondanti quando possibile. Se utilizzi una versione precedente della libreria client di Earth Engine che non riprova automaticamente le query o se una query non è ancora stata completata dopo cinque tentativi, potrebbe essere necessario implementare il backoff esponenziale per le richieste.

Frequenza delle richieste (QPS)

Oltre ai limiti di contemporaneità, Earth Engine limita la frequenza delle richieste interattive a livello di progetto e di utente. Queste impostazioni possono essere modificate nella console Cloud.

Attività batch simultanee

Le attività batch sono limitate a un livello ridotto di parallelismo, poiché utilizzano più risorse rispetto alle richieste interattive.

Quando utilizzi Earth Engine in modo non commerciale, il numero massimo di attività batch che puoi eseguire contemporaneamente è determinato dal tuo livello non commerciale.

Quando utilizzi Earth Engine per scopi commerciali, il numero massimo di attività batch che puoi eseguire contemporaneamente è determinato dal piano tariffario, anche se può essere ulteriormente ridotto impostando il limite di concorrenza delle attività batch per progetto. Per impostazione predefinita, il limite di contemporaneità delle attività batch in un progetto è impostato sul valore massimo consentito dal piano a pagamento configurato nell'account di fatturazione del progetto. Per visualizzare o aggiornare questo limite in un progetto, consulta la documentazione dello strumento a riga di comando.

Quota di spazio di archiviazione degli asset

Ogni asset Earth Engine ha una dimensione di archiviazione dei dati corrispondente misurata in byte. Gli asset possono essere di proprietà di progetti cloud o di privati (asset legacy) e ogni asset viene conteggiato ai fini del limite di Earth Engine del proprietario per lo spazio di archiviazione complessivo e il conteggio degli asset.

Per richiedere una quota di spazio di archiviazione degli asset aggiuntiva per uso non commerciale o di ricerca, consulta Uso non commerciale o di ricerca.

Tempo EECU al giorno

Se vuoi controllare i costi, puoi limitare la quantità di tempo EECU che un progetto può consumare su Earth Engine al giorno. Per impostazione predefinita, questa quota è illimitata. Gli amministratori delle quote possono impostare questo limite nella console Cloud filtrando in base alla metrica della quota earthengine.googleapis.com/daily_eecu_usage_time. Una volta impostata, questa quota accumula il tempo EECU consumato dalle richieste Earth Engine andate a buon fine di tutti gli utenti di un progetto. Se la quota viene superata, le richieste non andranno a buon fine finché la quota non verrà reimpostata il giorno successivo o il limite non verrà aumentato. Per ulteriori dettagli sull'impostazione di questa quota, consulta la guida ai controlli dei costi.

Limiti di quota fissi

Questi tipi di limiti di quota sono impostati a livello di piattaforma, quindi non possono essere modificati per utente o per progetto. È improbabile che cambino in modo significativo nel tempo.

Tempo di calcolo

I diversi tipi di richieste hanno durate massime diverse, descritte in dettaglio nella documentazione sugli ambienti di elaborazione.

Per assistenza sulla correzione degli errori di timeout, consulta la guida al debug.

Footprint della memoria per richiesta

Quando una richiesta non va a buon fine con l'errore "Limite di memoria utente superato", significa che Earth Engine non è stato in grado di calcolare la risposta entro il footprint della memoria consentito. La piattaforma di calcolo di EE ha una quantità limitata di RAM disponibile e, per garantire che il sistema rimanga stabile, ogni richiesta può utilizzare solo una determinata quantità. La quantità massima di memoria disponibile dipende dal tipo di richiesta (ad esempio, maggiore per un'attività batch rispetto a un riquadro della mappa), ma si tratta di limiti a livello di sistema.

Per assistenza sulla correzione degli errori di memoria, consulta la guida al debug.

Aggregazioni

Durante l'elaborazione delle richieste di Earth Engine, separiamo alcuni tipi di calcoli secondari che sappiamo essere intensivi dal punto di vista computazionale. Questi sub-computations are called "aggregations," and they're handled specially in the EE system. I risultati delle aggregazioni vengono memorizzati nella cache per evitare ricalcoli.

Aggregazioni simultanee

Per evitare un fanout computazionale incontrollato, limitiamo il numero di aggregazioni che un singolo utente può eseguire contemporaneamente e questo limite non è modificabile. Quando una richiesta non va a buon fine con l'errore "Troppe aggregazioni simultanee", significa che il richiedente aveva troppe aggregazioni in esecuzione contemporaneamente.

Per assistenza sulla correzione degli errori di aggregazione simultanea, consulta la guida al debug.

Risultati di aggregazione di grandi dimensioni

Quando una richiesta non va a buon fine con l'errore "Valore calcolato troppo grande", significa che l'aggregazione ha restituito un risultato troppo grande per essere inserito nella nostra cache. Il limite di dimensioni per i risultati calcolati è di 100 MiB ed è un limite a livello di sistema.

Limiti di importazione delle tabelle

I limiti di caricamento delle tabelle sono spiegati nella guida all'importazione dei dati delle tabelle.

Dimensioni payload richiesta

Una singola query a Earth Engine è limitata a 10 MB. Questo limite viene solitamente superato solo quando alcuni dati aggiuntivi di grandi dimensioni vengono inclusi direttamente nella query, ad esempio uno shapefile o una struttura GeoJSON inserita in linea nella query. Questi oggetti devono invece essere caricati e convertiti in un asset FeatureCollection e referenziati tramite l'ID asset.

Lunghezza coda di attività

Le attività in attesa di essere pianificate (nello stato READY) formano la "coda di attività". La coda di ogni progetto supporta un massimo di 3000 attività. Ciò significa che non è possibile avere più di 3000 attività nello stato READY.

Limiti di quota per le funzioni raster di BigQuery

Le seguenti quote si applicano alle chiamate a Earth Engine da BigQuery, ad esempio quando utilizzi la funzione SQL ST_REGIONSTATS.

Tipo di quota Valore predefinito (per progetto)
Tempo di slot BigQuery al giorno 1.260.000 slot-secondi (350 slot-ore)

Tempo di slot BigQuery al giorno

La quota di tempo di slot BigQuery al giorno è una quota personalizzata che ti consente di limitare la quantità di tempo di slot che le funzioni raster di BigQuery possono consumare su Earth Engine in un determinato giorno per un determinato progetto. La quota giornaliera accumula il tempo totale di tutte le query, anche quelle che non vanno a buon fine. Puoi visualizzare la quota nella console Cloud nella metrica earthengine.googleapis.com/bigquery_slot_usage_time e il valore può essere modificato verso l'alto o verso il basso da un amministratore delle quote. Per aumentare il valore rispetto a quello predefinito, crea una richiesta di aumento della quota, che verrà approvata automaticamente. La modifica dovrebbe avere effetto entro 10 minuti.

Se superi questa quota, BigQuery restituirà il seguente messaggio di errore:

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 volta superata la quota, le chiamate ST_REGIONSTATS non andranno a buon fine finché la quota non verrà reimpostata il giorno successivo o il limite non verrà aumentato da un amministratore.