Referencia rápida de canalización de agregación

Agrega nuevos campos a los documentos. De forma similar a $project, $addFields transforma cada documento en el flujo; específicamente, agregando nuevos campos a los documentos de salida que contienen tanto los campos existentes de los documentos de entrada como los nuevos campos agregados.

$set es un alias para $addFields.

Clasifica los documentos entrantes en grupos, llamados buckets, basados en una expresión especificada y límites de bucket.

Clasifica los documentos entrantes en un número específico de grupos, denominados buckets, según una expresión especificada. Los límites de los buckets se determinan de manera automática con el objetivo de distribuir uniformemente los documentos en el número especificado de buckets.

Devuelve un cursor de flujo de cambios para la colección. Esta etapa solo puede ocurrir una vez en un pipeline de agregación y debe ser la primera etapa.

Divide los eventos grandes de flujo de cambios que superan los 16 MB en fragmentos más pequeños que se devuelven en un cursor de flujo de cambios.

Solo puedes utilizar $changeStreamSplitLargeEvent en un pipeline $changeStream y debe ser la etapa final del pipeline.

Devuelve estadísticas sobre una colección o vista.

Devuelve un recuento del número de documentos en esta etapa del pipeline de agregación.

Distinto del acumulador de agregación $count.

Crea nuevos documentos en una secuencia de documentos donde faltan ciertos valores en un campo.

Devuelve documentos literales a partir de expresiones de entrada.

Procesa múltiples canalizaciones de agregación dentro de una sola etapa en el mismo conjunto de documentos de entrada. Permite la creación de agregaciones multifacéticas capaces de caracterizar datos a través de múltiples dimensiones, o facetas, en una sola etapa.

Rellena null y los valores de campo faltantes dentro de los documentos.

Devuelve un flujo ordenado de documentos en función de la proximidad a un punto geoespacial. Incorpora la funcionalidad de $match, $sort y $limit para datos geoespaciales. Los documentos de salida incluyen un campo adicional de distancia y pueden incluir un campo de identificador de ubicación.

Realiza una búsqueda recursiva en una colección. A cada documento de salida, agrega un nuevo campo de arreglo que contenga los resultados del recorrido de la búsqueda recursiva para ese documento.

Agrupa los documentos de entrada mediante una expresión de identificador específica y aplica la expresión del acumulador, si se especifica, a cada grupo. Consume todos los documentos de entrada y produce un documento por cada grupo distinto. Los documentos de salida solo contienen el campo identificador y, si se especifica, los campos acumulados.

Devuelve estadísticas sobre el uso de cada índice de la colección.

Pasa los primeros n documentos sin modificar al pipeline donde n es el límite especificado. Para cada documento de entrada, se genera un documento (para los primeros n documentos) o cero documentos (después de los primeros n documentos).

Devuelve información sobre los índices de Atlas Search existentes en una colección específica.

Enumera todas las sesiones que han estado activas el tiempo suficiente para propagarse a la colección system.sessions.

Realiza un left outer join a otra colección en la misma base de datos para filtrar documentos de la colección "unida" para su procesamiento.

Filtra el flujo de documentos para permitir que solo los documentos coincidentes pasen sin modificaciones a la siguiente etapa del pipeline. $match utiliza consultas estándar de MongoDB. Para cada documento de entrada, se genera un documento (si hay coincidencia) o cero documentos (si no hay coincidencia).

Guarda los documentos resultantes del pipeline de agregación en una colección. La etapa puede incorporar (insertar nuevos documentos, fusionar documentos, reemplazar documentos, conservar documentos existentes, fallar la operación, procesar documentos con un pipeline de actualización personalizado) los resultados en una colección de salida. Para usar la etapa $merge, debe ser la última etapa del pipeline.

Guarda los documentos resultantes del pipeline de agregación en una colección. Para usar la etapa $out, debe ser la última etapa del pipeline.

Devuelve información de la caché de planes para una colección.

Reestructura cada documento del flujo, por ejemplo, agregando nuevos campos o removiendo los existentes. Para cada documento de entrada, genera un documento.

Consulta también $unset para remover campos existentes.

Devuelve estadísticas de tiempo de ejecución para los query registrados.

