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

Notas de versão para MongoDB 8.2

Aviso

MongoDB é incompatível com o kernel Linux 6.19 Através de 7.0.13

Devido a uma incompatibilidade entre certas versões do kernel Linux e a versão atualmente vendida do TCMalloc, a execução do MongoDB com uma versão do kernel Linux de 6.19 a 7.0.13 pode fazer com que o MongoDB trave. Para evitar essa falha, o MongoDB detecta essas versões do kernel e para durante a inicialização. Essa incompatibilidade afeta todos os pacotes do MongoDB, incluindo aqueles obtidos no website do MongoDB, um gerente de pacotes ou Docker.

A versão 7.0.14 e posterior do kernel do Linux resolve essa incompatibilidade. Para executar o MongoDB em um sistema afetado, atualize para a versão 7.0.14 ou posterior do kernel do Linux.

O MongoDB 8.2 é uma versão menor, o que significa que ele recebe suporte tanto para o MongoDB Atlas quanto para sistemas on-premises. O MongoDB 8.2 introduz melhorias incrementais dentro de um ciclo de lançamento de versão principal. O MongoDB 8.2 também inclui alterações introduzidas no MongoDB 8.1. Esta página descreve as alterações introduzidas na versão menor e no MongoDB 8.2.

Para saber mais sobre as diferenças entre as versões principais e secundárias, consulte Versões do MongoDB.

Importante

mongosync não é suportado no MongoDB 8.3.

Esta versão contém importantes melhorias de segurança e confiabilidade.

Problemas corrigidos:

  • SERVIDOR-123081 Lidar com especificação de índice wildcard composto em $_internalIndexKey

  • SERVIDOR-125872 Corrigir hash exponencial de soluções de query para InternalSchema*MatchExpression nós

  • servidor-126247 Valide corretamente $search.mergingPipeline como um campo somente interno

  • SERVIDOR-127280 Rejeitar sortBy baseados em expressão no analisador $linearFill

  • SERVIDOR-127357 Verifique se há campos from duplicados em DocumentSourceGraphLookup::createFromBson()

  • servidor-127566 Limite o fator de contenção que pode ser usado para campos FLE2

  • servidor-127661 Exigir autocommit quando startOrContinueTransaction for especificado

  • servidor-127694 Adicionar verificação de tipo para DBPointer

  • SERVIDOR-127737 Limite o número de blocos de metadados permitidos em um FLE2IndexedTextEncryptedValue

  • servidor-127831 Proibir usuários externos de executar comandos FLE2 com crudProcessed definido como verdadeiro

  • servidor-128198 Corrigir mongos killCursors para verificar a autorização em relação ao namespace do cursor em vez do namespace da solicitação

  • servidor-128316 Limitou a sugestão máxima de erro de digitação na pesquisa híbrida

  • servidor-128341 Corrigir uma falha do servidor causada pela classificação em uma expressão $meta

  • servidor-129103 Restringir subtipos BinData de destino em $convert e $constant/$literal

  • servidor-128362 Adicione uma verificação nula no valor de retorno em ocspClientCallback

  • SERVIDOR-128433 Impedir que clientes externos definam runtimeConstants.userRoles

  • SERVIDOR-128473 Corrija um uso após a liberação em $function causado por não chamar advanceGeneration() em argumentos BSON retidos

  • servidor-128494 Validar BSON externo em MultiBsonStreamCursor

  • servidor-128517 Adicione um tempo limite mínimo configurável para hello transmitíveis pré-autenticação para evitar um loop quente de valores maxAwaitTimeMS muito pequenos

  • servidor-128832 Proteger a criação de ImplScope ModuleLoader

  • SERVIDOR-127346 Fazer com que a atualização da sessão tenha prioridade de admissão kExempt

Importante

MongoDB 8.2.11 contém uma correção para CVE-2026-11933

