Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

Limitações do Atlas Stream Processing

Observação

Esta página se aplica tanto ao Atlas Infinite quanto ao Atlas Core.

As seguintes limitações se aplicam ao Atlas Stream Processing:

  • O Atlas Stream Processing suporta apenas o processamento pelo menos uma vez.

  • O Atlas Stream Processing não oferece suporte ao dimensionamento horizontal.

  • O Atlas Stream Processing usa um único núcleo para estágios de pipeline de transformação, exceto para estágios que podem especificar um valor parallelism.

  • Ao habilitar vertical autoscaling, você deve definir um maxTier de tier no processador ou como o tamanho máximo de tier do workspace de Stream Processing. Se nenhum dos dois for definido, o processador retornará um erro e não iniciará.

  • Não é possível configurar os limites de CPU e memória que trigger o escalonamento automático vertical. O Atlas Stream Processing gerencia esses limites internamente.

  • O state.stateSize de um processador de stream não pode exceder 80% da RAM disponível para seu pod. Por exemplo, o tamanho máximo de um processador de stream no nível SP30, que tem 8GB de RAM, é 6.4GB. Se o state.stateSize de qualquer um dos seus processadores de stream estiver se aproximando de 80% da RAM disponível, considere parar o processador e reiniciá-lo em um nível superior. Se o processador de stream processing já for executado no nível máximo habilitado para o espaço de trabalho de stream processing, considere ajustar a configuração do espaço de trabalho de stream processing para habilitar processadores de stream processing de nível superior.

    Quando um processador de fluxo ultrapassa o limite de 80% de RAM, ele falha com um erro Worker out of memory. Você pode ver o valor state.stateSize de cada processador de fluxo com o comando sp.processor.stats() . Veja Veja estatísticas de um processador de fluxo para saber mais.

  • Uma definição de pipeline do Atlas Stream Processing não pode exceder 16 MB.

  • Only users with the Organization Stream Processing Admin, Project Owner, Project Stream Processing Owner or Atlas admin roles can use Atlas Stream Processing.

  • You must use mongosh version 2.3.4 or later to override an option on an existing stream processor using a mongosh method. For example, using sp.processor.start() to specify a tier for the processor you are starting.

    Veja Desenvolver processadores de fluxo para saber mais sobre como gerenciar um processador de fluxo usando mongosh.

  • O Atlas Stream Processing é compatível com um subconjunto dos Estágios de Pipeline de agregação disponíveis no Atlas, permitindo que você execute muitas das mesmas operações em dados de streaming que você pode realizar em dados em repouso. Para obter uma lista completa dos estágios do pipeline de agregação compatíveis, consulte a documentação do Stream Aggregation.

  • O Atlas Stream Processing não aceita as variáveis de agregação $$NOW, $$CLUSTER_TIME, $$USER_ROLES e $SEARCH_META.

  • O Atlas Stream Processing não permite a gravação de documentos BSON maiores que 125 MB usando o estágio $emit em um bucket AWS S3.

  • O estágio $iceberg suporta um máximo de três transformações de partição no campo partitionedBy.

  • Para estágios Apache Kafka $source, se o tópico Apache Kafka que atua como $source para o processador em execução adicionar uma partição, o deslocamento inicial será determinado pela propriedade auto_offset_reset.

  • Para Apache Kafka $source os estágios estão sujeitos aos limites de partição do tier do workspace de Stream Processing. Se você exceder o limite de partição do seu tier de workspace de Stream Processing, o processador de fluxo afetado falhará. Você deve atualizar seu workspace de Stream Processing para oferecer suporte a partições adicionais.

  • O Atlas Stream Processing não oferece suporte à conexão a um consumidor Apache Kafka no mesmo grupo de consumidores que outros consumidores. Certifique-se de que qualquer consumidor Kafka usado com o Atlas Stream Processing seja executado em um grupo de consumidores dedicado.

  • Para conexões Apache Kafka, o Atlas Stream Processing atualmente aceita apenas os seguintes protocolos de segurança:

    • SASL_PLAINTEXT

    • SASL_SSL

    • SSL

    Para SASL, o Atlas Stream Processing suporta os seguintes mecanismos:

    • PLAIN

    • SCRAM-SHA-256

    • SCRAM-SHA-512

    • OAUTHBEARER

    SSLPara, você deve fornecer os seguintes ativos para a autenticação TLS mútua do seu sistema Apache Kafka com o Atlas Stream Processing:

    • uma Autoridade de certificação (se você estiver usando uma autoridade de certificação diferente da Apache Kafka CA padrão)

    • um certificado TLS do cliente

    • um arquivo de chave TLS, usado para assinar seu certificado TLS

  • initialSync doesn't support collections whose _id values are arrays, regular expressions, or undefined, which MongoDB doesn't support as _id values.

  • If your collection's _id values are default generated ObjectId values or ordered int or long values, initialSync achieves optimal performance. For other _id types, initialSync might take longer to complete because the values aren't stored in a predictable order. If the resume token is no longer on the oplog when initialSync completes, the processor enters a failed state to prevent data loss. To recover, restart the processor with resumeFromCheckpoint=false, which causes initialSync to run again. To learn more, see Checkpoints.

  • O Atlas Stream Processing pode inserir novos documentos em uma partição enquanto initialSync o copia. Uma falha de rede que interrompe uma query em uma partição crescente pode prolongar a fase de cópia da coleção.

  • initialSync pode inserir documentos duplicados se ler um evento de alteração durante a fase de cópia da coleção ou de sincronização. A garantia em processamento de pelo menos uma vez do Atlas Stream Processing cobre esse comportamento. Duplicatas são mais prováveis quando os valores _id da sua coleção não são valores ObjectId ou valores int ou long ordenados, porque a fase de cópia da coleção é executada por mais tempo e abrange mais eventos de alteração.

  • O Atlas Stream Processing oferece suporte a processadores de failover apenas para processadores com as seguintes configurações:

  • O Atlas Stream Processing oferece suporte a processadores de failover apenas para processadores de tier SP10 ou superior.

  • Um workspace de Stream Processing pode ter até duas regiões de failover. As regiões de failover devem usar o mesmo provedor de nuvem que a região padrão do workspace do Stream Processing. O Atlas Stream Processing não oferece suporte a failover entre nuvens.

  • Para processadores configurados com processadores de failover, apenas um processador pode estar ativo a qualquer momento. Você pode editar apenas o processador ativo.