ADVERTENCIA: La etapa de agregación $queryStats no es compatible y no se garantiza que sea estable en una versión futura. No desarolles funcionalidades que dependan de un formato de salida específico de esta etapa, ya que la salida puede cambiar en una versión futura.

Reconfigura cada documento en la secuencia restringiendo el contenido de cada documento según la información almacenada en los propios documentos. Incorpora la funcionalidad de $project y $match. Se puede utilizar para implementar la restricción a nivel de campo. Para cada documento de entrada, genera uno o cero documentos.

Reemplaza un documento con el documento incrustado específico. La operación reemplaza todos los campos existentes en el documento de entrada, incluido el campo _id. Especifique un documento incrustado en el documento de entrada para elevar el documento incrustado al nivel superior.

$replaceWith es un alias para la etapa $replaceRoot.

Reemplaza un documento con el documento incrustado específico. La operación reemplaza todos los campos existentes en el documento de entrada, incluido el campo _id. Especifique un documento incrustado en el documento de entrada para elevar el documento incrustado al nivel superior.

$replaceWith es un alias para la etapa $replaceRoot.

Selecciona aleatoriamente el número específico de documentos de su entrada.

Realiza una búsqueda de texto completo de los campos en una colección de Atlas.

$search Solo está disponible para clústeres de MongoDB Atlas y no para implementaciones autogestionadas. Para obtener más información, consulte Etapas de la canalización de agregación de búsquedas en Atlas.

Devuelve diferentes tipos de documentos de resultados de metadatos para la consulta de búsqueda de Atlas en una colección de Atlas.

$searchMeta Solo está disponible para clústeres de MongoDB Atlas y no para implementaciones autogestionadas. Para obtener más información, consulte Etapas de la canalización de agregación de búsquedas en Atlas.

Agrega nuevos campos a los documentos. De forma similar a $project, $set transforma cada documento en el flujo; específicamente, agregando nuevos campos a los documentos de salida que contienen tanto los campos existentes de los documentos de entrada como los nuevos campos agregados.

$set es un alias para la etapa $addFields.

Agrupa documentos en ventanas y aplica uno o más operadores a los documentos en cada ventana.

Omite los primeros documentos n, donde n es el número de omisión especificado, y pasa los documentos restantes sin modificar al pipeline. Para cada documento de entrada, se genera cero documentos (para los primeros documentos n) o un documento (después de los primeros documentos n).

Reordena el flujo de documentos por una clave de ordenación específica. Solo cambia el orden; los documentos permanecen sin modificar. Para cada documento de entrada, genera un documento.

Agrupa los documentos entrantes según el valor de una expresión especificada y luego calcula el número de documentos en cada grupo distinto.

Realiza una unión de dos colecciones, es decir, combina los resultados de la canalización de dos colecciones en un único conjunto de resultados.

Remueve/excluye campos de los documentos.

$unset es un alias para la etapa $project que elimina campos.

Descompone un campo de arreglo de los documentos de entrada para producir un documento por cada elemento. Cada documento de salida reemplaza el arreglo con un valor de elemento. Para cada documento de entrada, genera documentos n, donde n es el número de elementos del arreglo y puede ser cero para un arreglo vacío.

Realiza una Búsqueda ANN o ENN en un vector en el campo especificado de una colección Atlas.

$vectorSearch solo está disponible para clústeres de MongoDB Atlas que ejecuten MongoDB v6.0.11 o superior, y no está disponible para implementaciones autogestionadas.

$$NOW

Devuelve el valor de fecha y hora actual, que es el mismo en todos los miembros de la implementación y permanece constante durante todo el proceso de agregación. (Disponible en 4.2+)

$$CLUSTER_TIME

Devuelve el valor de la marca de tiempo actual, que es el mismo en todos los miembros de la implementación y permanece constante a lo largo de todo el pipeline de agregación. Solo para sets de réplicas y clústeres particionados. (Disponible en la versión 4.2+)

$$ROOT

Hace referencia al documento raíz, es decir, el documento de nivel superior.

$$CURRENT

Hace referencia al inicio de la ruta del campo, que por defecto es pero se puede ROOT cambiar.

$$REMOVE

Permite la exclusión condicional de campos. (Disponible en 3.6+)

$$DESCEND