Para obter as informações mais recentes sobre as atualizações de segurança do MongoDB, consulte Boletins de segurança do MongoDB.

Problemas corrigidos:

Importante

MongoDB 8.2.10 contém uma correção para:

Para obter as informações mais recentes sobre as atualizações de segurança do MongoDB, consulte Boletins de segurança do MongoDB.

Problemas corrigidos:

  • servidor-125063 Proibir o aninhamento de BSONColumn dentro de BSONColumn

  • servidor-123507 Predicados criptografados dentro de um pré-filtro $vectorSearch devem ser substituídos por espaços reservados de criptografia

  • servidor-124183 Limitar escopo de autenticação

  • SERVIDOR-124190 Proibir campo exchange agregado de clientes não internos

  • SERVER-123918 Validar runtimeConstants.userRoles em IDL

  • SERVER-123951 $_internalConvertBucketIndexStats não deve retornar PauseExecution na conversão de índice com falha

  • SERVIDOR-124031 Certifique-se de que Exchange::getTargetConsumer lide corretamente com MaxKey

  • servidor-123633 Corrigir o tratamento de campos com prefixo $- do usuário que colidem com metadados internos

  • SERVER-123370 A senha de query LDAP é logada quando definida por meio de setParameter

  • SERVIDOR-123440 GeometryCollection com polígono de enrolamento estrito causa falha na geração de chave de índice 2dsphere

  • servidor-124959 Validar limites de array de diferença de documento e $_internalApplyOplogUpdate BSON

  • SERVIDOR-122207 Melhor relatório de erros para falhas de MD5

Importante

MongoDB 8.2.9 contém uma correção para:

Para obter as informações mais recentes sobre as atualizações de segurança do MongoDB, consulte Boletins de segurança do MongoDB.

Problemas corrigidos:

Importante

MongoDB 8.2.7 contém uma correção para:

Para obter as informações mais recentes sobre as atualizações de segurança do MongoDB, consulte Boletins de segurança do MongoDB.

Importante

MongoDB 8.2.6 contém uma correção para:

Para obter as informações mais recentes sobre as atualizações de segurança do MongoDB, consulte Boletins de segurança do MongoDB.

Importante

MongoDB 8.2.4 contém uma correção para

Para obter as informações mais recentes sobre as atualizações de segurança do MongoDB, consulte Boletins de segurança do MongoDB.

Problemas corrigidos:

Importante

MongoDB 8.2.3 contém uma correção para CVE-2025-14847.

Para obter as informações mais recentes sobre as atualizações de segurança do MongoDB, consulte Boletins de segurança do MongoDB.

Problemas corrigidos:

Importante

MongoDB 8.2.2 inclui correções para CVE-2025-12893 e CVE-2025-14345.

Para obter as informações mais recentes sobre as atualizações de segurança do MongoDB, consulte Boletins de segurança do MongoDB.

Problemas corrigidos:

Importante

MongoDB 8.2.1 inclui uma correção para CVE-2025-13507.

Para obter as informações mais recentes sobre as atualizações de segurança do MongoDB, consulte Boletins de segurança do MongoDB.

Problemas corrigidos:

Importante

O MongoDB 8.2 inclui correções para CVE-2025-13643, CVE-2025-13644 e CVE-2026-1847.

Para obter as informações mais recentes sobre as atualizações de segurança do MongoDB, consulte Boletins de segurança do MongoDB.

O MongoDB 8.2 introduz melhorias de desempenho do MongoDB 8.1, incluindo, mas não limitado a:

  • sincronização inicial mais rápida.

  • Inserções em massa de séries temporais mais rápidas.

  • Custos reduzidos de multiplanejamento de query.

Observação

A quantidade de melhoria de desempenho pode variar dependendo da configuração de suas cargas de trabalho e instâncias do banco de dados .

A partir do MongoDB 8.2, se um documento contiver campos de coordenadas numéricas GeoJSON e legado , a geração de índice geoespacial priorizará as coordenadas GeoJSON.

