Alterações de compatibilidade com o legado shell 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 .

Numeric Values

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.

Valores indefinidos

O tipo indefinido de BSON está obsoleto. Se você tentar inserir um documento com o tipo JS indefinido em mongosh, seu sistema substituirá o valor indefinido em seu documento pelo valor nulo BSON. Não há nenhuma maneira suportada de inserir valores indefinidos em seu banco de dados de dados usando mongosh.

Por exemplo, considere executar o seguinte código para inserir um documento no mongosh:

db.people.insertOne( { name : "Sally", age : undefined } )

Quando você executa este código no mongosh, o shell insere o seguinte documento:

{ name : "Sally", age : null }

mongosh representa qualquer valor indefinido de BSON armazenado usando outras ferramentas, como o Go Driver ou o mongo shell legado , como nulo.

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 });
  }
}

Exceções de comando

Para comandos cuja saída inclui { ok: 0 }, mongosh retorna uma exceção consistente e omite a saída bruta do servidor. O shell mongo legado retorna uma saída que varia para cada comando.

Para obter detalhes, consulte Executar comandos.

Configuração de shell

O shell mongo legado usa um arquivo de configuração chamado .mongorc.js.

Se mongosh encontrar .mongorc.js na inicialização, mas não encontrar .mongoshrc.js, mongosh não carrega o arquivo .mongorc.js legado e informa que você deve renomear .mongorc.js para .mongoshrc.js.

Para obter detalhes, consulte .mongoshrc Arquivo de Configuração.

Tipos de dados

O MongoDB armazena dados usando BSON, que aceita tipos de dados adicionais que não estão disponíveis em JSON. O shell mongosh tem melhor suporte a tipos de dados para drivers do que o shell mongo legado.

Para detalhes, consulte Tipos de dados.

Métodos

O shell mongo legado não pode acessar um nome de arquivo ou diretório de script no método load() .

Para obter detalhes, consulte load().

Gravações repetíveis

Por padrão, as gravações que podem ser repetidas são:

• habilitado em mongosh

• desabilitados no shell mongo legado

Para desativar gravações repetitivas, use --retryWrites=false.

Para detalhes, consulte --retryWrites.

Saída legada

O shell mongosh retorna uma saída que difere do shell mongo legado . Se você tiver scripts que exijam que a saída seja formatada de forma semelhante ao shell mongo legado , tente reformatar a saída mongosh com EJSON.stringify ().

Para obter detalhes, consulte Legado tojsononeline().

Trechos de código

Trabalhar com trechos de código é diferente do shell mongo legado .

Para obter detalhes, consulte Obter ajuda para um trecho.