Alterações de compatibilidade no MongoDB 7.0
Nesta página
Esta página descreve as alterações introduzidas no MongoDB 7.0 que podem afetar a compatibilidade com versões mais antigas do MongoDB.
O MongoDB 7.0 é uma versão principal, o que significa que ele é suportado tanto para o MongoDB Atlas quanto para sistemas on-premises. O MongoDB 7.0 inclui alterações introduzidas no MongoDB Rapid Releases 6.1, 6.2 e 6.3. Esta página descreve as alterações de compatibilidade introduzidas nessas Rapid Releases e no MongoDB 7.0.
Para saber mais sobre as diferenças entre as Rapid Releases e versões principais, consulte Versões do MongoDB .
Para obter detalhes sobre o downgrade do MongoDB 7.0, consulte Downgrade 7.0 para 6.0.7
Itens obsoletos
Obsoleto(a) | Descrição |
|---|---|
storageDetails | Descontinuado na versão 7.0. |
Monitoramento gratuito desativado
A partir do MongoDB 7.0, o monitoramento gratuito será desativado. Os seguintes itens não estão disponíveis:
cloud.monitoring.freeOpção de configuração--enableFreeMonitoringserver parameterdb.enableFreeMonitoring()comandodb.disableFreeMonitoring()comandosetFreeMonitoringcomando
Disponibilidade gerado de queryable encryption
A partir do MongoDB 7.0, o Queryable Encryption com queries de igualdade está geralmente disponível (GA). Melhorias no GA o tornam incompatível com o Queryable Encryption Public Preview, que não deve ser usado agora que a funcionalidade está GA.
Compatibilidade de servidores e drivers entre o Public Preview e o GA
Para usar a Queryable Encryption com queries de igualdade, o servidor MongoDB deve ser da versão 7.0 ou posterior e os drivers devem ser compatíveis com a versão 7.0. Se você ainda estiver usando o Queryable Encryption Public Preview incluído no MongoDB 6.x, o servidor deverá permanecer na versão 6.x e os drivers deverão ser compatíveis com a 6.x. Você não pode utilizar drivers compatíveis com MongoDB 6.x com um servidor 7.0 ou drivers compatíveis com 7.0 com um servidor 6.x. Tentar fazer isso resulta em um erro.
Para facilitar a atualização, os drivers MongoDB 7.0 podem descriptografar dados criados com drivers MongoDB 6.x. Para opções de atualização, consulte as seções a seguir.
Começar de novo (preferencialmente)
Se possível, crie novas coleções em vez de migrar aquelas produzidas com a pré-visualização pública de criptografia herdável no MongoDB 6.x:
Atualize o servidor MongoDB e drivers para o 7.0.
Configure uma nova coleção criptografada com um nome diferente da coleção anterior.
Insira novos dados ou uma versão não criptografada dos dados existentes se você tiver uma cópia local.
Solte a coleção anterior da versão 6.x.
Migração
Se você não puder usar novos dados ou não tiver uma versão não criptografada dos dados existentes:
Atualize o servidor MongoDB e os drivers para o 7.0
Utilizando um driver compatível com 7.0, consulte a coleção criptografada para descriptografá-la.
Salve a saída localmente.
Configure uma nova coleção criptografada e ingira os dados.
Aviso
As operações
mongoexportemongodumpnão descriptografam a coleção. Você deve consultar a collection de um driver para gerar os dados descriptografados.Os drivers compatíveis com o MongoDB 7.0 não podem executar queries de campos criptografados em dados criptografados com drivers compatíveis com o MongoDB 6.x. Para descriptografar dados, consulte um campo não criptografado ou consulte a coleção inteira.
Funcionalidades incompatíveis com versões anteriores
Os seguintes recursos da versão 7.0 não são compatíveis com versões anteriores do MongoDB. Para fazer downgrade do MongoDB 7.0 para uma versão anterior, remova dados que usam qualquer uma das seguintes funcionalidades:
Coleções com
encryptedFieldscom intervalo de índicesOs índices compostos de curingas requerem fCV 7.0 ou superior. Um pré-7.0
mongodnão iniciará se você estiver utilizando um ou mais índices de curinga compostos.Servidores de configuração que têm coleções com
changeStreamPreAndPostImageshabilitadoÍndices TTL secundários com filtros parciais em coleções de séries temporais
Coleções de séries temporais com parâmetros de cluster personalizados
Autenticação intra-nó
Iniciando no MongoDB 7.0, você pode configurar servidores para autenticar certificados X.509 como membros do cluster identificados por atributos ou valores de extensão. Você também pode substituir essa configuração para aceitar certificados alternativos durante uma atualização contínua.
Para fazer o downgrade para o MongoDB 6.0, execute o procedimento de rotação de certificados para remover a configuração net.tls.clusterAuthX509 e alternar os certificados de associação do cluster para aqueles com atributos DC, O e OU correspondentes.
Quando isso for concluído, você poderá fazer downgrade do cluster.
Série temporal
Remover índices TTL parciais de coleções de séries temporais.
Remova ou modifique coleções usando novos parâmetros de índice. Em alguns casos, você pode usar
collModpara alternar para configurações de granularidade herdadas, se não você precisar descartar a coleção antes de fazer downgrade.
Configuração de Cluster
As operações de parâmetro de setClusterParameter ativas impedem que a feature compatibility version (fCV) seja concluída corretamente.
Multimapa criptografado (EMM)
Remova as coleções que utilizam a opção de coleção encryptedFields antes de fazer o downgrade.
Índices curinga
Os índices compostos de curingas requerem fCV 7.0 ou superior. Um pré-7.0 mongod não iniciará se você estiver utilizando um ou mais índices de curinga compostos.
Comportamento de autenticação do token de acesso OIDC
A partir do MongoDB 7.0, somente um campo audience oidcIdentityProviders pode ser especificado para tokens de acesso do OIDC. Os campos audience com arrays vazios ou arrays de múltiplas strings são inválidos.
Para obter detalhes, consulte CamposoidcIdentityProviders.