Se seus documentos contiverem valores de coordenadas numéricas legado que precedem coordenadas GeoJSON e índices existentes dependerem deste comportamento, talvez seja necessário reconstruir seus índices geoespaciais.

Esta alteração pode exigir que você reconstrua índices geoespaciais se seus documentos contiverem valores de coordenadas numéricas legado que precedem coordenadas GeoJSON e índices existentes dependerem desse comportamento. Revise as queries geoespaciais para confirmar que retornam os resultados esperados.

O MongoDB 8.2 adiciona o parâmetro terminateSecondaryReadsOnOrphanCleanup, que controla se as operações de leitura de longa duração em nós secundários terminam automaticamente antes da exclusão do documento órfão após uma migração de chunk.

Por padrão, este parâmetro é definido como true. Se uma operação de leitura em um nó secundário começar antes das confirmações de migração de chunk, o MongoDB encerrará automaticamente a operação antes de excluir os documentos órfãos. Nas versões do MongoDB anteriores a 8.2, essas operações continuam sendo executadas após a exclusão de documento órfão e podem perder documentos silenciosamente sem retornar um erro.

Para suportar este novo comportamento, o valor padrão para orphanCleanupDelaySecs é agora 3600 (anteriormente 900).

A partir do MongoDB 8.2 (e 8.0.13, 7.0.26), as construções de índice durante o sincronização inicial usam 10% da RAM disponível por padrão. Você pode especificar uma porcentagem diferente de memória para o MongoDB usar com o parâmetro initialSyncIndexBuildMemoryPercentage.

Por padrão, a quantidade de memória disponível deve estar entre 200 MB e 16 GB, inclusive. Use os seguintes parâmetros para especificar diferentes limites mínimos e máximos para uso de memória:

A partir do MongoDB 8.2, o resultado$queryStats inclui as seguintes métricas em ticketsinadimplentes:

  • metrics.delinquentAcquisitions

  • metrics.totalAcquisitionDelinquencyMillis

  • metrics.maxAcquisitionDelinquencyMillis

O MongoDB considera um tíquete de execução inadimplente quando a aquisição leva muito tempo.

A partir do MongoDB 8.2, você pode configurar o tamanho do cache interno do WiredTiger usando uma nova opção baseada em porcentagem. Além das configurações existentes baseadas em gigabytes --wiredTigerCacheSizeGB e storage.wiredTiger.engineConfig.cacheSizeGB, agora você pode especificar o tamanho do cache como uma porcentagem da memória disponível com as opções --wiredTigerCacheSizePct e storage.wiredTiger.engineConfig.cacheSizePct.

A partir do MongoDB 8.2, um novo tipo de inconsistência RangeDeletionMissingShardKeyIndex é implementado. O tipo de inconsistência indica que existe uma coleção fragmentada que não tem um índice compatível com a chave de fragmento da coleção e que há pelo menos uma tarefa de exclusão de faixa restante para concluir.

A partir do MongoDB 8.2, você pode usar $currentDate com aggregate() para retornar a hora atual no servidor.

O estágio de agregação $currentOp agora inclui o campo versionContext, que fornece informações sobre a feature compatibility version (FCV) da operação.

serverStatus inclui os seguintes novos campos em sua saída:

A partir do MongoDB 8.2, os Resultados Explicativos dos estágios que são transferidos para o disco agora incluem métricas padronizadas em nomes de campo consistentes. Esta atualização fornece uma maneira mais unificada de acompanhar o uso do disco para operações de uso intensivo de memória.

Os novos campos incluem:

A partir do MongoDB 8.2, o comando validate e o método assistente db.collection.validate() retornam um novo campo repairMode que indica quais tipos de inconsistências de dados o comando validate tentou reparar, se detectado.

