:Alterações de compatibilidade no MongoDB 3.6

mongod --bind_ip localhost,My-Example-Associated-Hostname

mongo --host My-Example-Associated-Hostname

mongo --host 198.51.100.1

Alterações de comportamento de $type: "array"

A partir do MongoDB 3.6, as expressões type: "array" e $type: 4 correspondem a campos do tipo array que contêm elementos de qualquer tipo.

Antes do MongoDB 3.6, $type: "array" correspondia apenas a campos do tipo array que continham arrays aninhados.

Por exemplo, uma coleção chamada c contém os seguintes documentos:

{ "_id": 1, "a": [ 1, 2, 3 ] },
{ "_id": 2, "a": [ 1, 2, [ 3, 4 ] ] }

A operação a seguir consulta dados pelo tipo do campo a:

db.c.find( { "a": { $type : "array" } } )

A partir do MongoDB 3.6, uma consulta $type retorna os dois documentos da coleção, pois passa a detectar que o campo a é um array.

{ "_id": 1, "a": [ 1, 2, 3 ] },
{ "_id": 2, "a": [ 1, 2, [ 3, 4 ] ] }

Antes do MongoDB 3.4, uma consulta $type retornava apenas documentos em que o campo a continha elementos do tipo array BSON.

{ "_id": 2, "a": [ 1, 2, [ 3, 4 ] ] }

Se a instância atual executa o MongoDB 3.4.x e você utiliza índices parciais cujo partialFilterExpression contém $type: "array" ou $type: 4, reconstrua esses índices após a atualização para o MongoDB 3.6 a fim de evitar conflitos decorrentes das alterações semânticas em $type: 'array'.

Alterações de comportamento na ordenação de arrays

A partir do MongoDB 3.6, ao ordenar por um campo do tipo array, o MongoDB usa o elemento de menor valor do array como chave de ordenação ascendente e o elemento de maior valor como chave de ordenação descendente. A ordenação deixa de considerar os predicados de consulta ao selecionar um elemento do array como chave de ordenação. Essa mudança de comportamento se aplica ao comando find e às operações de pipeline de agregação.

Como consequência, aplicações que ordenam por campos do tipo array podem retornar resultados de ordenação diferentes.

{ _id: 0, a: [-3, -2, 2, 3] }
{ _id: 1, a: [ 5, -4 ] }

db.coll.find({a: {$gte: 0}}).sort({a: 1});

// Documents.
{ "_id" : 1, "timestamps" : [ ISODate("2017-07-15T15:31:01Z"), ISODate("2017-07-21T18:31:01Z") ] }
{ "_id" : 0, "timestamps" : [ ISODate("2017-07-21T15:31:01Z"), ISODate("2017-07-21T13:31:01Z") ] }

// Query.
db.c.aggregate([{$sort: {timestamps: -1}}])

// Documents.
{_id: 0, a: [3, 1, 5]}
{_id: 1, a: [3, 4, 0]}

// Query.
db.coll.aggregate([{$sort: {a: 1}}])

Adição de novos campos

A partir do MongoDB 3.6, os campos adicionados durante operações de update são inseridos em ordem lexicográfica.

Por exemplo, uma coleção chamada coll contém o seguinte documento:

{ _id: 0, x: 0 }

Execute uma operação de update para adicionar os seguintes campos:

db.coll.update({_id: 0}, {$set: {b: 0, a: 0}})

No MongoDB 3.6, os novos campos são inseridos em ordem lexicográfica. Consequentemente, o documento atualizado é {_id: 0, x: 0, a: 0, b: 0}.

Antes do MongoDB 3.6, os novos campos eram inseridos na ordem em que apareciam no documento de update. Consequentemente, o documento atualizado era {_id: 0, x: 0, b: 0, a: 0}.

Campos com conflito com a sintaxe de identificadores do arrayFilters

A partir do MongoDB 3.6, campos cujo nome conflita com a sintaxe de identificadores de arrayFilters (como $[]) não podem mais ser atualizados.

Por exemplo, uma coleção chamada coll contém o seguinte documento:

{ _id: 0, x: { "$[]": 0 } }

Execute uma operação de update:

db.coll.update({_id: 0}, {$set: {"x.$[]": 1}})

A partir do MongoDB 3.6, uma operação de update falha porque o nome de campo $[] conflita com a sintaxe de identificadores de arrayFilters. Antes do MongoDB 3.6, essa operação era bem-sucedida.

Validação mais rígida do operador $pop

A partir do MongoDB 3.6, os parâmetros do operador $pop devem ser definidos como um dos seguintes valores:

• -1: remove o primeiro elemento de um array, ou

• 1: remove o último elemento de um array.

Antes do MongoDB 3.6:

