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 mais informações, consulte Versão 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 rigorosas se aplicam às especificações wildcardProjection em índices wildcard. 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.
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.