A partir do MongoDB 8.2, A configuração storage.wiredTiger.engineConfig.zstdCompressionLevel suporta valores negativos para compressão zstd rápida. Valores negativos fornecem velocidades de compressão e descompressão mais rápidas ao custo da taxa de compressão. O novo intervalo suportado é -7 a 22.

A partir do MongoDB 8.2, você pode espelhar seletivamente as operações de leitura para servidores específicos que precisam de seus caches aquecimentos marcando os nós para espelhamento de leitura. Ao contrário das leituras espelhadas gerais, o espelhamento de leitura direcionada permite direcionar nós ocultos e espelhar a partir de nós primários e secundários.

Você pode configurar leituras espelhadas direcionadas utilizando o campo targetedMirroring no parâmetro mirrorReads.

A partir do MongoDB 8.2, você pode ativar a limitação de taxa para conexões de entrada para preservar os recursos da CPU durante a sobrecarga. Quando ativado, você pode ver quando a taxa de conexões de entrada excede a taxa de estabelecimento de conexão especificada e configurar os parâmetros para especificar como o sistema do MongoDB lida com o excesso de conexões.

Você pode configurar a limitação de taxa usando os seguintes novos campos:

A partir do MongoDB 8.2.8, o comprimento da string que você fornece para chars está limitado a 4096 caracteres. Para obter detalhes, consulte Limitações $trim.

Aviso

As queries de prefixo, sufixo e substring estão em visualização pública

As queries de prefixo, sufixo e substring do Queryable Encryption estão disponíveis em visualização pública no MongoDB 8.2. Não habilite esses tipos de query em produção. A funcionalidade de visualização pública será incompatível com o recurso GA, e você terá que descartar todas as collections que habilitarem essas queries.

O MongoDB 8.2 permite ativar queries de prefixo, sufixo e substring em campos de string criptografados em collections habilitadas para Queryable Encryption . Para obter detalhes, consulte habilitar queries de substring e Expressões de agregação suportadas.

Para usar as queries de prefixo, sufixo ou substring do Public Preview com mongosh, você deve baixar separadamente a Biblioteca Compartilhada de Criptografia Automática 8.2 ou superior e, em seguida, especificar o caminho da biblioteca para mongosh usando a opção --cryptSharedLibPath.

Esta seção descreve problemas conhecidos no MongoDB 8.2 e seu status de resolução.

Na versão
Emitir
Status

8.2.4, 8.2.5

SERVIDOR-118428: as alterações em mongocryptd limitam o tamanho máximo das mensagens que mongocryptd podem receber em 16 KB. Os usuários podem encontrar esse problema ao enviar comandos maiores que 16 KB por meio da criptografia automática do lado do cliente (CSFLE) ou da Queryable Encryption.

Para evitar este bug, ignore estas versões ao atualizar mongocryptd o ou utilizar a biblioteca crypt_shared.

Não resolvido.

8.2.0

SERVIDOR-106469: os processos mongocryptd, mongod e mongos não iniciam no Windows quando iniciados com o argumento --logpath NUL. Uma dependência de terceiros não permite erroneamente o uso de NUL, resultando nesse caminho de arquivo de log impedindo que mongocryptd seja iniciado. Os drivers do MongoDB podem falhar ao iniciar mongocryptd com sucesso no Windows se --logpath NUL for especificado. O driver MongoDB .NET/C# usa --logpath NUL em sua configuração padrão e não conseguirá iniciar no Windows.

Você pode evitar o problema do driver .NET/C# mongocryptd das seguintes maneiras:

Estamos direcionando uma correção para esse problema no MongoDB 8.2.1.

8.2.0

SERVIDOR-109626: v8.2.0 introduz algumas regressões de desempenho de fluxo de mudança. Os aplicativos que dependem de change streams para o processamento de dados em tempo real podem sofrer uma degradação de desempenho de até 15% em comparação com a versão8.0.

