Importante
MongoDB 8.3 é a versão menor mais recente. A partir do MongoDB 8.2, versões secundárias estão disponÃveis para implantações locais (Community e EA) para casos de uso especÃficos. Para obter mais informações, consulte a seção Versões do MongoDB.
Para instalar a versão mais recente do MongoDB compatÃvel com uso local, consulte as instruções de instalação.
Esta página descreve as alterações introduzidas no MongoDB 8.3 que podem afetar a compatibilidade com versões mais antigas do MongoDB.
Indexes
Validação de Ãndice wildcard mais rigorosa
A partir do MongoDB 8.3 (e 8.2.4, 8.0.18, 7.0.29), regras de validação mais rÃgidas se aplicam à s especificações wildcardProjection em Ãndices wildcard compostos. Os Ãndices existentes que não atendem aos novos requisitos de validação continuam a funcionar, mas você não pode criar novos Ãndices que não atendam a esses requisitos.
Para obter detalhes completos sobre as regras de validação, consulte Restrições do Ãndice wildcard.
Alterações gerais
Acessando Ãndices de elementos de array em $map, $filter e $reduce
O MongoDB 8.3 melhora o acesso aos Ãndices dos elementos de array nas expressões de agregação $map, $filter e $reduce. Você pode usar o novo campo arrayIndexAs para definir uma variável para armazenar o Ãndice de um elemento de array. Você também pode usar a nova variável de sistema de agregação $$IDX para acessar o Ãndice do elemento de array atual se omitir arrayIndexAs.
Se você criar uma exibição ou regra de validação de coleção que use o novo recurso de Ãndice de elemento de array, deverá atualizar ou remover a exibição ou regra antes de fazer o downgrade do MongoDB 8.3 para uma versão anterior.
2dsphereIndexVersion
A partir do MongoDB 8.3, 2dsphereIndexVersion está definido para a versão 4 por padrão.
Se você precisar fazer o downgrade da versão de compatibilidade do recurso para algo abaixo de 8.3, primeiro descartar os Ãndices 2dsphere da versão 4.
Capacidade de query representativa em configurações de query
A partir do MongoDB 8.3, a capacidade de armazenamento para queries representativas em configurações de query é maior do que o limite do documento 16 MB BSON original. Se você fizer o downgrade para uma versão que não ofereça suporte à capacidade maior, o limite será revertido para 16 MB e o MongoDB poderá perder algumas queries representativas.
Para saber como o MongoDB preenche queries representativas, consulte setQuerySettings.
Funcionalidades incompatÃveis com versões anteriores
As seções a seguir fornecem informações para remover recursos incompatÃveis com versões anteriores de sua implantação. Se você estiver fazendo o downgrade do MongoDB 8.3 para uma versão anterior, revise as seções a seguir para garantir que sua implantação seja executada corretamente após o downgrade.
Expressões em Visualizações
Se você criou visualizações que usam expressões introduzidas no MongoDB 8.3, essas visualizações podem parar de funcionar depois que você fizer o downgrade para uma versão que não ofereça suporte a essas expressões.
Se você precisar fazer o downgrade do 8.3, deverá primeiro atualizar ou descartar todas as visualizações que dependam de expressões não suportadas na versão de destino.
Parâmetros e variáveis em visualizações e validadores
Se você criou visualizações ou validadores de coleção que usam parâmetros ou variáveis introduzidas no MongoDB 8.3, esses objetos podem falhar na validação ou avaliação após o downgrade.
Se você precisar fazer o downgrade do 8.3, deverá primeiro atualizar ou remover quaisquer visualizações ou validadores que façam referência a parâmetros ou variáveis não suportadas na versão de destino.
Coleções validadas
O MongoDB 8.3 pode marcar collections como validadas usando uma nova semântica de validação que não é compatÃvel com versões anteriores a 8.3. Se você tentar fazer o downgrade enquanto existirem coleções validadas, o downgrade falhará.
Se você precisar fazer o downgrade de 8.3, deverá primeiro alterar as coleções validadas para um nÃvel de validação compatÃvel com a versão de destino ou descartar essas coleções.
$ faceta Código de erro de limite de memória
A partir do MongoDB 8.3, quando um estágio $facet constrói um document maior que o limite 100 de megabytes, o MongoDB retorna o erro ExceededMemoryLimit.
Em versões anteriores, os estágios que excedem o limite de memória retornam o código de erro 4031700. Se você tiver aplicativos, drivers ou ferramentas que verifiquem explicitamente se há 4031700, você poderá ajustar seu código para reconhecer ExceededMemoryLimit.
Números abaixo do normal em pipelines $convert
A partir do MongoDB 8.3, o servidor é capaz de analisar toda a faixa de todos os números de double de ponto flutuante de precisão representáveis. Isso inclui números subnormais em que o dÃgito mais significativo tem zeros à esquerda e o expoente tem o menor valor possÃvel. Nas versões anteriores do MongoDB, o servidor retorna um erro quando você tenta analisar esses números.
Para obter detalhes, consulte Números subnormais.
Configurações da Janela do Balanceador
Quando você faz o downgrade do MongoDB 8.3 para uma versão anterior, a configuração activeBalancerWindowDOW não está disponÃvel. No downgrade, o balanceador usa como padrão a configuração activeWindow.
Nenhuma etapa manual de downgrade é necessária, mas quaisquer configurações personalizadas de dia da semana (DOW) feitas no 8.3 não se aplicam após o downgrade.