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 diversi di risorse (calcolo, 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 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 possono essere modificati a livello di progetto. Consulta la pagina di assistenza per scoprire come richiedere una quota aggiuntiva.

Richieste interattive in parallelo

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 Earth Engine, che esegue il wrapping delle richieste in un backoff esponenziale, riprovando la query finché non va a buon fine. La libreria client Earth Engine riproverà 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 Earth Engine che non ripete automaticamente le query o se una query non viene ancora completata dopo cinque tentativi, potresti dover implementare un backoff esponenziale per le richieste.

Tasso 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 nella console Cloud.

Attività batch simultanee

I batch sono limitati a un piccolo grado di parallelismo, poiché utilizzano più risorse rispetto alle richieste interattive.

Quando utilizzi Earth Engine a scopi non commerciali, il numero massimo di attività batch che puoi eseguire contemporaneamente è impostato sul valore predefinito, a meno che non ti sia stato concesso un aumento della quota.

Quando utilizzi Earth Engine a fini 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 concorrenza delle attività batch in un progetto è impostato sul valore 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 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 l'archiviazione complessiva e il conteggio degli asset.

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 Earth Engine riuscite di tutti gli utenti di un progetto. Quando la quota viene superata, le richieste non andranno a buon fine fino al giorno successivo, quando la quota viene reimpostata o il limite viene aumentato. Per ulteriori dettagli sull'impostazione di questa quota, consulta la guida al controllo dei costi.

Posti utente

Quando utilizzi Earth Engine a fini commerciali, ogni livello di abbonamento include un numero di posti utente, anche se è possibile acquistare un numero di posti aggiuntivi.

Gli amministratori dei servizi devono acquistare un numero di posti per ospitare il numero di utenti di Code Editor all'interno di un determinato ciclo di fatturazione.

Domande frequenti

D: Chi viene conteggiato ai fini del calcolo dei posti?
R: Solo gli utenti umani distinti che utilizzano il calcolo di Earth Engine tramite l'editor di codice (visualizzazione dei riquadri della mappa, invio di query di calcolo e così via) vengono conteggiati ai fini del limite di posti.

D: Cosa succede se il numero di utenti cambia da un mese all'altro?
R: Le licenze non sono assegnate a persone specifiche, non sono slot nominativi. Se non superi il conteggio in un determinato mese, le identità dei singoli utenti non sono importanti.

D: Che cosa succede agli account di servizio?
R: Gli account di servizio sono esenti dal conteggio dei posti. Non vengono conteggiati come utenti umani che eseguono calcoli.

D: Cosa succede agli utenti che accedono a Earth Engine tramite Python?
R: Gli utenti che accedono a Earth Engine solo tramite l'API Python e non utilizzano l'editor di codice non vengono conteggiati ai fini dell'utilizzo dei posti. Il conteggio dei posti è legato all'utilizzo dell'editor di codice.

D: Dove vengono conteggiati i posti?
R: I conteggi dei posti vengono applicati a livello di account di fatturazione. Tutti gli utenti umani della tua organizzazione che utilizzano l'editor di codice contribuiscono al conteggio totale dei posti per il tuo account di fatturazione.

D: Che cosa succede se superiamo il limite di posti?
R: Monitoriamo le violazioni coerenti e applichiamo limiti a livello di account di fatturazione.

D: Come faccio ad acquistare più o meno utenze?
R: Per maggiori dettagli, consulta la pagina Prezzi di Earth Engine.

Limiti di quota fissi

Questi tipi di limiti di quota sono impostati a livello di piattaforma, pertanto non possono essere modificati in base all'utente o al 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 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 il messaggio "Limite di memoria utente superato", significa che Earth Engine non è riuscito a calcolare la risposta entro l'ingombro di memoria consentito. La piattaforma di calcolo EE ha una quantità finita 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 es. più per un'attività batch che per 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 computazionalmente intensivi. 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 il ricalcolo.

Aggregazioni simultanee

Per evitare una ramificazione computazionale incontrollata, 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 il messaggio "Troppe aggregazioni simultanee", 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 il messaggio "Valore calcolato troppo grande", significa che l'aggregazione ha restituito un risultato troppo grande per essere inserito nella nostra cache. Il limite di dimensione per i risultati calcolati è 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. Questo limite viene in genere superato solo quando nella query viene inclusa direttamente una grande quantità di dati aggiuntivi, ad esempio una struttura shapefile o GeoJSON incorporata nella query. Questi oggetti devono invece essere caricati e trasformati in una risorsa FeatureCollection e a cui fare riferimento tramite l'ID risorsa.

Lunghezza coda di attività

Le attività in attesa di essere pianificate (con stato READY) formano la "coda delle 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 delle funzioni raster di BigQuery

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

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 utilizzare 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 al di sopra del 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 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.