Corrigido no MongoDB 8.2.1. Atualizando para 8.2.1 restaura o pré-8.2 alterar o comportamento do fluxo de alterações para os campos collectionUUID e updateDescription.disambiguatedPaths e remover a regressão de desempenho.

8.2.0

SERVER-110250: os usuários que executam operações de memória intensiva que exigem transferência de disco podem sofrer falhas no servidor se o número de consultas com transferência ativa exceder 1000. Para mitigar esse problema, aumente o valor spillWiredTigerSessionMax setParameter para um valor mais alto.

Estamos direcionando uma correção para esse problema no MongoDB 8.2.1.

A partir do MongoDB 8.2, os seguintes parâmetros do servidor estão disponíveis:

A seção a seguir descreve as alterações e as novas funcionalidades introduzidas no MongoDB 8.1.

O MongoDB 8.1 introduz melhorias de desempenho do MongoDB 8.0, incluindo, mas não limitado a:

  • Até 195% de taxa de transferência melhorada para inserções em massa de séries temporais.

  • Até 40% de taxa de transferência melhorada para queries de filtro de correspondência.

  • Até 20% de taxa de transferência melhorada para queries em documentos com arrays.

  • Até 10% de taxa de transferência melhorada para cargas de trabalho de leitura em cache.

  • Redução de até 5% no uso da CPU.

Observação

A quantidade de melhoria de desempenho pode variar dependendo da configuração de suas cargas de trabalho e instâncias do banco de dados .

A partir do MongoDB 8.1 (e 8.0.4), você pode usar setQuerySettings para adicionar comentários às configurações da query. Por exemplo, adicione um comentário que indique por que você adicionou configurações de query.

A partir do MongoDB 8.1, os seguintes acumuladores de agregação estão disponíveis:

A partir do MongoDB 8.1, os seguintes estágios de agregação estão disponíveis:

A partir do MongoDB 8.1, se um aplicação cliente se conectar ao mongos por meio de um balanceador de carga, os endereços IP e portas do computador cliente de origem e do balanceador de carga serão incluídos no registro de auditar . Você pode usar o registro para combinar um evento de auditar com o computador cliente de origem.

Para obter detalhes, consulte Mensagens de auditoria do esquema OCSF e Mensagens de auditoria do esquema mongo.

A partir do MongoDB 8.1, você pode acessar o UUID do cliente conectado atualmente por meio de connectionStatus.authInfo.UUID.

A partir do MongoDB 8.1 (e 8.0.5), se o espaço em disco estiver baixo, o MongoDB falha nas queries que são despejadas no disco.

A partir do MongoDB 8.1, algumas queries $geoNear que anteriormente falhavam com índices 2d ou 2dsphere ocultos agora serão bem-sucedidas. Em versões anteriores, algumas queries $geoNear costumavam falhar desnecessariamente com um erro IndexNotFound quando incluíam um índice oculto devido à confusão sobre qual índice usar.

A partir do MongoDB 8.1, a métrica durationMillis relatada em registros de queries lentas contabiliza o tempo gasto no processamento de autorização e na análise do comando. Como resultado, durationMillis reflete mais de perto a duração total do comando.

A partir do MongoDB 8.1, os seguintes tipos de inconsistência estão disponíveis:

A partir do MongoDB 8.1, você pode fazer referência a várias coleções criptografadas em um estágio $lookup.

Para saber mais, consulte:

A partir do MongoDB 8.1, se o $merge índice de suporte do estágio de agregação não for esparso, os campos especificados para a opção on poderão estar ausentes ou conter um valor nulo.

A partir do MongoDB 8.1, as estatísticas de query são coletadas e relatadas para comandos count e distinct. Para obter detalhes, consulte contagem de Forma de query de comando e Forma de query de comando distinta.

A partir do MongoDB 8.1, os seguintes parâmetros do servidor estão disponíveis:

A partir do MongoDB 8.1 (e 8.0.4, 7.0.14, 6.0.20), a seção indexStats da saída de comando serverStatus rastreia índices no estado prepareUnique.