Uno de los resultados permitidos de una $redact expresión.

$$PRUNE

Uno de los resultados permitidos de una $redact expresión.

$$KEEP

Uno de los resultados permitidos de una $redact expresió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.

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.

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 el primer elemento de la matriz. Es distinto del $first acumulador.

Devuelve un número especificado de elementos desde el inicio de un arreglo. Distinto del acumulador $firstN.

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. Si no se encuentra la substring, devuelve -1.

Determina si el operando es un arreglo. Devuelve un valor booleano.

Devuelve el último elemento de la matriz. Es distinto del $last acumulador.

Devuelve un número especificado de elementos desde el final de un arreglo. Distinto del acumulador $lastN.

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 n en un arreglo. Distinto del acumulador $maxN.

Devuelve los n valores más pequeños en un arreglo. Distinto del acumulador $minN.

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.

Devuelve 0 si los dos valores son equivalentes, 1 si el primer valor es mayor que el segundo y -1 si el primer valor es menor que el segundo.

Devuelve true si los valores son equivalentes.

Devuelve true si el primer valor es mayor que el segundo.

Devuelve true si el primer valor es mayor o igual que el segundo.

Devuelve true si el primer valor es menor que el segundo.

Devuelve true si el primer valor es menor que o igual al segundo.

Devuelve true si los valores no son equivalentes.

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 1 (lunes) al 7 (domingo).

Devuelve el número de la semana en formato ISO 8601, con un rango de 1 a 53. Los números de las semanas comienzan en 1 con la semana (de lunes a domingo) que contiene el primer jueves del año.

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).

Devuelve true si ningún elemento de un conjunto se evalúa como false; de lo contrario, devuelve false. Acepta una expresión con un único argumento.

Devuelve true si algún elemento de un conjunto se evalúa como true; de lo contrario, devuelve false. Acepta una expresión con un único argumento.

Devuelve un conjunto con elementos que aparecen en el primer conjunto pero no en el segundo, es decir, realiza un complemento relativo del segundo conjunto con respecto al primero. Acepta exactamente dos expresiones de argumento.

Devuelve true si los conjuntos de entrada tienen los mismos elementos únicos. Acepta dos o más expresiones de argumentos.

Devuelve un conjunto con elementos que aparecen en todos los conjuntos de entrada. Acepta cualquier cantidad de expresiones de argumentos.

Devuelve true si todos los elementos del primer conjunto aparecen en el segundo conjunto, incluso cuando el primer conjunto es igual al segundo conjunto; es decir, no es un subconjunto estricto. Acepta exactamente dos expresiones de argumentos.

Devuelve un conjunto con los elementos que aparecen en cualquiera de los conjuntos de entrada.

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 -1.

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 -1

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: 0 si dos strings son equivalentes, 1 si la primera string es mayor que la segunda y -1 si la primera string es menor que la segunda.

Obsoleto Se puede utilizar $substrBytes o $substrCP.

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.

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 y / x en radianes, donde y y x son el primer y el segundo valor que se pasan a la expresión respectivamente.

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.

Convierte un valor a un tipo especificado.

Devuelve un valor booleano true si la expresión especificada se resuelve en un integer, decimal, double, o long.

Devuelve un valor booleano false si la expresión se resuelve en cualquier otro tipo BSON, null, o si falta un campo.

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.

Devuelve el resultado de una función de acumulador definida por el usuario.

Devuelve un arreglo de valores de expresión únicos para cada grupo. El orden de los elementos del arreglo es indefinido.

Devuelve un promedio de valores numéricos. Ignora los valores no numéricos.

Devuelve el elemento más bajo dentro de un grupo según el orden de acomodo especificado.

Disponible en las etapas $group y $setWindowFields.

Devuelve una agregación de los campos n inferiores dentro de un grupo, según el orden de clasificación especificado.

Disponible en las etapas $group y $setWindowFields.

Devuelve la cantidad de documentos en un grupo.

Distinto de la etapa de canalización de $count.

Devuelve un valor del primer documento de cada grupo. El orden solo se define si los documentos están ordenados.

Distinto del $first operador de matriz.

Devuelve una agregación de los primeros elementos den dentro de un grupo. Solo es significativo cuando los documentos están en un orden definido. Distinto del operador de arreglo $firstN.

