$función (operador de expresión)

Restricción de validación de esquema

No se puede utilizar como parte de una $function expresiónde consulta de validación de esquema.

Javascript Enablement

Para utilizar, debe tener habilitadas las secuencias de comandos del lado del servidor $function (predeterminado).

Si no utiliza $function (o, o), deshabilite las secuencias de comandos del lado del $accumulator $where mapReduceservidor:

• Para una instancia de mongod, consulta la opción de configuración security.javascriptEnabled o la opción de línea de comandos --noscripting.

• Para una instancia mongos, consulta la opción de configuración security.javascriptEnabled o la opción de línea de comandos --noscripting.

  In earlier versions, MongoDB does not allow JavaScript execution on mongos instances.

Consulta también ➤ Ejecutar MongoDB con opciones de configuración seguras.

Alternativa a $where

El operador de consulta también se puede usar para especificar expresiones JavaScript. Sin $where embargo:

• El operador permite $expr el uso de expresiones de agregación dentro del lenguaje de consulta.

• $function y permiten a los usuarios definir expresiones de agregación personalizadas en JavaScript si los operadores de canalización proporcionados no pueden satisfacer las necesidades de su $accumulator aplicación.

Dado los operadores de agregación disponibles:

• El uso de con operadores de agregación que $expr $function $accumulator no utilizan JavaScript (es decir, operadores que no son ni) es más rápido que $where porque no ejecuta JavaScript y debería preferirse si es posible.

• Sin embargo, si es necesario crear expresiones personalizadas, $function es preferible a $where.

Funciones de string y arreglo no compatibles

MongoDB 6.0 actualiza el motor JavaScript interno utilizado para JavaScript del lado del servidor, expresiones, $accumulator $functiony, y de $where MozJS-60 a91 MozJS-. Varias funciones de matriz y cadena obsoletas y no estándar que existían en MozJS-60 se eliminan en MozJS-.91

Para obtener la lista completa de funciones de cadena y matriz eliminadas, consulte las 6.0 notas de compatibilidad.

Ejemplo 1: Ejemplo de uso

Cree una colección de muestra denominada players con los siguientes documentos:

db.players.insertMany([
   { _id: 1, name: "Miss Cheevous",  scores: [ 10, 5, 10 ] },
   { _id: 2, name: "Miss Ann Thrope", scores: [ 10, 10, 10 ] },
   { _id: 3, name: "Mrs. Eppie Delta ", scores: [ 9, 8, 8 ] }
])

La siguiente operación de agregación utiliza para agregar nuevos campos a cada $addFields documento:

• isFound cuyo valor está determinado por la $function expresión personalizada que verifica si el5 hash MD del nombre es igual a un hash especificado.

• message cuyo valor está determinado por la $function expresión personalizada que formatea un mensaje de cadena utilizando una plantilla.

db.players.aggregate( [
   { $addFields:
      {
        isFound:
            { $function:
               {
                  body: function(name) {
                     return hex_md5(name) == "15b0a220baa16331e8d80e15367677ad"
                  },
                  args: [ "$name" ],
                  lang: "js"
               }
            },
         message:
            { $function:
               {
                  body: function(name, scores) {
                     let total = Array.sum(scores);
                     return `Hello ${name}.  Your total score is ${total}.`
                  },
                  args: [ "$name", "$scores"],
                  lang: "js"
               }
            }
       }
    }
] )

La operación devuelve los siguientes documentos:

{ "_id" : 1, "name" : "Miss Cheevous", "scores" : [ 10, 5, 10 ], "isFound" : false, "message" : "Hello Miss Cheevous.  Your total score is 25." }
{ "_id" : 2, "name" : "Miss Ann Thrope", "scores" : [ 10, 10, 10 ], "isFound" : true, "message" : "Hello Miss Ann Thrope.  Your total score is 30." }
{ "_id" : 3, "name" : "Mrs. Eppie Delta ", "scores" : [ 9, 8, 8 ], "isFound" : false, "message" : "Hello Mrs. Eppie Delta .  Your total score is 25." }

Ejemplo 2: Alternativa a $where

Como alternativa a una consulta que utiliza el operador,$where puede usar y. Por $expr ejemplo, considere el $function $where siguiente ejemplo.

db.players.find( { $where: function() {
   return (hex_md5(this.name) == "15b0a220baa16331e8d80e15367677ad")
} } );

La operación devuelve el siguiente db.collection.find() documento:

{ "_id" : 2, "name" : "Miss Ann Thrope", "scores" : [ 10, 10, 10 ] }

El ejemplo se puede expresar utilizando $expr $functiony:

db.players.find( {$expr: { $function: {
      body: function(name) { return hex_md5(name) == "15b0a220baa16331e8d80e15367677ad"; },
      args: [ "$name" ],
      lang: "js"
} } } )