Quote di Earth Engine

Tipi di quota

La piattaforma Earth Engine prevede 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 di risorse diversi (calcolo, spazio di archiviazione e così via), esistono molti tipi diversi di limiti di quota.

La distinzione principale tra i diversi tipi di quota è se sono regolabili. Per alcuni tipi di quota, possiamo modificare i limiti in base al singolo utente o 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 massimo di richieste simultanee (endpoint standard) 40 richieste simultanee
Numero massimo di richieste simultanee (endpoint a volume elevato) 40 richieste simultanee
Frequenza massima di richieste (per progetto) 100 richieste/s (6000 richieste/min)
Frequenza massima di richieste (per account) 100 richieste/s (6000 richieste/min)
Media delle attività batch simultanee 2 attività (in media)
Spazio di archiviazione massimo per le risorse 250 GB
Numero massimo di risorse 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 restituisce "HTTP 429: Troppe richieste" errori. In genere, questi errori vengono gestiti dalla libreria client di Earth Engine, che esegue il wrapping delle richieste in un backoff esponenziale, riprovando la query finché non va a buon fine. La libreria client di Earth Engine riprova 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 viene completata dopo cinque tentativi, potrebbe essere necessario implementare un backoff esponenziale intorno alle richieste.

Frequenza di richieste (QPS)

Oltre ai limiti di concorrenza, Earth Engine limita la frequenza delle richieste interattive a livello di progetto e utente. Queste impostazioni possono essere modificate in Cloud Console.

Attività batch simultanee

Le attività batch sono limitate a una piccola quantità di parallelismo, poiché utilizzano più risorse rispetto alle richieste interattive .

Quando utilizzi Earth Engine per scopi non commerciali, 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 potrebbe essere ulteriormente ridotto impostando il limite di simultaneità delle attività batch per progetto. Per impostazione predefinita, il limite di simultaneità delle attività batch in un progetto è impostato sul massimo consentito dal piano di 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 delle risorse

Ogni risorsa di Earth Engine ha una dimensione di archiviazione dei dati corrispondente misurata in byte. Le risorse possono essere di proprietà di progetti Cloud o di singoli utenti (risorse legacy) e ogni risorsa viene conteggiata rispetto al limite di Earth Engine del proprietario per lo spazio di archiviazione complessivo e il numero di risorse.

Per richiedere una quota di spazio di archiviazione delle risorse 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 in Cloud Console filtrando la metrica della quota earthengine.googleapis.com/daily_eecu_usage_time. Una volta impostata, questa quota accumula il tempo EECU consumato dalle richieste di Earth Engine riuscite di tutti gli utenti di un progetto. Quando la quota viene superata, le richieste non andranno a buon fine fino a quando la quota non verrà reimpostata il giorno successivo o il limite non verrà aumentato. Per maggiori 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 in base al singolo utente o 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 Ambienti di elaborazione.

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

Footprint della memoria per richiesta

Quando una richiesta non va a buon fine con "User memory limit exceeded", significa che Earth Engine non è riuscito a calcolare la risposta entro il footprint della memoria consentito. La piattaforma di calcolo EE ha una quantità finita di RAM disponibile e, per garantire la stabilità del sistema, ogni richiesta può utilizzare solo una determinata quantità. La quantità massima di memoria disponibile dipende dal tipo di richiesta (ad es. maggiore per un'attività batch rispetto a un riquadro della mappa), ma si tratta di limiti a livello di sistema.

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

Aggregazioni

Durante l'elaborazione delle richieste di Earth Engine, separiamo alcuni tipi di sotto-calcoli che sappiamo essere intensivi dal punto di vista computazionale. Questi sotto-calcoli sono chiamati "aggregazioni" e vengono gestiti in modo speciale nel sistema EE. I risultati delle aggregazioni vengono memorizzati nella cache per evitare di doverli ricalcolare.

Aggregazioni simultanee

Per evitare una proliferazione incontrollata dei calcoli, 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 "Too many concurrent aggregations", significa che il richiedente aveva troppe aggregazioni in esecuzione contemporaneamente.

Per assistenza nella 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 "Computed value too large", 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 e si tratta di 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 di dimensioni. Questo limite viene in genere superato solo quando un grande blocco di dati aggiuntivi viene incluso direttamente nella query, ad esempio uno shapefile o una struttura GeoJSON che è stata incorporata nella query. Questi oggetti devono invece essere caricati e trasformati in una risorsa FeatureCollection e a cui si fa riferimento tramite l'ID risorsa.

Lunghezza coda di attività

Le attività in attesa di essere pianificate (con 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à con stato READY.

Limiti di quota delle funzioni raster di BigQuery

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

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

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 non riuscite. Puoi visualizzare la quota in Cloud Console nella metrica earthengine.googleapis.com/bigquery_slot_usage_time e il valore può essere aumentato o diminuito da un amministratore delle quote. Per aumentare il valore rispetto al valore predefinito, crea una richiesta di aumento della quota, che verrà approvata automaticamente. La modifica dovrebbe diventare effettiva entro 10 minuti.

Se superi questa quota, BigQuery restituisce 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 fino a quando la quota non verrà reimpostata il giorno successivo o il limite non verrà aumentato da un amministratore.