:Alterações de compatibilidade no MongoDB 4.0

Para obter mais informações sobre as alterações oficiais de compatibilidade do MongoDB, consulte o site do MongoDB.

Descontinuação do MONGODB-CR

A partir da versão 4.0, o MongoDB não oferece mais suporte ao modo de autenticação MONGODB-CR, que foi descontinuado.

Desde o MongoDB 3.0, não é mais possível criar um usuário MONGODB-CR. A única exceção ocorre quando sua implantação foi atualizada da versão 2.6 ou anterior e o modo de autenticação do usuário MONGODB-CR original não foi atualizado.

Caso sua implantação ainda utilize o modo MONGODB-CR para armazenar credenciais de usuário, será necessário atualizá-lo para o Salted Challenge Response Authentication Mechanism (SCRAM) antes de fazer o upgrade para o MongoDB 4.0.

Descontinuação do MMAPv1

O mecanismo de armazenamento MMAPv1 foi descontinuado a partir do MongoDB 4.0. É obrigatório migrar sua instância para o mecanismo de armazenamento WiredTiger.

Limites em certificados de autenticação X.509

No MongoDB 4.0, se você especificar --sslAllowInvalidCertificates ou net.ssl.allowInvalidCertificates: true (renomeados para --tlsAllowInvalidateCertificates ou net.tls.allowInvalidCertificates: true no MongoDB 4.2) ao usar autenticação x.509, um certificado inválido servirá apenas para estabelecer a conexão TLS/SSL, mas não será suficiente para concluir a autenticação.

Para resolver esse problema, substitua o certificado inválido por um válido (como um assinado por uma CA confiável) ou use net.ssl.CAFile para definir uma CA personalizada.

Instâncias de replica set

cfg = rs.conf();
cfg.protocolVersion=1;
rs.reconfig(cfg);

Instâncias de sharded cluster

O mongos passou a utilizar o nível de write concern "majority" nas seguintes operações que afetam os metadados do sharded cluster.

Compatibilidade de recursos do MongoDB 4.0

Determinados recursos do MongoDB 4.0 exigem arquivos binários da versão 4.0 e o parâmetro featureCompatibilityVersion definido como 4.0. Entre eles estão:

• SCRAM-SHA-256

• Novos operadores de conversão de tipos (incluindo $toBool e $toInt) e melhorias associadas

• Transações multidocumento

• Alterações nas opções de $dateToString

• Novos métodos de change stream

• Mudanças no tipo de dados do token de retomada de change stream

Outras alterações

• Instâncias de sharded cluster agora suportam os operadores de consulta geoespacial $near e $nearSphere.

• No comando create e no método do mongo shell db.createCollection(), a opção autoIndexId não pode mais ser definida como false ao criar coleções em bancos de dados diferentes de local.

• Quando a autenticação está ativada e o comando listDatabases é executado sem a permissão de operação listDatabases, o MongoDB retorna a lista de todos os bancos de dados nos quais você possui permissão de operação find. Antes da versão 4.0, executar esse comando sem a permissão de operação listDatabases resultava na mensagem Unauthorized.

• O valor padrão de taskExecutorPoolSize mudou de 0 para 1. Em sistemas Linux, para restaurar o comportamento anterior em uma implantação V4.0, defina taskExecutorPoolSize como 0 e AsyncRequestsSenderUseBaton como false.

• Nas instâncias mongod e mongos do MongoDB 4.0, não é permitido definir transportLayer e net.transportLayer como legacy. O valor padrão de transportLayer é asio e não pode ser alterado.

• A partir do MongoDB 4.0, o comando reIndex e seu método correspondente db.collection.reIndex() adquirem um bloqueio exclusivo global, impedindo outras operações até que sejam concluídos.

• Se os valores de campos diferentes de year, isoYear e timezone ultrapassarem seus intervalos válidos, $dateFromParts subtrai a diferença das demais partes da data para realizar o cálculo. Nas versões anteriores ao MongoDB 4.0, valores fora do intervalo válido geravam erro.

• O comportamento da operação killCursors foi modificado. Antes do MongoDB 4.0, bastava obter um ID de cursor para encerrá-lo. Agora, killCursors permite encerrar qualquer cursor existente. Caso você não tenha permissão para encerrar um cursor, killCursors retorna um erro.

• Foi adicionada a operação killAnyCursor no MongoDB 4.0, que concede permissão para encerrar qualquer cursor de uma coleção específica.

• Ao tentar conectar uma instância mongos a outra instância com uma versão de compatibilidade de recursos (fCV) superior, a instância mongos pode falhar a partir do MongoDB 4.0. Por exemplo, uma instância mongos do MongoDB 4.0 não consegue se conectar a um sharded cluster com fCV definido como 4.2. No entanto, se o fCV do sharded cluster permanecer em 4.0, a conexão ocorre normalmente.

• O MongoDB 4.0 passa a resolver endereços IP de localhost com base nas configurações especificadas, em vez de assumir automaticamente 127.0.0.1.

TLS 1.0 desativado

Os arquivos binários do MongoDB (mongod, mongos e mongo) desativam a criptografia TLS 1.0 por padrão em sistemas compatíveis com TLS 1.1 ou superior.

Para forçar a ativação do TLS 1.0:

• Em instâncias mongod, especifique net.ssl.disabledProtocols: none no arquivo de configuração ou utilize o parâmetro de linha de comando --sslDisabledProtocols none.

• Para instâncias mongos, use net.ssl.disabledProtocols: none ou --sslDisabledProtocols none.

• No mongo shell, adicione o parâmetro --sslDisabledProtocols none.

  O parâmetro --sslDisabledProtocols está disponível nas seguintes versões do mongo shell:

  • MongoDB 4.0+

  • MongoDB 3.6.5+

  • MongoDB 3.4.15+

No macOS, ao usar o mongo shell do MongoDB 3.6.4 ou anterior para se conectar a uma instância de sharded cluster do MongoDB 4.0+, é necessário ativar explicitamente o TLS 1.0.

Mongo shell

db.runCommand( { listCollections: 1.0, authorizedCollections: true, nameOnly: true } )

db.runCommand( { listCollections: 1.0, authorizedCollections: true, nameOnly: true } )

Remoção de arquivos binários e campos ou comandos descontinuados

mongodump --archive --db=test | mongorestore --archive  --nsFrom='test.*' --nsTo='examples.*'