Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ /

Alterações de compatibilidade no MongoDB 7.0

Nesta página

  • Itens obsoletos
  • Monitoramento gratuito desativado
  • Disponibilidade gerado de queryable encryption
  • Funcionalidades incompatíveis com versões anteriores
  • Autenticação intra-nó
  • Série temporal
  • Configuração de Cluster
  • Multimapa criptografado (EMM)
  • Índices curinga

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

Obsoleto(a)
Descrição
storageDetails
Descontinuado na versão 7.0.

A partir do MongoDB 7.0, o monitoramento gratuito será desativado. Os seguintes itens não estão disponíveis:

  • cloud.monitoring.free Opção de configuração

  • --enableFreeMonitoring server parameter

  • db.enableFreeMonitoring() comando

  • db.disableFreeMonitoring() comando

  • setFreeMonitoring comando

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.

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.

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:

  1. Atualize o servidor MongoDB e drivers para o 7.0.

  2. Configure uma nova coleção criptografada com um nome diferente da coleção anterior.

  3. Insira novos dados ou uma versão não criptografada dos dados existentes se você tiver uma cópia local.

  4. Solte a coleção anterior da versão 6.x.

Se você não puder usar novos dados ou não tiver uma versão não criptografada dos dados existentes:

  1. Atualize o servidor MongoDB e os drivers para o 7.0

  2. Utilizando um driver compatível com 7.0, consulte a coleção criptografada para descriptografá-la.

  3. Salve a saída localmente.

  4. Configure uma nova coleção criptografada e ingira os dados.

Aviso

  • As operações mongoexport e mongodump nã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.

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 encryptedFields com intervalo de índices

  • 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.

  • Servidores de configuração que têm coleções com changeStreamPreAndPostImages habilitado

  • Í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

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.

  • 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 collMod para alternar para configurações de granularidade herdadas, se não você precisar descartar a coleção antes de fazer downgrade.

As operações de parâmetro de setClusterParameter ativas impedem que a feature compatibility version (fCV) seja concluída corretamente.

Remova as coleções que utilizam a opção de coleção encryptedFields antes de fazer o downgrade.

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.

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.

Voltar

7.0