• Números negativos para remover o primeiro elemento de um array, ou

• Números não negativos ou valores não numéricos para remover o último elemento de um array.

Remoção do operador $pushAll

O MongoDB 3.6 remove o operador $pushAll (descontinuado desde o MongoDB 2.4).

Use os operadores $push e $each como alternativa. Exemplo:

db.students.update(
   { name: "joe" },
   { $push: { scores: { $each: [ 90, 92, 85 ] } } }
)

Descontinuação do mecanismo de autenticação MONGODB-CR

A partir do MongoDB 3.6, o MongoDB descontinua o mecanismo de autenticação MONGODB-CR. Caso ainda não tenha feito isso, atualize o esquema de autenticação MONGODB-CR para SCRAM.

Nós árbitros e sua prioridade

Todos os nós árbitros têm prioridade fixa de 0.

Descontinuação da arquitetura de replicação master-slave

O MongoDB 3.6 descontinua oficialmente a arquitetura de replicação master-slave.

Descontinuação da opção --nojournal para o mecanismo de armazenamento WiredTiger

O MongoDB 3.6 descontinua a opção --nojournal para membros de replica set que utilizam o mecanismo de armazenamento WiredTiger, evitando assim riscos de perda de dados.

Ajustes no comando aggregate e em sua saída

A partir do MongoDB 3.6, o comando aggregate não retorna mais resultados como um único documento.

Ao executar o comando aggregate, especifique uma das seguintes opções:

• cursor: retorna os resultados como um cursor (indicado para grandes volumes de dados).

• explain: retorna uma análise do plano de execução do pipeline de agregação.

Recomenda-se utilizar db.collection.aggregate() no mongo shell ou o método equivalente no driver correspondente. Esses métodos retornam um cursor por padrão, salvo quando a opção explain é utilizada.

Alterações na conversão de campos de data para strings em expressões de agregação

A partir do MongoDB 3.6, o MongoDB converte datas para strings com precisão de milissegundos, terminando com a letra 'Z' (indicando o fuso horário UTC), em expressões de agregação.

Exemplo:

// Documents.
{_id: 0, d: ISODate("2017-10-18T20:04:27.978Z")}
{_id: 1, d: ISODate("2017-10-18T20:04:28.192Z")}

// Query.
db.coll.aggregate({$project: {d: {$toLower: "$d"}}})

Antes do MongoDB 3.6, os campos de data nos dois documentos eram retornados como strings no formato "2017-10-18t20:04:27" e "2017-10-18t20:04:28".

A partir do MongoDB 3.6, os campos de data nos dois documentos são retornados como strings no formato "2017-10-18t20:04:27.978z" e "2017-10-18t20:04:28.192z" (incluindo milissegundos e 'z' em minúsculo).

Essas alterações se aplicam aos seguintes operadores de agregação:

• $concat

• $substr

• $substrBytes

• $substrCP

• $strcasecmp

• $toLower

• $toUpper

Remoção de comandos e opções de diagnóstico de log

O MongoDB 3.6 remove os comandos descontinuados diagLogging e a opção mongod --diaglog.

Como alternativa, use a ferramenta mongoreplay para capturar, reproduzir e analisar comandos enviados ao seu deployment do MongoDB.

Alterações na operação validate

A partir do MongoDB 3.6, uma operação validate aciona obrigatoriamente um checkpoint e libera todos os dados em memória para o disco somente antes de executar uma validação de dados em disco.

Antes do MongoDB 3.6, o checkpoint era acionado obrigatoriamente independentemente do modo de validação utilizado.

Ao usar o comando validate ou o método db.collection.validate(), especifique explicitamente {full: true} para realizar uma validação completa.

Limites para nomes de índices

A partir do MongoDB 3.6:

• Não é possível especificar * como nome de índice durante a criação.

• Não é possível usar chaves de índice para excluir índices nomeados *. Use o nome de índice * para excluí-los.

Antes de atualizar para o MongoDB 3.6, execute as seguintes etapas:

• Exclua os índices: exclua manualmente todos os índices existentes nomeados *.

• Renomeie os índices: para mantê-los, exclua-os e reconstrua-os com novos nomes.

Opções descontinuadas

Alterações no MongoDB 3.6.1:

• Descontinuação da opção de consulta snapshot.

  • Mecanismo de armazenamento MMAPv1: use hint({ _id: 1 }) para garantir que os documentos não sejam retornados mais de uma vez durante uma consulta, mesmo que escritas intermediárias causem a movimentação dos documentos.

  • Outros mecanismos de armazenamento (como WiredTiger): use hint({ $natural: 1 }) como alternativa.

• Descontinuação do operador $isolated.

  • Alternativa: use transações ou ajuste os níveis de read concern para obter isolamento.