Las expresiones son ComponentesMQL que se resuelven en un valor. Las expresiones no tienen estado, lo que significa que devuelven un valor sin modificar ninguno de los valores utilizados para generarlas. Puede usar expresiones en los siguientes contextos MQL:
Algunas etapas de la canalización de agregación, como
$project,$addFieldsy$groupPredicados de query que utilizan
$exprBuscar el comando proyecciones
En el lenguaje del query de MongoDB, puedes crear expresiones a partir de los siguientes componentes:
Componente | Ejemplo |
|---|---|
Constantes |
|
Operadores | |
Expresiones de ruta de campo |
|
Por ejemplo, { $add: [ 3, "$inventory.total" ] } es una expresión que consta del operador $add y dos operandos:
La constante
3La expresión de ruta de campo
"$inventory.total"
La expresión devuelve el resultado de sumar 3 al valor en la ruta inventory.total del documento de entrada.
Los operadores de expresión son similares a las funciones que aceptan argumentos. En general, estos operadores toman un arreglo de argumentos y tienen la siguiente forma:
{ <operator>: [ <argument1>, <argument2> ... ] }
Si un operador acepta un solo argumento, puede omitir el arreglo externo que designa la lista de argumentos:
{ <operator>: <argument> }
Esta página enumera los operadores que se pueden usar para construir expresiones.
Operadores aritméticos
Las expresiones aritméticas realizan operaciones matemáticas con números. Algunas expresiones aritméticas también pueden dar soporte a la aritmética de fechas.
Nombre | Descripción |
|---|---|
Devuelve el valor absoluto de un número. | |
Añade números para devolver la suma, o añade números y una fecha para devolver una nueva fecha. Si se añaden números y una fecha, se tratan los números como milisegundos. Acepta cualquier cantidad de expresiones de argumento, pero como máximo, una expresión puede resolverse en una fecha. | |
Devuelve el menor número entero que sea mayor o igual al número especificado. | |
Devuelve el resultado de dividir el primer número por el segundo. Acepta expresiones con dos argumentos. | |
Eleva e al exponente especificado. | |
Devuelve el mayor número entero que sea menor o igual al número especificado. | |
Calcula el registro natural de un número. | |
Calcula el registro de un número en la base especificada. | |
Calcula el registro en base diez de un número. | |
Devuelve el resto del primer número dividido por el segundo. Acepta expresiones con dos argumentos. | |
Multiplica números para devolver el producto. Acepta cualquier cantidad de expresiones de argumentos. | |
Eleva un número al exponente especificado. | |
Redondea un número a un número entero o a un lugar decimal especificado. | |
Devuelve el resultado de la función sigmoide (la integración de la distribución normal con desviación estándar 1). | |
Calcula la raíz cuadrada. | |
Devuelve el resultado de restar el segundo valor del primero. Si los dos valores son números, se devuelve la diferencia. Si los dos valores son fechas, se devuelve la diferencia en milisegundos. Si los dos valores son una fecha y un número en milisegundos, se devuelve la fecha resultante. Acepta expresiones con dos argumentos. Si los dos valores son una fecha y un número, especifique primero el argumento de la fecha, ya que no tiene sentido restar una fecha de un número. | |
Trunca un número a un número entero o a un lugar decimal especificado. |
Operadores de arreglos
Nombre | Descripción |
|---|---|
Devuelve el elemento en el índice especificado del arreglo. | |
Convierte un arreglo de pares clave-valor en un documento. | |
Concatena arreglos para devolver el arreglo concatenado. | |
Selecciona un subconjunto del arreglo para devolver un arreglo que contenga únicamente los elementos que cumplen con la condición del filtro. | |
Devuelve un número especificado de elementos desde el inicio de un arreglo. Distinto del acumulador | |
Devuelve un valor booleano que indica si un valor especificado está en un arreglo. | |
Busca en un arreglo una ocurrencia de un valor especificado y devuelve el índice de la primera ocurrencia. Los índices de arreglo comienzan en cero. | |
Determina si el operando es un arreglo. Devuelve un valor booleano. | |
Devuelve un número especificado de elementos desde el final de un arreglo. Distinto del acumulador | |
Aplica una subexpresión a cada elemento de un arreglo y devuelve el arreglo de los valores resultantes en el mismo orden. Acepta parámetros con nombre. | |
Devuelve los valores más grandes de | |
Devuelve los | |
Convierte un documento en un arreglo de documentos que representan pares clave-valor. | |
Genera un arreglo que contiene una secuencia de números enteros según las entradas definidas por el usuario. | |
Aplica una expresión a cada elemento de un arreglo y los combina en un solo valor. | |
Devuelve un arreglo con los elementos en orden inverso. | |
Devuelve el número de elementos en el arreglo. Acepta una sola expresión como argumento. | |
Devuelve un subconjunto de un arreglo. | |
Ordena los elementos de un arreglo. | |
Fusionar dos arreglos. |
Operadores a nivel de bits
Nombre | Descripción |
|---|---|
Devuelve el resultado de una operación de Nuevo en la versión 6.3. | |
Devuelve el resultado de una operación bit a bit Nuevo en la versión 6.3. | |
Devuelve el resultado de una operación de Nuevo en la versión 6.3. | |
Devuelve el resultado de una operación bit a bit Nuevo en la versión 6.3. |
Operadores booleanos
Las expresiones booleanas evalúan las expresiones de sus argumentos como valores booleanos y devuelven un valor booleano como resultado.
Además del valor booleano false, la expresión booleana evalúa como false los siguientes valores: null, 0 y undefined. La expresión booleana evalúa todos los demás valores como true, incluidos los valores numéricos no cero y los arreglos.
Nombre | Descripción |
|---|---|
Devuelve | |
Devuelve el valor booleano que es el opuesto de su expresión de argumento. Acepta una expresión de argumento único. | |
Devuelve |
Operadores de comparación
Las expresiones de comparación devuelven un valor booleano, excepto $cmp, que devuelve un número.
Las expresiones de comparación toman dos expresiones de argumento y comparan tanto el valor como el tipo, utilizando el orden de comparación BSON especificado para valores de diferentes tipos.
Nombre | Descripción |
|---|---|
Devuelve | |
Devuelve | |
Devuelve | |
Devuelve | |
Devuelve | |
Devuelve | |
Devuelve |
Operadores condicionales
Nombre | Descripción |
|---|---|
Un operador ternario que evalúa una expresión y, dependiendo del resultado, devuelve el valor de una de las otras dos expresiones. Acepta tres expresiones en una lista ordenada o tres parámetros nombrados. | |
Devuelve el resultado no nulo de la primera expresión o el resultado de la segunda expresión si la primera expresión da como resultado un valor nulo. El resultado nulo abarca instancias de valores indefinidos o campos ausentes. Acepta dos expresiones como argumentos. El resultado de la segunda expresión puede ser nulo. | |
Evalúa una serie de expresiones de casos. Cuando encuentra una expresión que se evalúa como |
Operadores de agregación personalizados
Nombre | Descripción |
|---|---|
Define una función de acumulador personalizada. | |
Define una función personalizada. |
Operadores de tamaño de datos
Los siguientes operadores devuelven el tamaño de un elemento de datos:
Nombre | Descripción |
|---|---|
Devuelve el tamaño del contenido de una string o un valor de datos binario dado en bytes. | |
Devuelve el tamaño en bytes de un documento dado (es decir, bsontype |
Operadores de fecha
Los siguientes operadores devuelven objetos de fecha o componentes de un objeto de fecha:
Nombre | Descripción |
|---|---|
Añade un número de unidades de tiempo a un objeto de fecha. | |
Devuelve la diferencia entre dos fechas. | |
Construye un objeto de fecha BSON a partir de las partes constituyentes de la fecha. | |
Convierte una string de fecha/hora en un objeto de fecha. | |
Resta un número de unidades de tiempo de un objeto de fecha. | |
Devuelve un documento que contiene los componentes de una fecha. | |
Devuelve la fecha como una string formateada. | |
Trunca una fecha. | |
Devuelve el día del mes de una fecha como un número entre 1 y 31. | |
Devuelve el día de la semana para una fecha como un número entre 1 (domingo) y 7 (sábado). | |
Devuelve el día del año de una fecha como un número entre 1 y 366 (año bisiesto). | |
Devuelve la hora de una fecha como un número entre 0 y 23. | |
Devuelve el número del día de la semana en formato ISO 8601, que va del | |
Devuelve el número de la semana en formato ISO 8601, con un rango de | |
Devuelve el número del año en formato ISO 8601. El año comienza con el lunes de la semana 1 (ISO 8601) y termina con el domingo de la última semana (ISO 8601). | |
Devuelve los milisegundos de una fecha como un número entre 0 y 999. | |
Devuelve el minuto de una fecha como un número entre 0 y 59. | |
Devuelve el mes de una fecha como un número entre 1 (enero) y 12 (diciembre). | |
Devuelve los segundos de una fecha como un número entre 0 y 60 (segundos intercalares). | |
Convierte el valor a una Fecha. | |
Devuelve el número de semana de una fecha como un número entre 0 (la semana parcial que precede al primer domingo del año) y 53 (en un año bisiesto). | |
Devuelve el año de una fecha como un número (por ejemplo, 2014). |
Los siguientes operadores aritméticos pueden aceptar operandos de fecha:
Nombre | Descripción |
|---|---|
Suma números y una fecha para obtener una nueva fecha. Si se agregan números y una fecha, trata los números como milisegundos. Acepta cualquier cantidad de expresiones de argumento, pero como máximo, una expresión puede resolverse en una fecha. | |
Devuelve el resultado de restar el segundo valor del primero. Si los dos valores son fechas, se devuelve la diferencia en milisegundos. Si los dos valores son una fecha y un número en milisegundos, se devuelve la fecha resultante. Acepta expresiones con dos argumentos. Si los dos valores son una fecha y un número, se debe especificar primero el argumento de la fecha, ya que no tiene sentido restar una fecha de un número. |
Expresiones asociadas con acumuladores
Algunos acumuladores para la etapa $group también están disponibles para su uso como expresiones. Cuando se utilizan como expresiones, calculan un valor agregado sobre los argumentos de entrada o el arreglo de entrada proporcionados.
Los siguientes operadores son acumuladores, pero también están disponibles como expresiones que aceptan un arreglo de valores como entrada.
Nombre | Descripción |
|---|---|
Devuelve un promedio de la expresión o lista de expresiones especificada para cada documento. Ignora los valores no numéricos. | |
Devuelve un único arreglo que combina los elementos de dos o más arreglos. Nuevo en la versión 8.1. | |
Devuelve el resultado de una expresión para el primer documento de un grupo. | |
Devuelve el resultado de una expresión para el último documento de un grupo. | |
Devuelve el máximo de la expresión o lista de expresiones especificadas para cada documento | |
Devuelve el mínimo de la expresión o lista de expresiones especificadas para cada documento | |
Devuelve un arreglo de valores escalares que corresponden a los valores de percentil especificados. Nuevo en la versión 7.0. | |
Toma dos o más arreglos y devuelve un arreglo que contiene los elementos que aparecen en cualquier arreglo de entrada. Nuevo en la versión 8.1. | |
Devuelve la desviación estándar poblacional de los valores de entrada. | |
Devuelve la desviación estándar muestral de los valores de entrada. | |
Devuelve la suma de valores numéricos. Ignora los valores no numéricos. |
Operadores de expresiones literales
Nombre | Descripción |
|---|---|
Devuelva un valor sin analizar. Se puede utilizar para valores que el pipeline de agregación pueda interpretar como una expresión. Por ejemplo, se puede utilizar una expresión |
Operadores misceláneos
Nombre | Descripción |
|---|---|
Devuelve el valor de un campo especificado de un documento. Se puede usar | |
Devuelve un número flotante aleatorio entre 0 y 1 | |
Se pueden seleccionar documentos aleatoriamente a una tasa determinada. Aunque el número exacto de documentos seleccionados varía en cada ejecución, la cantidad elegida se aproxima a la tasa de muestreo expresada como un porcentaje del número total de documentos. | |
Calcula y devuelve el hash de la expresión de entrada utilizando la misma función hash que MongoDB utiliza para crear un índice con hash. |
Operadores de objetos
Nombre | Descripción |
|---|---|
Combina múltiples documentos en un único documento. | |
Convierte un documento en un arreglo de documentos que representan pares clave-valor. | |
Añade, actualiza o remueve un campo especificado en un documento. Puede usar Nuevo en la versión 5.0. |
Operadores de conjuntos
Las expresiones de conjuntos realizan operaciones de conjuntos en arreglos, tratando los arreglos como conjuntos. Las expresiones de conjuntos ignoran las entradas duplicadas en cada arreglo de entrada y el orden de los elementos.
Si la operación de conjunto devuelve un conjunto, la operación elimina duplicados en el resultado para producir un arreglo que contiene solo entradas únicas. El orden de los elementos en el arreglo de salida es indefinido.
Si un conjunto contiene un elemento de arreglo anidado, la expresión del conjunto no desciende al arreglo anidado, sino que evalúa el arreglo en el nivel superior.
Nombre | Descripción |
|---|---|
Devuelve | |
Devuelve | |
Devuelve un conjunto con elementos que aparecen en el primer conjunto pero no en el segundo, es decir, realiza una complemento relativo del segundo conjunto con respecto al primero. Acepta exactamente dos expresiones de argumento. | |
Devuelve | |
Devuelve un conjunto con elementos que aparecen en todos los conjuntos de entrada. Acepta cualquier cantidad de expresiones de argumentos. | |
Devuelve | |
Devuelve un conjunto con los elementos que aparecen en cualquiera de los conjuntos de entrada. |
Operadores de String
Las expresiones de strings, con la excepción de $concat, solo tienen un comportamiento bien definido para strings de caracteres ASCII.
$concat El comportamiento está bien definido independientemente de los caracteres utilizados.
Nombre | Descripción |
|---|---|
Concatena cualquier cantidad de strings. | |
Convierte una string de fecha/hora en un objeto de fecha. | |
Devuelve la fecha como una string formateada. | |
Realiza una búsqueda en una string de una ocurrencia de una substring y devuelve el índice de bytes UTF-8 de la primera ocurrencia. Si no se encuentra la substring, devuelve | |
Se realiza una búsqueda en una string para una ocurrencia de una substring y devuelve el índice del punto de código UTF-8 de la primera ocurrencia. Si no se encuentra la substring, devuelve | |
Elimina los espacios en blanco o los caracteres especificados del inicio de una string. | |
Aplica una expresión regular (regex) a una string y devuelve información sobre la primera substring coincidente. | |
Aplica una expresión regular (regex) a un string y devuelve información sobre todas las subcadenas coincidentes. | |
Aplica una expresión regular (regex) a una string y devuelve un valor booleano que indica si se ha encontrado una coincidencia o no. | |
Reemplaza la primera instancia de una string coincidente en una entrada dada. | |
Reemplaza todas las instancias de una string coincidente en una entrada dada. | |
Remueve los espacios en blanco o los caracteres especificados del final de una string. | |
Crea una división de una string en substrings basándose en un delimitador. Devuelve un arreglo de substrings. Si el delimitador no se encuentra dentro de la string, devuelve un arreglo que contiene la string original. | |
Devuelve el número de bytes codificados en UTF-8 en una string. | |
Devuelve el número de puntos de código UTF-8 en una string. | |
Realiza una comparación de strings sin distinguir entre mayúsculas y minúsculas y devuelve: | |
Obsoleto Se puede utilizar | |
Devuelve la substring de una string. Comienza con el carácter en el índice de bytes UTF-8 especificado (base cero) en la string y continúa durante el número de bytes especificado. | |
Devuelve la substring de una string. Comienza en el carácter del índice especificado del punto de código (CP) UTF-8 (con el índice basado en cero) dentro de la string y continúa durante el número de puntos de código especificado. | |
Convierte una string a minúsculas. Acepta una expresión con un único argumento. | |
Convierte el valor a una string. | |
Remueve los espacios en blanco o los caracteres especificados del principio y el final de una string. | |
Convierte una string a mayúsculas. Acepta una expresión con un único argumento. |
Operadores de string cifrados
Las expresiones de string cifradas evalúan un argumento contra un campo cifrado en una colección con Queryable Encryption activado y devuelven un booleano.
Nombre | Descripción |
|---|---|
Devuelve | |
Devuelve | |
Devuelve | |
Devuelve |
Operadores de texto
Nombre | Descripción |
|---|---|
Acceder a los metadatos disponibles por documento relacionados con la operación de agregación. |
Operadores de marca temporal
Los operadores de expresión de marca de tiempo devuelven valores de una marca de tiempo.
Nombre | Descripción |
|---|---|
Devuelve el ordinal incremental de una marca de tiempo como un Nuevo en la versión 5.1. | |
Devuelve los segundos de una marca de tiempo como un Nuevo en la versión 5.1. |
Operadores trigonométricos
Las expresiones trigonométricas realizan operaciones trigonométricas sobre números. Los valores que representan ángulos siempre se introducen o se obtienen en radianes. Utilizar $degreesToRadians y $radiansToDegrees para convertir entre mediciones de grados y radianes.
Nombre | Descripción |
|---|---|
Devuelve el seno de un valor que se mide en radianes. | |
Devuelve el coseno de un valor medido en radianes. | |
Devuelve la tangente de un valor medido en radianes. | |
Devuelve el seno inverso (arcoseno) de un valor en radianes. | |
Devuelve el coseno inverso (arcocoseno) de un valor en radianes. | |
Devuelve el arcotangente (tangente inversa) de un valor en radianes. | |
Devuelve la tangente inversa (arcotangente) de | |
Devuelve el seno hiperbólico inverso (arcoseno hiperbólico) de un valor en radianes. | |
Devuelve el coseno hiperbólico inverso (arco coseno hiperbólico) de un valor en radianes. | |
Devuelve el arcotangente hiperbólico inverso (arcotangente hiperbólico) de un valor en radianes. | |
Devuelve el seno hiperbólico de un valor medido en radianes. | |
Devuelve el coseno hiperbólico de un valor medido en radianes. | |
Devuelve la tangente hiperbólica de un valor medido en radianes. | |
Convierte un valor de grados a radianes. | |
Convierte un valor de radianes a grados. |
Operadores de tipos
Nombre | Descripción |
|---|---|
Convierte un valor a un tipo especificado. | |
Convierte el valor a un booleano. | |
Convierte el valor a una Fecha. | |
Convierte el valor a un Decimal128. | |
Convierte el valor a un double. | |
Convierte el valor a un entero. | |
Convierte el valor a un entero largo. | |
Convierte el valor a un ObjectId. | |
Convierte el valor a una string. | |
Devolver el tipo de dato BSON del campo. | |
Convierte una string a un UUID. |
Operadores de variables
Nombre | Descripción |
|---|---|
Define variables para su uso dentro del alcance de una subexpresión y devuelve el resultado de la subexpresión. Acepta parámetros nombrados. Acepta cualquier cantidad de expresiones de argumentos. |
Operadores de ventana
Los operadores de ventana devuelven valores de un intervalo definido de documentos de una colección, conocido como una ventana. Una ventana se define en la etapa $setWindowFields, disponible a partir de MongoDB 5.0.
Los siguientes operadores de ventana están disponibles en la etapa $setWindowFields.
Nombre | Descripción |
|---|---|
Devuelve un arreglo de todos los valores únicos que resultan de aplicar una expresión a cada documento. Se cambió en la versión 5.0: disponible en la etapa | |
Devuelve el promedio de la expresión especificada. Ignora los valores no numéricos. Se cambió en la versión 5.0: disponible en la etapa | |
Devuelve el elemento más bajo dentro de un grupo según el orden de acomodo especificado. Nuevo en la versión 5.2. Disponible en las etapas | |
Devuelve una agregación de los campos Nuevo en la versión 5.2. Disponible en las etapas | |
Devuelve la cantidad de documentos en el grupo o ventana. Distinto de la etapa de canalización de Nuevo en la versión 5.0. | |
Devuelve la covarianza poblacional de dos expresiones numéricas. Nuevo en la versión 5.0. | |
Devuelve la covarianza muestral de dos expresiones numéricas. Nuevo en la versión 5.0. | |
Devuelve la posición del documento (conocida como el rango) en relación con otros documentos en la etapa de partición Nuevo en la versión 5.0. | |
Devuelve la tasa promedio de cambio dentro de la ventana especificada. Nuevo en la versión 5.0. | |
Devuelve la posición de un documento (conocido como número de documento) en la etapa de partición Nuevo en la versión 5.0. | |
Devuelve la media móvil exponencial de la expresión numérica. Nuevo en la versión 5.0. | |
Devuelve el resultado de una expresión para el primer documento de un grupo o ventana. Se cambió en la versión 5.0: disponible en la etapa | |
Devuelve la aproximación del área bajo una curva. Nuevo en la versión 5.0. | |
Devuelve el resultado de una expresión para el último documento en un grupo o ventana. Se cambió en la versión 5.0: disponible en la etapa | |
Completa Disponible en la etapa Novedades en la versión 5.3. | |
Última observación llevada hacia adelante. Establece los valores para Disponible en la etapa Nuevo en la versión 5.2. | |
Devuelve el valor máximo que resulta de aplicar una expresión a cada documento. Se cambió en la versión 5.0: disponible en la etapa | |
Devuelve el valor mínimo que resulta de aplicar una expresión a cada documento. Se cambió en la versión 5.0: disponible en la etapa | |
Devuelve una agregación de los Nuevo en la versión 5.2. Disponible en | |
Devuelve un arreglo de valores que resultan de aplicar una expresión a cada documento. Se cambió en la versión 5.0: disponible en la etapa | |
Devuelve la posición del documento (conocida como rango) en relación con otros documentos en la partición de la etapa Nuevo en la versión 5.0. | |
Devuelve el valor de una expresión aplicada a un documento en una posición especificada relativa al documento actual en la partición de la etapa de Nuevo en la versión 5.0. | |
Devuelve la desviación estándar de la población que resulta de aplicar una expresión numérica a cada documento. Se cambió en la versión 5.0: disponible en la etapa | |
Devuelve la desviación estándar de la muestra que resulta de aplicar una expresión numérica a cada documento. Se cambió en la versión 5.0: disponible en la etapa | |
Devuelve la suma que resulta de aplicar una expresión numérica a cada documento. Se cambió en la versión 5.0: disponible en la etapa | |
Devuelve el elemento principal dentro de un grupo según el orden de acomodo especificado. Nuevo en la versión 5.2. Disponible en las etapas | |
Devuelve una agregación de los campos Nuevo en la versión 5.2. Disponible en las etapas |