Definition定义
$linearFillNew in version 5.3.在版本5.3中新增。Fills使用基于周围字段值的线性插值填充nulland missing fields in a window using linear interpolation based on surrounding field values.window中的null字段和缺失字段。$linearFillis only available in the$setWindowFieldsstage.$linearFill仅在$setWindowFields阶段可用。
Syntax语法
The $linearFill expression has this syntax:$linearFill表达式具有以下语法:
{ $linearFill: <expression> }
For more information on expressions, see Expressions.有关表达式的详细信息,请参阅表达式。
Behavior行为
$linearFill fills null and missing fields using linear interpolation based on surrounding non-null field values. $linearFill使用基于周围非空字段值的线性插值来填充空字段和缺失字段。The surrounding field values are determined by the sort order specified in 周围的字段值由$setWindowFields.$setWindowFields中指定的排序顺序决定。
$linearFillfillsnulland missing values proportionally spanning the value range between surrounding non-nullvalues.$linearFill按比例填充null值和缺失值,覆盖周围非null值之间的值范围。To determine the values for missing fields,要确定缺失字段的值,$linearFilluses:$linearFill使用:The difference of surrounding non-周围非nullvalues.null值的差异。The number of要在周围值之间填充的nullfields to fill between the surrounding values.null字段数。
如果根据$linearFillcan fill multiple consecutivenullvalues if those values are preceded and followed by non-nullvalues according to the sort order specified in$setWindowFields.$setWindowFields中指定的排序顺序,这些值前后都有非null值,则$linearFill可以填充多个连续的null值。Example示例If a collection contains these documents:如果集合包含以下文档:{ index: 0, value: 0 },
{ index: 1, value: null },
{ index: 2, value: null },
{ index: 3, value: null },
{ index: 4, value: 10 }After using使用$linearFillto fill thenullvalues, the documents become:$linearFill填充null值后,文档变为:{ index: 0, value: 0 },
{ index: 1, value: 2.5 },
{ index: 2, value: 5 },
{ index: 3, value: 7.5 },
{ index: 4, value: 10 }前后没有非nullvalues that are not preceded and followed by non-nullvalues remainnull.null值的null值仍为null。
Comparison of $fill and $linearFill$fill和$linearFill的比较
$fill and $linearFillTo fill missing field values using linear interpolation, you can use:要使用线性插值填充缺失的字段值,可以使用:
The
$fillstage with{ method: "linear" }.When you use the当您使用$fillstage, the field you specify in the output is the same field used as the source data.$fill阶段时,您在输出中指定的字段与源数据使用的字段相同。See Fill Missing Field Values with Linear Interpolation.请参见使用线性插值填充缺失字段值。The$linearFilloperator inside of a$setWindowFieldsstage.$setWindowFields阶段内的$linearFill运算符。When you use the使用$linearFilloperator, you can set values for a different field than the field used as the source data. See Use Multiple Fill Methods in a Single Stage.$linearFill运算符时,可以为与用作源数据的字段不同的字段设置值。请参见在单个阶段中使用多种填充方法。
Examples示例
The examples on this page use a 此页面上的示例使用了一个stock collection that contains tracks a single company's stock price at hourly intervals:stock集合,其中包含每小时跟踪一家公司股票价格的信息:
db.stock.insertMany( [
{
time: ISODate("2021-03-08T09:00:00.000Z"),
price: 500
},
{
time: ISODate("2021-03-08T10:00:00.000Z"),
},
{
time: ISODate("2021-03-08T11:00:00.000Z"),
price: 515
},
{
time: ISODate("2021-03-08T12:00:00.000Z")
},
{
time: ISODate("2021-03-08T13:00:00.000Z")
},
{
time: ISODate("2021-03-08T14:00:00.000Z"),
price: 485
}
] )
The 集合中的某些文档缺少price field is missing for some of the documents in the collection.price字段。
Fill Missing Values with Linear Interpolation用线性插值填充缺失值
To populate the missing 要使用线性插值填充缺失的price values using linear interpolation, use $linearFill inside of a $setWindowFields stage:price值,请在$setWindowFields阶段中使用$linearFill:
db.stock.aggregate( [
{
$setWindowFields:
{
sortBy: { time: 1 },
output:
{
price: { $linearFill: "$price" }
}
}
}
] )
In the example:在示例中:
sortBy: { time: 1 }sorts the documents by the按timefield in ascending order, from earliest to latest.time字段从早到晚按升序对文档进行排序。outputspecifies:指定:priceas the field for which to fill in missing values.作为填写缺失值的字段。{ $linearFill: "$price" }as the value for the missing field.作为缺失字段的值。$linearFillfills missingpricevalues using linear interpolation based on the surroundingpricevalues in the sequence.$linearFill使用基于序列中周围price值的线性插值来填充缺失的price值。
Example output:示例输出:
[
{
_id: ObjectId("620ad555394d47411658b5ef"),
time: ISODate("2021-03-08T09:00:00.000Z"),
price: 500
},
{
_id: ObjectId("620ad555394d47411658b5f0"),
time: ISODate("2021-03-08T10:00:00.000Z"),
price: 507.5
},
{
_id: ObjectId("620ad555394d47411658b5f1"),
time: ISODate("2021-03-08T11:00:00.000Z"),
price: 515
},
{
_id: ObjectId("620ad555394d47411658b5f2"),
time: ISODate("2021-03-08T12:00:00.000Z"),
price: 505
},
{
_id: ObjectId("620ad555394d47411658b5f3"),
time: ISODate("2021-03-08T13:00:00.000Z"),
price: 495
},
{
_id: ObjectId("620ad555394d47411658b5f4"),
time: ISODate("2021-03-08T14:00:00.000Z"),
price: 485
}
]Use Multiple Fill Methods in a Single Stage在单个阶段中使用多种填充方法
When you use the 当您使用$setWindowFields stage to fill missing values, you can set values for a different field than the field you fill from. $setWindowFields阶段填充缺失的值时,您可以为与填充字段不同的字段设置值。As a result, you can use multiple fill methods in a single 因此,您可以在单个$setWindowFields stage and output the results in distinct fields.$setWindowFields阶段中使用多个填充方法,并在不同的字段中输出结果。
The following pipeline populates missing 以下管道使用线性插值和最后一次观测结转方法填充缺失的price fields using linear interpolation and the last-observation-carried-forward method:price字段:
db.stock.aggregate( [
{
$setWindowFields:
{
sortBy: { time: 1 },
output:
{
linearFillPrice: { $linearFill: "$price" },
locfPrice: { $locf: "$price" }
}
}
}
] )
In the example:在示例中:
sortBy: { time: 1 }sorts the documents by the按timefield in ascending order, from earliest to latest.time字段从早到晚按升序对文档进行排序。outputspecifies:指定:linearFillPriceas a target field to be filled.作为要填充的目标字段。{ $linearFill: "$price" }is the value for the是linearFillPricefield.linearFillPrice字段的值。$linearFillfills missingpricevalues using linear interpolation based on the surroundingpricevalues in the sequence.$linearFill使用基于序列中周围price值的线性插值来填充缺失的price值。
locfPriceas a target field to be filled.作为要填充的目标字段。{ $locf: "$price" }is the value for the是locfPricefield.locfstands for last observation carried forward.$locffills missingpricevalues with the value from the previous document in the sequence.locfPrice字段的值。locf代表最后的观测结果。$locf用序列中前一个文档的值填充缺失的price值。
Example output:示例输出:
[
{
_id: ObjectId("620ad555394d47411658b5ef"),
time: ISODate("2021-03-08T09:00:00.000Z"),
price: 500,
linearFillPrice: 500,
locfPrice: 500
},
{
_id: ObjectId("620ad555394d47411658b5f0"),
time: ISODate("2021-03-08T10:00:00.000Z"),
linearFillPrice: 507.5,
locfPrice: 500
},
{
_id: ObjectId("620ad555394d47411658b5f1"),
time: ISODate("2021-03-08T11:00:00.000Z"),
price: 515,
linearFillPrice: 515,
locfPrice: 515
},
{
_id: ObjectId("620ad555394d47411658b5f2"),
time: ISODate("2021-03-08T12:00:00.000Z"),
linearFillPrice: 505,
locfPrice: 515
},
{
_id: ObjectId("620ad555394d47411658b5f3"),
time: ISODate("2021-03-08T13:00:00.000Z"),
linearFillPrice: 495,
locfPrice: 515
},
{
_id: ObjectId("620ad555394d47411658b5f4"),
time: ISODate("2021-03-08T14:00:00.000Z"),
price: 485,
linearFillPrice: 485,
locfPrice: 485
}
]Restrictions限制
To use要使用$linearFill, you must use the sortBy field to sort your data.$linearFill,您必须使用sortBy字段对数据进行排序。When using使用$linearFillwindow function,$setWindowFieldsreturns an error if there are any repeated values in the sortBy field in a single partition.$linearFill窗口函数时,如果单个分区中的sortBy字段中有任何重复值,$setWindowFields将返回错误。