Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Armazenar uma função JavaScript no servidor

Importante

A partir do MongoDB 8.0, o JavaScript do lado do servidor está obsoleto. system.js a funcionalidade pode não funcionar com todos os recursos.

Há uma collection de sistema especial chamada system.js que pode armazenar funções JavaScript para reutilização.

Esta tarefa usa o shell mongo legado para carregar funções do lado do servidor da coleção system.js . Esta versão do shell não é mais suportada. Para uma solução alternativa no MongoDB Shell, consulte Escrever scripts.

Considere as seguintes recomendações ao usar system.js:

  • Não armazene lógica de aplicativo no banco de dados.

  • Existem limitações de desempenho para executar JavaScript dentro do MongoDB.

  • O código do aplicativo é mais eficaz quando compartilha o controle de versão com o aplicativo.

Para armazenar uma função, insira a função na coleção system.js, como nestes exemplos:

1
db.test_numbers.insertMany([ { value: 1 }, { value: 2 }, { value: 3 }, { value: 4 }, { value: 5 }, { value: 6 }])
2

Para armazenar funções JavaScript no banco de dados, insira um documento com estes campos:

  • O campo _id mantém o nome da função e é exclusivo por banco de dados.

  • O campo value mantém a definição de função.

O exemplo a seguir cria uma função echo na coleção system.js:

db.system.js.insertOne( { _id: "echo", value : function(x) { return x; } })

O exemplo a seguir cria uma função isEven na coleção system.js:

db.system.js.insertOne( { _id: "isEven", value: function (num) { return num % 2 === 0; } })

Estas funções, salvas como Tipo JSON, estão disponíveis para utilizar a partir de qualquer contexto JavaScript, como mapReduce e $where.

Observação

As funções salvas como o tipo BSON preterido JavaScript (com escopo) não podem ser usadas por mapReduce e $where.

3
db.loadServerScripts()
4
  1. O exemplo de código a seguir executa a função echo armazenada em system.js:

    echo("test")
  2. O exemplo de código a seguir executa a função isEven armazenada em system.js no operador $where na coleção test_numbers:

    db.test_numbers.find({ $where: function () { return isEven(this.value); }})