$fill

  • Se aplica a: ✅ Azure DocumentDB

La fase $fill se usa para rellenar los valores que faltan o null en documentos dentro de la canalización de agregación. Proporciona varios métodos para rellenar los datos que faltan, incluido el uso de valores estáticos, interpolación lineal o valores de documentos anteriores o siguientes.

Syntax

{
  $fill: {
    sortBy: <sort specification>,
    partitionBy: <partition fields>,
    partitionByFields: <array of partition field names>,
    output: {
      <field1>: { value: <expression> },
      <field2>: { method: <string> }
    }
  }
}

Parámetros

Parámetro Description
sortBy Especifica el criterio de ordenación de los documentos al aplicar métodos de relleno que dependen del orden del documento.
partitionBy Optional. Agrupa documentos en particiones. Las operaciones de relleno se aplican dentro de cada partición por separado.
partitionByFields Optional. Sintaxis alternativa para partitionBy mediante una matriz de nombres de campo.
output Especifica los campos que se van a rellenar y el método o valor que se va a usar para rellenar los datos que faltan.

Métodos de relleno

Método Description
value Rellenar con un valor estático especificado o el resultado de una expresión.
linear Rellenar con interpolación lineal entre valores conocidos (solo campos numéricos).
locf Última observación llevada hacia adelante: use el último valor conocido.
linear Interpolación lineal entre los valores circundantes.

Examples

Considere este documento de ejemplo de la colección de tiendas.

{
  "_id": "2cf3f885-9962-4b67-a172-aa9039e9ae2f",
  "name": "First Up Consultants | Bed and Bath Center - South Amir",
  "location": {
    "lat": 60.7954,
    "lon": -142.0012
  },
  "staff": {
    "totalStaff": {
      "fullTime": 18,
      "partTime": 17
    }
  },
  "sales": {
    "totalSales": 37701,
    "salesByCategory": [
      {
        "categoryName": "Mattress Toppers",
        "totalSales": 37701
      }
    ]
  },
  "promotionEvents": [
    {
      "eventName": "Price Drop Palooza",
      "promotionalDates": {
        "startDate": {
          "Year": 2024,
          "Month": 9,
          "Day": 21
        },
        "endDate": {
          "Year": 2024,
          "Month": 9,
          "Day": 30
        }
      },
      "discounts": [
        {
          "categoryName": "Bath Accessories",
          "discountPercentage": 18
        },
        {
          "categoryName": "Pillow Top Mattresses",
          "discountPercentage": 17
        }
      ]
    }
  ]
}

Ejemplo 1: Rellenar los valores que faltan con el valor estático

Esta consulta rellena los valores que faltan totalSales en la salesByCategory matriz con un valor predeterminado de 0.

db.stores.aggregate([{
    $match: {
        company: {
            $in: ["First Up Consultants"]
        }
    }
}, {
    $unwind: "$sales.salesByCategory"
}, {
    $fill: {
        output: {
            "sales.salesByCategory.totalSales": {
                value: 0
            }
        }
    }
}, {
    $group: {
        _id: "$_id",
        name: {
            $first: "$name"
        },
        salesByCategory: {
            $push: "$sales.salesByCategory"
        }
    }
}])

Los dos primeros resultados devueltos por esta consulta son:

[
    {
        "_id": "affdc09c-7356-4fff-a857-e8301f57159c",
        "name": "First Up Consultants | Sports Gear Pantry - Wildermanhaven",
        "salesByCategory": [
            {
                "categoryName": "Baseball Gear",
                "totalSales": 33878
            },
            {
                "categoryName": "Volleyball Gear",
                "totalSales": 34031
            }
        ]
    },
    {
        "_id": "1cf667b4-d8ce-4f1a-bad1-a1f0bbce26c2",
        "name": "First Up Consultants | Picture Frame Variety - New Abrahamborough",
        "salesByCategory": [
            {
                "categoryName": "Picture Hanging Supplies",
                "totalSales": 7229
            },
            {
                "categoryName": "Collage Frames",
                "totalSales": 40014
            }
        ]
    }
]

Ejemplo 2: Rellenar los datos del personal que faltan usando la última observación retenida

Esta consulta rellena los datos del personal de tiempo parcial que faltan mediante el último valor conocido dentro de cada grupo de almacenes.

db.stores.aggregate([{
    $fill: {
        sortBy: {
            "_id": 1
        },
        output: {
            "staff.totalStaff.partTime": {
                method: "locf"
            }
        }
    }
}, {
    $project: {
        name: 1,
        "staff.totalStaff": 1
    }
}])

Los dos primeros resultados devueltos por esta consulta son:

[
    {
        "_id": "00003278-4226-4ca7-871d-e80d8f414431",
        "name": "Wide World Importers | Camera Depot - Lake Luramouth",
        "staff": {
            "totalStaff": {
                "fullTime": 20,
                "partTime": 6
            }
        }
    },
    {
        "_id": "00009bd0-c44e-4cc8-ab03-347076d74a1a",
        "name": "Wide World Importers | Music Stop - Rebeccaside",
        "staff": {
            "totalStaff": {
                "fullTime": 9,
                "partTime": 0
            }
        }
    }
]

Ejemplo 3: Rellenar porcentajes de descuento que faltan con el valor medio

Esta consulta rellena los porcentajes de descuento que faltan con el porcentaje de descuento medio en todas las tiendas.

db.stores.aggregate([
  { $unwind: "$promotionEvents" },
  { $unwind: "$promotionEvents.discounts" },
  {
    $fill: {
      partitionBy: "$promotionEvents.eventName",
      sortBy: { "promotionEvents.discounts.categoryName": 1 },
      output: {
        "promotionEvents.discounts.discountPercentage": { 
          value: { $avg: "$promotionEvents.discounts.discountPercentage" } 
        }
      }
    }
  },
  {
    $group: {
      _id: { storeId: "$_id", eventName: "$promotionEvents.eventName" },
      storeName: { $first: "$name" },
      eventName: { $first: "$promotionEvents.eventName" },
      discounts: { $push: "$promotionEvents.discounts" }
    }
  }
])

Los dos primeros resultados devueltos por esta consulta son:

[
    {
        "_id": {
            "storeId": "70d4cc90-23b1-46e3-8f59-630648e311a4",
            "eventName": "Price Slash Spectacular"
        },
        "storeName": "Wide World Importers | Music Bazaar - West Johnpaulhaven",
        "eventName": "Price Slash Spectacular",
        "discounts": [
            {
                "categoryName": "CDs",
                "discountPercentage": 22
            },
            {
                "categoryName": "Vinyl Records",
                "discountPercentage": 21
            }
        ]
    },
    {
        "_id": {
            "storeId": "24873ac4-b2d1-4216-a425-3375a384b23d",
            "eventName": "Massive Deal Mania"
        },
        "storeName": "Northwind Traders | Furniture Pantry - Farrellchester",
        "eventName": "Massive Deal Mania",
        "discounts": [
            {
                "categoryName": "Bookcases",
                "discountPercentage": 22
            },
            {
                "categoryName": "Cabinets",
                "discountPercentage": 8
            }
        ]
    }
]

Casos de uso

  • Limpieza de datos: rellenar los valores que faltan en los conjuntos de datos importados
  • Datos de serie temporal: controlar brechas en los datos secuenciales mediante interpolación
  • Valores predeterminados: asignar valores predeterminados a campos opcionales
  • Normalización de datos: garantizar una estructura de datos coherente entre documentos
  • Last updated on