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 curinga 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 compostos de curingas. 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 curinga.
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 $map $filter $reduce agregação, e. Você pode usar o novo arrayIndexAs campo para definir uma variável para armazenar o índice de um elemento de array. Você também pode usar a nova $$IDX variável de sistema de agregação para acessar o índice do elemento de array atual se arrayIndexAs omitir.
Se você criar uma regra de validação de exibição ou 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 do FCV para algo abaixo 8.3 de, primeiro eliminar os 2dsphere 4 índices da versão.
Funcionalidades incompatíveis com versões anteriores
As seções a seguir fornecem informações para remover funcionalidades incompatíveis com versões anteriores de seu sistema. Se você estiver fazendo o downgrade do MongoDB 8.3 para uma versão anterior, revise as seções a seguir para garantir que seu sistema seja executado 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 collections 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 constrói um documento maior que $facet o 100 limite de megabytes, o MongoDB retorna o ExceededMemoryLimit erro.
Em versões anteriores, os estágios que excedem o limite de memória retornam o código de 4031700 erro. Se você tiver aplicativos, drivers ou ferramentas que verifiquem explicitamente se 4031700 há, você poderá ajustar seu código para ExceededMemoryLimit reconhecer.
Números abaixo do normal em pipelines $convert
A partir do MongoDB,8.3 o servidor é capaz de analisar toda a gama de todos os números de ponto flutuante de precisão dupla 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.