Alterações de compatibilidade com o legado mongo Shell

Métodos obsoletos

Os seguintes métodos de shell são preteridos no mongosh. Em vez disso, utilize os métodos listados na coluna Alternative Resources.

Ler comportamento de preferência

Comportamento de preferência de escrita

Gravações repetíveis são habilitadas por padrão no mongosh. As gravações repetíveis foram desabilitadas por padrão no shell legado mongo. Para desativar gravações repetíveis, use --retryWrites=false.

Métodos e atributos do ObjectId

Estes métodos ObjectId() funcionam de forma diferente no mongosh e no mongo shell legado.

Valores numéricos

O mongo shell legado armazenou valores numéricos como doubles por padrão. Em mongosh, os números são armazenados como inteiros de 32 bits, Int32 ou então como Double se o valor não puder ser armazenado como Int32.

MongoDB Shell continua suportando os tipos numéricos que são suportados no shell mongo . No entanto, os tipos preferidos foram atualizados para melhor alinhamento com os drivers MongoDB. Consulte Tipos de dados mongosh para obter mais informações.

Os tipos preferidos para variáveis numéricas são diferentes no MongoDB Shell do que os tipos sugeridos no shell legado mongo. Os tipos em mongosh se alinham melhor com os tipos usados pelos drivers do MongoDB.

Comportamento de cotação de objetos

mongosh não coloca aspas nas chaves do objeto em sua saída e coloca aspas simples nos valores. Para reproduzir a saída do shell legado mongo, que envolve as chaves e os valores de string entre aspas duplas, use mongosh --eval com EJSON.stringify().

Por exemplo, o seguinte comando gera os itens na collection sales no banco de dados do test com aspas duplas e recuo:

mongosh --eval "EJSON.stringify(db.sales.findOne().toArray(), null, 2)"

A saída parece o seguinte:

{
     "_id": {
          "$oid": "64da90c1175f5091debcab26"
     },
     "custId": 345,
     "purchaseDate": {
          "$date": "2023-07-04T00:00:00Z"
     },
     "quantity": 4,
     "cost": {
          "$numberDecimal": "100.60"
     }
}

Limitações nas chamadas de banco de dados

Os resultados das queries do banco de dados não podem ser passados dentro dos seguintes contextos:

• Funções do construtor de classes

• Funções de gerador não assíncronas

• Retornos de chamada para .sort() em uma matriz

• Setters de JavaScript em classes

Para acessar os resultados de chamadas de banco de dados, use funções assíncronas, funções assíncronas de gerador ou .map().

// This code will fail
class FindResults {
   constructor() {
      this.value = db.students.find();
   }
}
// This code will fail
function listEntries() { return db.students.find(); }
class FindResults {
   constructor() {
      this.value = listEntries();
   }
}

class FindResults {
   constructor() {
      this.value = ( async() => {
         return db.students.find();
      } )();
   }
}

class FindResults {
   constructor() { }
   init() { this.value = db.students.find(); }
 }

// This code will fail
function* FindResults() {
   yield db.students.findOne();
}
// This code will fail
function listEntries() { return db.students.findOne(); }
function* findResults() {
   yield listEntries();
}

function listEntries() { return db.students.findOne(); }
async function* findResults() {
   yield listEntries();
}

// This code will fail
db.getCollectionNames().sort( ( collectionOne, collectionTwo ) => {
  return db[ collectionOne ].estimatedDocumentCount() - db[ collectionOne ].estimatedDocumentCount() )
} );

db.getCollectionNames().map( collectionName => {
   return { collectionName, size: db[ collectionName ].estimatedDocumentCount() };
} ).sort( ( collectionOne, collectionTwo ) => {
   return collectionOne.size - collectionTwo.size;
} ).map( collection => collection.collectionName);

// This code will fail
class TestClass {
  value = 1;
  get property() {
    return this.value;
  }
  // does not work:
  set property(value) {
    this.value = db.test.findOne({ value });
  }
}