Cotas do Earth Engine

Tipos de cota

A plataforma 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, é possível mudar os limites por usuário ou por projeto, enquanto outros são limites em todo o sistema que não podem ser alterados.

Limites de cota ajustáveis

Os limites a seguir podem ser ajustados por projeto. Consulte a página de ajuda para saber como solicitar mais cota.

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 erros "HTTP 429: Too Many Requests". Em geral, esses erros são tratados pela biblioteca de cliente do Earth Engine, que encapsula solicitações em espera exponencial, repetindo a consulta até que ela seja bem-sucedida. A biblioteca de cliente do Earth Engine vai tentar fazer a solicitação até cinco vezes.

Para evitar receber esses erros 429, ative o armazenamento em cache no 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 novas 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

Tarefas em lote são limitadas a uma pequena quantidade de paralelismo, já que 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 é definido como o padrão, a menos que você tenha recebido um aumento de cota.

Ao usar o Earth Engine comercialmente, o número máximo de tarefas em lote que você pode executar simultaneamente é determinado pelo plano de preços, mas pode ser ainda reduzido ao definir 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.

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 pessoas físicas (recursos legados), e cada recurso é contabilizado no limite do Earth Engine do proprietário em relação ao armazenamento geral e à contagem de recursos.

Tempo de EECU por dia

Se você quiser controlar os custos, limite a quantidade de tempo de EECU 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 tempo de EECU consumido por solicitações do Earth Engine bem-sucedidas de todos os usuários em um projeto. Quando a cota é excedida, as solicitações falham até que ela 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.

Licenças por usuário

Ao usar o Earth Engine comercialmente, cada nível de assinatura vem com um número de licenças de usuário, mas também é possível comprar mais licenças.

Os administradores de serviços precisam comprar uma contagem de licenças para acomodar o número de usuários do Editor de código em um determinado ciclo de faturamento.

Perguntas frequentes

P: Quem é contabilizado como uma licença?
R:Somente usuários humanos distintos que usam a computação do Earth Engine com o Editor de código (visualizar blocos de mapa, enviar consultas de computação etc.) são contabilizados para o limite de assentos.

P: E se os usuários mudarem de um mês para o outro?
R:As licenças não são alocadas para pessoas específicas, ou seja, não são slots nomeados. Desde que você não exceda a contagem em um determinado mês, as identidades individuais dos usuários não importam.

P: E as contas de serviço?
R:As contas de serviço não são contabilizadas. Elas não são contabilizadas como usuários humanos que realizam computação.

P: E os usuários que acessam o Earth Engine pelo Python?
R:Os usuários que acessam o Earth Engine apenas pela API Python e não usam o editor de código não são contabilizados no uso de licenças. As contagens de assentos estão vinculadas ao uso do Code Editor.

P: Onde os assentos são contabilizados?
R:As contagens de assentos são aplicadas no nível da conta de faturamento. Todos os usuários humanos da sua organização que usam o Editor de código contribuem para o número total de licenças da sua conta de faturamento.

P: O que acontece se excedermos o limite de assentos?
R:Monitoramos violações consistentes e aplicamos limites no nível da conta de faturamento.

P: Como faço para comprar mais ou menos licenças?
R:Consulte a página de preços do Earth Engine para mais detalhes.

Limites de cota fixos

Esses tipos de limites de cota são definidos no nível da plataforma e, portanto, não podem ser ajustados por usuário ou projeto. É improvável que eles mudem significativamente com o tempo.

Tempo de computação

Diferentes tipos de solicitações têm durações máximas diferentes, que são detalhadas 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 da área de memória permitida. A plataforma de computação do EE tem uma quantidade finita de RAM disponível. 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 ser computacionalmente intensivas. Esses subcálculos são chamados de "agregações" e são processados de maneira especial no sistema EE. Os resultados das agregações são armazenados em cache para evitar o recálculo.

Agregações simultâneas

Para evitar o fanout computacional descontrolado, limitamos o número de agregações que um usuário individual pode executar simultaneamente, e isso não pode ser mudado. Quando uma solicitação falha com "Muitas agregações simultâneas", 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", 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 para importar 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 uma grande parte de dados adicionais é incluída diretamente na consulta, como um shapefile ou uma estrutura GeoJSON que foi inserida na consulta. Em vez disso, esses objetos precisam ser enviados e transformados em um recurso FeatureCollection, referenciado pelo ID do recurso.

Tamanho da fila de tarefas

As tarefas que estão aguardando programação (no estado READY) formam a "fila de tarefas". A fila de cada projeto aceita no máximo 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 às chamadas para o Earth Engine do BigQuery, como ao usar a função SQL ST_REGIONSTATS.

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 projeto específico. A cota diária acumula o tempo total em todas as consultas, mesmo as que falham. É possível conferir a cota no Console do Cloud na métrica earthengine.googleapis.com/bigquery_slot_usage_time. O valor pode ser ajustado para cima ou para baixo por um administrador de cotas. Para aumentar o valor acima do padrão, crie uma solicitação de aumento de cota, que será aprovada automaticamente. A mudança deve 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=_.

Quando a cota é excedida, as chamadas ST_REGIONSTATS falham até que ela seja redefinida no dia seguinte ou o limite seja aumentado por um administrador.