Definición
Devuelve el valor máximo de un arreglo.
Nota
Desambiguación
Esta página describe $max cuando se utiliza como una expresión, que devuelve el valor máximo de un arreglo o una lista de valores.
También puede usar $max en estos otros contextos:
$max (accumulator), que devuelve un único valor agregado basado en un número variable de documentos de entrada.$max (window function), que se utiliza en la etapa$setWindowFieldspara devolver el valor máximo de documentos en una ventana determinada.
Sintaxis
{ $max: <expression> }El expression debe evaluarse como un arreglo.
Comportamiento
Tipo de resultado
$max compara los datos de entrada siguiendo el orden de comparación BSON para determinar el tipo de resultado adecuado. Cuando los datos de entrada contienen múltiples tipos de datos, el tipo de salida $max es el más alto en el orden de comparación.
Valores nulos y faltantes
Si algunos, pero no todos, los valores de entrada para $max son null o faltan, $max solo considera los valores no nulos y no ausentes.
Si **todos** los valores de entrada para $max son null o faltan, $max nulldevuelve.
Arreglo Operand
Con una única expresión como operando, si la expresión se resuelve en un arreglo, $max recorre el arreglo para encontrar el valor máximo.
Con una lista de expresiones como su operando, si alguna expresión se resuelve en un arreglo, $max no recorre ese arreglo y en su lugar compara el arreglo en su totalidad.
Ejemplo
Los ejemplos de esta página utilizan datos del conjunto de datos sample_mflix. Para obtener más información sobre cómo cargar este conjunto de datos en la implementación autogestionada de MongoDB, consultar Cargar el conjunto de datos de muestra. Si realizó alguna modificación en las bases de datos de muestra, es posible que deba descartar y volver a crear las bases de datos para ejecutar los ejemplos de esta página.
El siguiente ejemplo utiliza $max en la etapa $project para encontrar la calificación más alta de cada película en tres fuentes de calificación: IMDb, Rotten Tomatoes (espectador) y Rotten Tomatoes (crítico):
db.movies.aggregate( [ { $match: { title: { $in: [ "The Godfather", "Schindler's List", "The Dark Knight" ] }, "imdb.rating": { $gt: 0 }, "tomatoes.viewer.rating": { $gt: 0 }, "tomatoes.critic.rating": { $gt: 0 } } }, { $project: { _id: 0, title: 1, highestRating: { $max: [ "$imdb.rating", "$tomatoes.viewer.rating", "$tomatoes.critic.rating" ] } } }, { $sort: { title: 1 } }] )El pipeline anterior:
Utiliza
$matchpara filtrar tres películas específicas que tienen calificaciones válidas de las tres fuentes.Utiliza
$projectcon$maxy una lista de expresiones para calcular la calificación más alta entreimdb.rating,tomatoes.viewer.ratingytomatoes.critic.ratingpara cada película.Ordena la salida alfabéticamente por título.