Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu

Ejecuta Pipelines de agregación en tus datos

Las pipelines de agregación transforman los documentos en un conjunto agregado de resultados. En Atlas Charts, los pipelines de agregación se usan comúnmente para visualizar nuevos campos creados a partir de resultados calculados de campos preexistentes, pero también tienen muchas otras aplicaciones.

Para crear un pipeline de agregación:

  1. En la barra Query, introduce un pipeline de agregación. Tu pipeline debe estar entre corchetes.

  2. (Opcional) Selecciona Format para organizar la query como sigue:

    • Divida la query en varias líneas

    • Indenta la query según las convenciones de JSON

  3. (Condicional) Si seleccionó la opción Format, haz clic en Close cuando termines.

  4. Haga clic en Apply para ejecutar su pipeline.

El siguiente gráfica muestra los importes totales de ventas de una empresa de suministros de oficina, categorizados por ubicación de la tienda. La gráfica utiliza el siguiente pipeline de agregación en la barra Query:

[
{
$unwind: "$items"
},
{
$addFields: {
saleAmount: {
$multiply: [ "$items.price", "$items.quantity" ]
}
}
}
]

Esta pipeline de agregación procesa los datos de la colección utilizando el siguiente orden:

  1. La etapa $unwind desenrolla el arreglo items y genera un nuevo documento para cada elemento del arreglo. Cada elemento del arreglo items contiene un solo artículo vendido durante una transacción.

  2. La $addFields etapa agrega un nuevo campo a los documentos llamado saleAmount. La expresión $multiply establece que el valor de saleAmount se asigna como el producto de items.price y items.quantity. Puedes ver este nuevo campo resaltado en la siguiente captura de pantalla:

Ejemplo de pipeline de agregación
haga clic para ampliar

Una vez que los datos han sido procesados usando la pipeline, la gráfica muestra el Sum de todos saleAmounts categorizados por ubicación de tienda.

Si tu agregación no es válida, Charts muestra el ícono en la barra Query.

Haz clic en la barra Query si no se muestra ya para ver los detalles del error. Charts muestra detalles del error para:

  • Errores del lado del cliente, como JSON mal formados, y

  • Errores del lado del servidor, como MQL inválidos o etapas de pipeline no admitidas.

Error de ejemplo en el pipeline de agregación
haga clic para ampliar

Revisa los detalles del error, y ajusta adecuadamente la pipeline de agregación.

  • Charts no admite el operador $lookup en consultas de agregación. Sin embargo, puede utilizar este operador en los pipelines de Fuente de datos. Para obtener más información sobre cómo usar los pipelines para preprocesar datos antes de que lleguen al constructor de gráficas, consulta Crear y gestionar vistas de gráficos.

  • Charts admiten el operador $function solo cuando se define el cuerpo de la función en una sola línea y se encierra entre comillas double. Para utilizar este operador en tus consultas de agregación, debes usar la siguiente sintaxis:

    {
    $function: {
    body: "function(arg1, arg2, ...) { ... }",
    args: <array expression>,
    lang: "js"
    }
    }