O MongoDB 8.1 adiciona as seguintes métricas de status do servidor :

A partir do MongoDB 8.1, as mensagens de registro para queries lentas conterão novas métricas se a execução da query gravar arquivos temporários no disco. Essas métricas são prefixadas pelo estágio de execução da query que fez com que a query excedesse o limite de memória. Por exemplo, sortSpills indica o número de vezes que o estágio de classificação da execução da query gravou arquivos temporários no disco.

Métrica
Descrição

<executionPart>Spills

Número de vezes que o estágio de execução da query correspondente gravou arquivos temporários no disco

<executionPart>SpilledBytes

Tamanho, em bytes, da memória liberada ao escrever arquivos temporários no disco

<executionPart>SpilledDataStorageSize

Tamanho, em bytes, do espaço em disco usado para arquivos temporários

<executionPart>SpilledRecords

Número de registros gravados em arquivos temporários no disco

Para mais informações sobre escrever arquivos temporários no disco, consulte allowDiskUse().

A partir do MongoDB 8.1, o comando renameCollection e o método de shell correspondente, db.collection.renameCollection(), estão incluídos na API estável V1.

A partir do MongoDB 8.1, os resultados da explicação incluem estatísticas de execução para os estágios $search, $searchMeta e $vectorSearch.

Para saber mais, consulte:

A partir do MongoDB,8.1 você pode createSearchIndexes executar,, updateSearchIndex dropSearchIndexe para criar, modificar, eliminar e listar índices do $listSearchIndexes Atlas Search e índices do Atlas Vector Search em exibições padrão compatíveis que contêm apenas os seguintes estágios:

Você pode executar pipelines de agregação que contenham os estágios $search e $searchMeta em exibições que usam um índice de pesquisa. Você também pode executar agregação pipelines que contêm um estágio $vectorSearch em visualizações que contêm um índice de pesquisa vetorial.

Iniciando no MongoDB 8.1, o comando validate inclui especificações de índice no campo de saída validate.indexDetails.

A partir do MongoDB 8.1, você pode definir a opção validationAction do seu esquema como errorAndLog, na qual o MongoDB rejeita qualquer inserção ou atualização que viole os critérios de validação e registra o erro no arquivo de log mongod.

Para obter mais informações, consulte Escolher como lidar com documentos inválidos.

Importante

Versão de compatibilidade de recursos

Para atualizar para o MongoDB 8.2 a partir de uma implantação do 8.0 , a implantação do 8.0 deve ter featureCompatibilityVersion configurado como 8.0. Para verificar a versão:

db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

Para atualizar para o MongoDB 8.2, consulte as instruções de atualização específicas para o MongoDB deployment:

Se você precisar de orientação para atualizar para 8.2, os serviços profissionais do MongoDB oferecem suporte para ajudar a garantir uma transição tranquila, sem interrupção para seu aplicação MongoDB . Para saber mais, acesse Consultoria do MongoDB.

Para baixar o MongoDB 8.2, acesse a Central de downloads do MongoDB.

Importante

Versões menores podem não suportar algumas funcionalidades, incluindo migração em produção do Atlas ou mongosync. Se você precisar desses recursos, use uma versão principal.

O MongoDB suporta apenas downgrades de versão única. Você não pode fazer o downgrade para uma versão que esteja várias versões atrás da versão atual.

Por exemplo, você pode fazer downgrade de uma série 8.2para uma série 8.0. No entanto, não há suporte para desatualização adicional dessa implantação da série 8.0para uma implantação da série 7.0.

  • Downgrades binários não são permitidos para o MongoDB Community Edition.

  • Não é possível desatualizar o FCV de seus sistemas para ou de uma versão secundária do MongoDB.

  • Se você atualizar ou desatualizar o fCV do seu sistema, não poderá desatualizar sua versão binária do sistema Enterprise sem ajuda do suporte.