Tipos de cota
A plataforma do Earth Engine tem vários limites de cota para garantir que os recursos sejam distribuídos de maneira justa entre os usuários. Como há muitos tipos diferentes de recursos disponíveis no Earth Engine (computação, armazenamento etc.), há muitos tipos diferentes de limites de cota.
A principal distinção entre os diferentes tipos de cota é se eles são ajustáveis. Para alguns tipos de cota, podemos mudar os limites por usuário ou por projeto, enquanto outros tipos são limites em todo o sistema que não podem ser alterados.
Limites de cota ajustáveis
Os limites a seguir se aplicam por projeto.
| Tipo da cota | Valor padrão (por projeto) |
|---|---|
| Máximo de solicitações simultâneas (endpoint padrão) | 40 solicitações simultâneas |
| Máximo de solicitações simultâneas (endpoint de alto volume) | 40 solicitações simultâneas |
| Taxa máxima de solicitações (por projeto) | 100 solicitações/s (6.000 solicitações/min) |
| Taxa máxima de solicitações (por conta) | 100 solicitações/s (6.000 solicitações/min) |
| Média de tarefas em lote simultâneas | 2 tarefas (em média) |
| Espaço máximo de armazenamento de recursos | 250 GB |
| Número máximo de recursos | 10.000 |
| Tempo de computação do Earth Engine (EECU-time) por dia em segundos | Ilimitado |
Solicitações interativas simultâneas
Cada projeto pode fazer solicitações interativas em paralelo, até um limite de cota. Se o limite for excedido, o Earth Engine vai retornar "HTTP 429: Too Many Requests" erros. Geralmente, esses erros são tratados pela biblioteca de cliente do Earth Engine, que envolve solicitações em espera exponencial, repetindo a consulta até que ela seja bem-sucedida. A biblioteca de cliente do Earth Engine vai repetir a solicitação até cinco vezes.
Para evitar receber esses erros 429, ative o armazenamento em cache do aplicativo, por exemplo, usando o memcache, para evitar consultas redundantes quando possível. Se você estiver usando uma versão mais antiga da biblioteca de cliente do Earth Engine que não repete consultas automaticamente ou se uma consulta ainda não for concluída após cinco tentativas, talvez seja necessário implementar uma espera exponencial em torno das solicitações.
Taxa de solicitações (QPS)
Além dos limites de simultaneidade, o Earth Engine limita a taxa de solicitações interativas no nível do projeto e do usuário. Essas configurações podem ser ajustadas no Console do Cloud.
Tarefas em lote simultâneas
As tarefas em lote são limitadas a uma pequena quantidade de paralelismo, porque usam mais recursos do que solicitações interativas.
Ao usar o Earth Engine para fins não comerciais, o número máximo de tarefas em lote que podem ser executadas simultaneamente é determinado pelo seu nível não comercial.
Ao usar o Earth Engine comercialmente, o número máximo de tarefas em lote que podem ser executadas simultaneamente é determinado pelo plano de preços, embora possa ser ainda mais reduzido definindo o limite de simultaneidade de tarefas em lote por projeto. Por padrão, o limite de simultaneidade de tarefas em lote em um projeto é definido como o máximo permitido pelo plano de pagamento configurado na conta de faturamento do projeto. Para conferir ou atualizar esse limite em um projeto, consulte a documentação da ferramenta de linha de comando tool.
Cota de armazenamento de recursos
Cada recurso do Earth Engine tem um tamanho de armazenamento de dados correspondente medido em bytes. Os recursos podem ser de propriedade de projetos do Cloud ou de indivíduos (recursos legados), e cada recurso é contabilizado no limite geral de armazenamento e contagem de recursos do proprietário do Earth Engine.
Para solicitar uma cota de armazenamento de recursos adicional para uso não comercial ou de pesquisa, consulte Uso não comercial ou de pesquisa.
EECU-time por dia
Se você quiser controlar os custos, limite a quantidade de EECU-time que um projeto pode consumir no Earth Engine por dia. Por padrão, essa cota é ilimitada. Os administradores de cota podem definir esse limite no Console do Cloud
filtrando a métrica de cota earthengine.googleapis.com/daily_eecu_usage_time. Depois de definida, essa cota acumula o EECU-time consumido por solicitações bem-sucedidas do Earth Engine de todos os usuários em um projeto. Quando a cota é excedida, as solicitações falham até que a cota seja redefinida no dia seguinte ou o limite seja aumentado. Consulte o guia
de controles de custos para mais detalhes sobre
como definir essa cota.
Limites de cota fixos
Esses tipos de limites de cota são definidos no nível da plataforma, portanto, não podem ser ajustados por usuário ou por projeto. É improvável que eles mudem significativamente ao longo do tempo.
Tempo de computação
Diferentes tipos de solicitações têm durações máximas diferentes, que são detalhadas em detalhe na documentação de ambientes de processamento.
Para receber ajuda na correção de erros de tempo limite, consulte o guia de depuração.
Consumo de memória por solicitação
Quando uma solicitação falha com "User memory limit exceeded", isso significa que o Earth Engine não conseguiu calcular a resposta dentro do consumo de memória permitido. A plataforma de computação EE tem uma quantidade finita de RAM disponível e, para garantir que o sistema permaneça estável, cada solicitação só pode usar uma determinada quantidade. A quantidade máxima de memória disponível depende do tipo de solicitação (por exemplo, mais para uma tarefa em lote do que para um bloco de mapa), mas esses são limites em todo o sistema.
Para receber ajuda na correção de erros de memória, consulte o guia de depuração.
Agregações
Ao processar solicitações do Earth Engine, separamos alguns tipos de subcomputações que sabemos que são computacionalmente intensivas. Essas subcomputações são chamadas de "agregações" e são tratadas de maneira especial no sistema EE. Os resultados das agregações são armazenados em cache para evitar a recompilação.
Agregações simultâneas
Para evitar a ramificação computacional descontrolada, limitamos o número de agregações que um usuário individual pode executar simultaneamente, e isso é imutável. Quando uma solicitação falha com "Too many concurrent aggregations", isso significa que o solicitante tinha muitas agregações em execução ao mesmo tempo.
Para receber ajuda na correção de erros de agregação simultânea, consulte o guia de depuração.
Resultados de agregação grandes
Quando uma solicitação falha com "Computed value too large", isso significa que a agregação retornou um resultado muito grande para caber no nosso cache. O limite de tamanho nos resultados calculados é de 100 MiB, e esse é um limite em todo o sistema.
Limites de importação de tabelas
Os limites de upload de tabelas são explicados no guia de importação de dados de tabelas.
Tamanho do payload da solicitação
Uma única consulta ao Earth Engine é limitada a 10 MB de tamanho. Esse limite geralmente só é excedido quando alguma parte grande de dados adicionais é incluída diretamente na consulta, como um arquivo de forma ou uma estrutura GeoJSON que foi incluída na consulta. Esses objetos precisam ser enviados e transformados em um recurso FeatureCollection e referenciados pelo código do recurso.
Tamanho da fila de tarefas
As tarefas que estão aguardando o agendamento (no estado READY) formam a "fila de tarefas". A fila de cada projeto aceita um máximo de 3.000 tarefas. Isso significa que não é possível ter mais de 3.000 tarefas no estado READY.
Limites de cota das funções raster do BigQuery
As cotas a seguir se aplicam a chamadas para o Earth Engine do BigQuery, como ao
usar a
ST_REGIONSTATS
função SQL.
| Tipo da cota | Valor padrão (por projeto) |
|---|---|
| Tempo de slot do BigQuery por dia | 1.260.000 segundos de slot (350 horas de slot) |
Tempo de slot do BigQuery por dia
A cota de tempo de slot do BigQuery por dia é uma cota personalizada que permite limitar a quantidade de tempo de slot que as funções raster do BigQuery podem consumir no Earth Engine em um determinado dia para um determinado projeto. A cota diária acumula o tempo total em todas as consultas, mesmo aquelas que falham. É possível conferir a cota no
Console do Cloud
na métrica earthengine.googleapis.com/bigquery_slot_usage_time, e o
valor pode ser ajustado para cima ou para baixo por um administrador de cota. Para aumentar o valor
acima do padrão, crie uma solicitação de aumento de cota
,
que será aprovada automaticamente. A mudança vai entrar em vigor em até 10 minutos.
Se você exceder essa cota, o BigQuery vai retornar a seguinte mensagem de erro:
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=_.
Depois que a cota for excedida, as chamadas ST_REGIONSTATS vão falhar até que a cota seja redefinida no dia seguinte ou o limite seja aumentado por um administrador.