Devuelve un valor del último documento de cada grupo. El orden solo se define si los documentos están ordenados.

Distinto del $last operador de matriz.

Devuelve una agregación de los últimos elementos n dentro de un grupo. Solo es significativo cuando los documentos están en un orden definido. Distinto del operador de arreglo $lastN.

Devuelve el valor de la expresión más alto para cada grupo.

Devuelve una agregación de los elementos n con el valor máximo en un grupo. Distinto del operador de arreglo $maxN.

Disponible en $group, $setWindowFields y como una expresión.

Devuelve un documento creado al combinar los documentos de entrada para cada grupo.

Devuelve el valor de la expresión más bajo para cada grupo.

Devuelve una agregación de los n elementos de menor valor en un grupo. Distinto del operador de arreglo $minN.

Disponible en $group, $setWindowFields y como una expresión.

Devuelve un arreglo de valores de expresión para los documentos en cada grupo.

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.

Devuelve el elemento principal dentro de un grupo según el orden de acomodo especificado.

Disponible en las etapas $group y $setWindowFields.

Devuelve una agregación de los campos n principales dentro de un grupo, según el orden de clasificación especificado.

Disponible en las etapas $group y $setWindowFields.

Devuelve un promedio de la expresión o lista de expresiones especificada para cada documento. Ignora los valores no numéricos.

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 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.

Devuelve un arreglo de todos los valores únicos que resultan de aplicar una expresión a cada documento.

Devuelve el promedio de la expresión especificada. Ignora los valores no numéricos.

Devuelve el elemento más bajo dentro de un grupo según el orden de acomodo especificado.

Disponible en las etapas $group y $setWindowFields.

Devuelve una agregación de los campos n inferiores dentro de un grupo, según el orden de clasificación especificado.

Disponible en las etapas $group y $setWindowFields.

Devuelve la cantidad de documentos en el grupo o ventana.

Distinto de la etapa de canalización de $count.

Devuelve la covarianza poblacional de dos expresiones numéricas.

Devuelve la covarianza muestral de dos expresiones numéricas.

Devuelve la posición del documento (conocida como el rango) en relación con otros documentos en la etapa de partición $setWindowFields . No hay vacíos en las filas. Los empates reciben la misma clasificación.

Devuelve la tasa promedio de cambio dentro de la ventana especificada.

Devuelve la posición de un documento (conocido como número de documento) en la etapa de partición $setWindowFields . Los empates resultan en diferentes números de documentos adyacentes.

Devuelve la media móvil exponencial de la expresión numérica.

Devuelve el valor resultante de aplicar una expresión al primer documento de un grupo o ventana.

Devuelve la aproximación del área bajo una curva.

Devuelve el valor que resulta de aplicar una expresión al último documento de un grupo o ventana.

Completa null y los campos faltantes en una ventana usando interpolación lineal basada en los valores de los campos circundantes.

Disponible en la etapa $setWindowFields.

Última observación llevada hacia adelante. Establece los valores para null y los campos ausentes en una ventana al último valor no nulo del campo.

Disponible en la etapa $setWindowFields.

Devuelve el valor máximo que resulta de aplicar una expresión a cada documento.

Devuelve el valor mínimo que resulta de aplicar una expresión a cada documento.

Devuelve una agregación de los n elementos de menor valor en un grupo. Distinto del operador de arreglo $minN.

Disponible en $group, $setWindowFields y como una expresión.

Devuelve un arreglo de valores que resultan de aplicar una expresión a cada documento.

Devuelve la posición del documento (conocida como rango) en relación con otros documentos en la partición de la etapa $setWindowFields .

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 $setWindowFields .

Devuelve la desviación estándar de la población que resulta de aplicar una expresión numérica a cada documento.

Devuelve la desviación estándar de la muestra que resulta de aplicar una expresión numérica a cada documento.

Devuelve la suma que resulta de aplicar una expresión numérica a cada documento.

Devuelve el elemento principal dentro de un grupo según el orden de acomodo especificado.

Disponible en las etapas $group y $setWindowFields.

Devuelve una agregación de los campos n principales dentro de un grupo, según el orden de clasificación especificado.

Disponible en las etapas $group y $setWindowFields.