/ /

$ 项目（聚合阶段）

定义

$project

将带有请求字段的文档传递到管道的下一阶段。指定的字段可以是输入文档中的现有字段，也可以是新的计算字段。

$project 可以：

包括输入文档中的字段。
抑制 _id字段。
添加新字段或重置现有字段的值。
从输入文档中排除字段。

兼容性

可以使用 $project 查找托管在以下环境中的部署：

MongoDB Atlas ：用于在云中部署MongoDB 的完全托管服务

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

$project 采用以下形式：

{ $project: { <specification(s)> } }

$project 规范具有以下形式：

形式	说明
`<field>: <1 or true>`	指定包含字段。非零整数也被视为 `true`。
`_id: <0 or false>`	指定抑制 `_id`字段。要有条件地排除字段，请改用 `REMOVE` 变量。有关详细信息，请参阅有条件地排除字段。
`<field>: <expression>`	添加新字段或重置现有字段的值。如果表达式的计算结果为 `$$REMOVE`，则在输出中排除该字段。有关详细信息，请参阅有条件地排除字段。
`<field>: <0 or false>`	指定排除字段。要有条件地排除字段，请改用 `REMOVE` 变量。有关详细信息，请参阅有条件地排除字段。如果指定排除 `_id` 以外的字段，则不能使用任何其他 `$project` 规范。此限制不适应用使用 `REMOVE` 变量对字段进行条件排除。要排除字段，还可以使用 `$unset` 阶段。

行为

包含字段

默认下，输出文档包含 _id字段。要包含输入文档中的其他字段，请在 $project 中明确指定这些字段。
如果指定包含文档中不存在的字段，$project 将忽略该字段包含，并且不会将该字段添加到文档中。

_id字段

默认下，_id字段包含在输出文档中。要从输出文档中排除 _id字段，您必须显式抑制 $project 中的 _id字段。

排除字段

如果排除一个字段，则所有其他字段都会出现在输出文档中。

{ $project: { "<field1>": 0, "<field2>": 0, ... } } // Return all but the specified fields

如果排除 _id 以外的字段，则无法使用其他 $project 规范形式。如果排除字段，则无法同时指定包含字段、重置现有字段的值或添加新字段。此限制不适应用使用 REMOVE 变量对字段进行条件排除。

要排除字段，也可以使用 $unset。

有条件地排除字段

您可以在聚合表达式中使用变量 REMOVE 有条件地抑制字段。有关示例，请参阅有条件地排除字段。

添加新字段或重置现有字段

注意

MongoDB 还提供 $addFields 向文档添加新字段。

要添加新字段或重置现有字段的值，请指定字段名称并将其值设立为表达式。有关表达式的更多信息，请参阅表达式。

字面值

要将字段设立为数字或布尔文字，而不是解析为文字的表达式，请使用 $literal操作符。否则，$project 将该字面量视为包含或排除字段的标志。

字段重命名

有效地重命名字段的方式：指定新字段并将其值设置为现有字段的字段路径。

新的数组字段

$project 阶段支持使用方括号 [] 直接创建新的大量字段。如果指定文档中不存在的大量字段，则该操作会将 null 替换为该字段的值。有关示例，请参阅投影新的数组字段。

不能将大量索引与 $project 阶段一起使用。

嵌入式文档字段

要在嵌入式文档中项目、添加或重置字段，可以使用点表示法：

"contact.address.country": <1 or 0 or expression>

您还可以嵌套字段：

contact: { address: { country: <1 or 0 or expression> } }

嵌套字段时，不能在嵌入式文档中使用点表示法来指定字段。示例，contact: { "address.country": <1 or 0 or expression> } 无效。

嵌入式字段中的路径冲突错误

不能在同一投影中同时指定嵌入式文档和嵌入式文档中的字段。

以下 $project 阶段失败并显示 Path collision 错误，因为它尝试项目嵌入式 contact文档和 contact.address.country字段：

{ $project: { contact: 1, "contact.address.country": 1 } }

无论指定父字段和嵌入式字段的顺序如何，都会发生错误。以下 $project 失败并出现相同的错误：

{ $project: { "contact.address.country": 1, contact: 1 } }

$ 项目阶段布局

当您使用 $project 阶段时，它通常应该是管道中的最后一个阶段，用于指定要返回给客户端的字段。

在管道的开头或中间使用 $project 阶段来减少传递到后续管道阶段的字段数量不太可能提高性能，因为数据库会自动执行此优化。

空规格

如果向 $project 阶段传递了空文档，MongoDB会返回错误。

示例，以下管道会返回错误：

db.myCollection.aggregate( [ {
   $project: { }
} ] )

数组索引

不能将大量索引与 $project 阶段一起使用。

示例

本页上的示例使用 sample_mflix 数据集中的数据。有关如何将此数据集加载到自管理MongoDB 部署中的详细信息，请参阅加载样本数据集。如果对示例数据库进行了任何修改，则可能需要删除并重新创建数据库才能运行本页上的示例。

在输出文档中包含特定字段

以下 $project 阶段仅包括 _id、title 和 rated 字段：

db.movies.aggregate( [
   { $match: { title: "The Great Train Robbery" } },
   { $project: { title: 1, rated: 1 } },
   { $limit: 1 }
] )

[
  {
    _id: ObjectId('573a1390f29313caabcd42e8'),
    title: 'The Great Train Robbery',
    rated: 'TV-G'
  }
]

抑制输出文档中的_id字段

MongoDB默认包含 _id字段。要将 _id字段从 $project 阶段排除，请在投影文档中将 _id字段设立为 0。

以下 $project 阶段不包括 _id字段，但包括 title 和 rated 字段：

db.movies.aggregate( [
   { $match: { title: "The Great Train Robbery" } },
   { $project : { _id: 0, title : 1, rated : 1 } },
   { $limit: 1 }
] )

[ { title: 'The Great Train Robbery', rated: 'TV-G' } ]

从输出文档中排除字段

以下 $project 阶段会从输出中排除 rated字段：

db.movies.aggregate( [
   { $match: { title: "The Great Train Robbery" } },
   { $project : { "rated": 0 } },
   { $limit: 1 }
] )

或者，使用$unset阶段排除字段。

从嵌入式文档中排除字段

以下 $project 阶段会从输出中排除 imdb.id 和 type 字段：

db.movies.aggregate( [
   { $match: { title: "The Great Train Robbery" } },
   { $project: { "imdb.id": 0, "type": 0 } },
   { $limit: 1 }
] )

[
  {
    _id: ObjectId('573a1390f29313caabcd42e8'),
    plot: 'A group of bandits stage a brazen train hold-up, only to find a determined posse hot on their heels.',
    genres: [ 'Short', 'Western' ],
    runtime: 11,
    cast: [
      'A.C. Abadie',
      "Gilbert M. 'Broncho Billy' Anderson",
      'George Barnes',
      'Justus D. Barnes'
    ],
    poster: 'https://m.media-amazon.com/images/M/MV5BMTU3NjE5NzYtYTYyNS00MDVmLWIwYjgtMmYwYWIxZDYyNzU2XkEyXkFqcGdeQXVyNzQzNzQxNzI@._V1_SY1000_SX677_AL_.jpg',
    title: 'The Great Train Robbery',
    fullplot: "Among the earliest existing films in American cinema - notable as the first film that presented a narrative story to tell - it depicts a group of cowboy outlaws who hold up a train and rob the passengers. They are then pursued by a Sheriff's posse. Several scenes have color included - all hand tinted.",
    languages: [ 'English' ],
    released: ISODate('1903-12-01T00:00:00.000Z'),
    directors: [ 'Edwin S. Porter' ],
    rated: 'TV-G',
    awards: { wins: 1, nominations: 0, text: '1 win.' },
    lastupdated: '2015-08-13 00:27:59.177000000',
    year: 1903,
    imdb: { rating: 7.4, votes: 9847 },
    countries: [ 'USA' ],
    tomatoes: {
      viewer: { rating: 3.7, numReviews: 2559, meter: 75 },
      fresh: 6,
      critic: { rating: 7.6, numReviews: 6, meter: 100 },
      rotten: 0,
      lastUpdated: ISODate('2015-08-08T19:16:10.000Z')
    },
    num_mflix_comments: 0
  }
]

或者，您可以在文档中嵌套排除规范：

db.movies.aggregate( [
   { $match: { title: "The Great Train Robbery" } },
   { $project: { "imdb": { "id": 0 }, "type" : 0 } },
   { $limit: 1 }
] )

[
  {
    _id: ObjectId('573a1390f29313caabcd42e8'),
    plot: 'A group of bandits stage a brazen train hold-up, only to find a determined posse hot on their heels.',
    genres: [ 'Short', 'Western' ],
    runtime: 11,
    cast: [
      'A.C. Abadie',
      "Gilbert M. 'Broncho Billy' Anderson",
      'George Barnes',
      'Justus D. Barnes'
    ],
    poster: 'https://m.media-amazon.com/images/M/MV5BMTU3NjE5NzYtYTYyNS00MDVmLWIwYjgtMmYwYWIxZDYyNzU2XkEyXkFqcGdeQXVyNzQzNzQxNzI@._V1_SY1000_SX677_AL_.jpg',
    title: 'The Great Train Robbery',
    fullplot: "Among the earliest existing films in American cinema - notable as the first film that presented a narrative story to tell - it depicts a group of cowboy outlaws who hold up a train and rob the passengers. They are then pursued by a Sheriff's posse. Several scenes have color included - all hand tinted.",
    languages: [ 'English' ],
    released: ISODate('1903-12-01T00:00:00.000Z'),
    directors: [ 'Edwin S. Porter' ],
    rated: 'TV-G',
    awards: { wins: 1, nominations: 0, text: '1 win.' },
    lastupdated: '2015-08-13 00:27:59.177000000',
    year: 1903,
    imdb: { rating: 7.4, votes: 9847 },
    countries: [ 'USA' ],
    tomatoes: {
      viewer: { rating: 3.7, numReviews: 2559, meter: 75 },
      fresh: 6,
      critic: { rating: 7.6, numReviews: 6, meter: 100 },
      rotten: 0,
      lastUpdated: ISODate('2015-08-08T19:16:10.000Z')
    },
    num_mflix_comments: 0
  }
]

或者，使用$unset阶段排除字段。

有条件地排除字段

可以在聚合表达式中使用变量 REMOVE 来有条件地隐藏字段。

The following $project stage uses the REMOVE variable to exclude the imdb.votes field if it equals null or is an empty string:

db.movies.aggregate( [
   { $match: { title: "This Is Spinal Tap" } },
   {
      $project: {
         title: 1,
         "imdb.rating": 1,
         "imdb.id": 1,
         "imdb.votes": {
            $cond: {
               if: { $in: [ "$imdb.votes", [ null, "" ] ] },
               then: "$$REMOVE",
               else: "$imdb.votes"
            }
         }
      }
   },
   { $limit: 1 }
] )

[
  {
    _id: ObjectId('573a1398f29313caabce94a3'),
    title: 'This Is Spinal Tap',
    imdb: { rating: 8, id: 88258 }
  }
]

由于 imdb.votes 在此 document 中为空 string，因此MongoDB会从输出中排除该字段。

提示

与 $addFields 的比较

您可以使用 $addFields 或 $project 阶段删除文档字段。最佳方法取决于您的管道以及您希望保留多少原始文档。

要查看在 $addFields 阶段中使用 $$REMOVE 的示例，请参阅删除字段。

包含嵌入文档中的特定字段

movies集合中的document包含嵌入式 imdbdocument，其中包含 rating、votes 和 id 字段。要仅包含 rating字段从imdb document中，请使用点表示法：

db.movies.aggregate( [
   { $match: { title: "The Great Train Robbery" } },
   { $project: { "imdb.rating": 1 } },
   { $limit: 1 }
] )

[
  {
    _id: ObjectId('573a1390f29313caabcd42e8'),
    imdb: { rating: 7.4 }
  }
]

或者，将包含规范嵌套在 document 中：

db.movies.aggregate( [
   { $match: { title: "The Great Train Robbery" } },
   { $project: { imdb: { rating: 1 } } },
   { $limit: 1 }
] )

[
  {
    _id: ObjectId('573a1390f29313caabcd42e8'),
    imdb: { rating: 7.4 }
  }
]

包含已计算字段

以下 $project 阶段添加 leadActor 和 releaseYear 字段：

db.movies.aggregate( [
   { $match: { title: "The Great Train Robbery" } },
   {
      $project: {
         title: 1,
         leadActor: { $arrayElemAt: [ "$cast", 0 ] },
         releaseYear: "$year"
      }
   },
   { $limit: 1 }
] )

[
  {
    _id: ObjectId('573a1390f29313caabcd42e8'),
    title: 'The Great Train Robbery',
    leadActor: 'A.C. Abadie',
    releaseYear: 1903
  }
]

投影新数组字段

以下操作将 year 和 runtime 字段投影为新 myArray字段中的元素：

db.movies.aggregate( [
   { $match: { title: "The Great Train Robbery" } },
   { $project: { myArray: [ "$year", "$runtime" ] } },
   { $limit: 1 }
] )

[
  {
    _id: ObjectId('573a1390f29313caabcd42e8'),
    myArray: [ 1903, 11 ]
  }
]

如果数组规范包含文档中不存在的字段，则该操作将 null 替换为该字段的值。

示例，对于与上述相同的文档，以下操作将字段 year、runtime 和不存在的字段$someField 投影为新字段myArray 中的元素：

db.movies.aggregate( [
   { $match: { title: "The Great Train Robbery" } },
   { $project: { myArray: [ "$year", "$runtime", "$someField" ] } },
   { $limit: 1 }
] )

[
  {
    _id: ObjectId('573a1390f29313caabcd42e8'),
    myArray: [ 1903, 11, null ]
  }
]

本页上的C#示例使用Atlas示例数据集中的 sample_mflix数据库。要学习；了解如何创建免费的MongoDB Atlas 群集并加载示例数据集，请参阅MongoDB .NET/ C#驱动程序文档中的入门。

要使用MongoDB .NET/ C#驾驶员添加 $project 阶段，请对 PipelineDefinition对象调用 Project() 方法并传递 ProjectionDefinitionBuilder<TDocument>对象。 TDocument 是表示集合文档的类。

在输出文档中包含特定字段

要在使用.NET/ C#驾驶员时包含特定字段，请对投影构建器调用 Include() 方法。您可以链式 Include() 调用以包含多个字段。

以下代码示例生成的文档仅包含 _id、plot 和 title 字段：

var pipeline = new EmptyPipelineDefinition<Movie>()
    .Project(
        Builders<Movie>.Projection
            .Include(m => m.Title)
            .Include(m => m.Plot)
    );

{ "_id" : "...", "plot" : "...", "title" : "!Women Art Revolution" }

从输出文档中排除字段

要在使用.NET/ C#驾驶员时从结果文档中排除某个字段，请对投影构建器调用 Exclude() 方法。您可以链式 Exclude() 调用以排除多个字段。

以下代码示例生成一个排除 Type 字段的文档：

var pipeline = new EmptyPipelineDefinition<Movie>()
    .Project(
        Builders<Movie>.Projection
            .Exclude(m => m.Type)
    );

{ "_id" : "...", "title" : "!Women Art Revolution", "..." : "..." }

默认下，结果文档包含 _id字段。以下示例不包括 _id，但包括 plot 和 title 字段：

var pipeline = new EmptyPipelineDefinition<Movie>()
    .Project(
        Builders<Movie>.Projection
            .Exclude(m => m.Id)
            .Include(m => m.Title)
            .Include(m => m.Plot)
    );

{ "plot" : "...", "title" : "!Women Art Revolution" }

从嵌入式文档中排除字段

要在使用.NET或.NET/ C#驾驶员时排除嵌入式文档中的字段，请对投影构建器调用 Exclude() 方法，并将路径传递给相应的类属性。您可以链式 Exclude() 调用以排除多个字段。

以下代码示例生成一个排除 imdb.id 和 type 字段的文档：

var pipeline = new EmptyPipelineDefinition<Movie>()
    .Project(
        Builders<Movie>.Projection
            .Exclude("Imdb.id")
            .Exclude(m => m.Type)
    );

{ "_id" : "...", "title" : "!Women Art Revolution", "..." : "..." }

注意

将字符串用于嵌入式 ID 字段

要在嵌入式文档中投影 ID 字段，请将字段名称指定为字符串，而不是 lambda 表达式。

有条件地排除字段

可以在聚合表达式中使用变量 REMOVE 来有条件地隐藏字段：

var stage = new BsonDocument
{
    { "title", 1 },
    { "imdb.id", 1 },
    { "imdb.rating", 1 },
    {
        "imdb.votes", new BsonDocument("$cond", new BsonDocument
        {
            { "if", new BsonDocument("$eq", new BsonArray { "", "$imdb.votes" }) },
            { "then", "$$REMOVE" },
            { "else", "$imdb.votes" }
        })
    }
};
var pipeline = new EmptyPipelineDefinition<Movie>()
    .Project(stage);

{ "_id" : "...", "title" : "!Women Art Revolution", "imdb" : { "id" : "...", "rating" : "...", "votes" : "..." } }

注意

没有用于条件排除的构建器

前面的示例使用 BsonDocument 对象，因为.NET/ C#驾驶员不提供用于有条件地排除字段的构建器。其他MongoDB语言驱动程序可能支持此功能。有关更多信息，请参阅MongoDB驾驶员文档。

包含已计算字段

要在使用.NET/ C#驾驶员时在结果文档中包含计算字段，请在投影构建器上调用 Expression() 方法并传递包含计算字段的表达式。为了提高类型安全性，您可以为结果文档定义模型类，例如以下 ProjectedMovie 类：

[BsonIgnoreExtraElements]
public class ProjectedMovie
{
    [BsonId]
    public ObjectId Id { get; set; }
    public string Title { get; set; } = null!;
    public string? LeadActor { get; set; }
    public List<string>? Crew { get; set; }
}

以下代码示例生成一个包含多个计算字段的文档：

var pipeline = new EmptyPipelineDefinition<Movie>()
    .Project(
        Builders<Movie>
            .Projection
            .Expression(m => new ProjectedMovie
            {
                Id = m.Id,
                Title = m.Title,
                LeadActor = m.Cast![0],
            })
    );

{ "_id" : "...", "Title" : "!Women Art Revolution", "LeadActor" : "Lynn Hershman-Leeson", "Crew" : null }

投影新数组字段

要在使用.NET/ C#驾驶员时在结果文档中项目新的大量字段，请在投影构建器上调用 Expression() 方法并传递包含新大量字段的表达式。为了提高类型安全性，您可以为结果文档定义模型类，例如以下 ProjectedMovie 类：

[BsonIgnoreExtraElements]
public class ProjectedMovie
{
    [BsonId]
    public ObjectId Id { get; set; }
    public string Title { get; set; } = null!;
    public string? LeadActor { get; set; }
    public List<string>? Crew { get; set; }
}

以下代码示例生成的文档包含一个新数组字段 crew，其中包含来自 directors 和 writers 字段的值：

var pipeline = new EmptyPipelineDefinition<Movie>()
    .Project(
        Builders<Movie>
            .Projection
            .Expression(m => new ProjectedMovie
            {
                Id = m.Id,
                Title = m.Title,
                LeadActor = m.Cast![0],
                Crew = m.Directors!.Concat(m.Writers!).ToList()
            })
    );

{ "_id" : "...", "Title" : "$", "LeadActor" : "Warren Beatty", "Crew" : ["..."] }

如果大量规范包含文档中不存在的字段，则管道会将 null 替换为该字段的值。示例，以下代码示例将字段 directors、writers 和不存在的字段makeupArtists 投影为名为 crew 的新字段中的元素：

var stage = new BsonDocument
{
    { "crew", new BsonArray { "$directors", "$writers", "$makeupArtists" } }
};
var pipeline = new EmptyPipelineDefinition<Movie>()
    .Project(stage);

{ "_id" : "...", "crew" : [["..."], null, null] }

注意

构建器类防止字段缺失

前面的示例使用 BsonDocument 对象，因为如果您尝试使用构建者向大量添加缺失字段， .NET/ C#驾驶员会返回编译时错误。其他MongoDB语言驱动程序可能支持此功能。有关更多信息，请参阅MongoDB驾驶员文档。

本页上的 Node.js 示例使用 Atlas 示例数据集中的 sample_mflix数据库。要学习如何创建免费的MongoDB Atlas 集群并加载示例数据集，请参阅MongoDB Node.js驱动程序文档中的入门。

要使用MongoDB Node.js驱动程序将 $project 阶段添加到聚合管道，请在管道对象中使用 $project操作符。

以下各节展示如何自定义 $project 阶段的输出文档。

在输出文档中包含特定字段

要包括特定字段，请在 $project 阶段将字段的值设置为 1。

以下示例返回仅包含 _id、plot 和 title 字段的文档：

const pipeline = [
  {
    $project: {
      title: 1, 
      plot: 1
    }
  }
];
const cursor = collection.aggregate(pipeline);
return cursor;

输出文档类似于以下示例：

{
  _id: new ObjectId('573a1390f29313caabcd42e8'),
  plot: 'A group of bandits stage a brazen train hold-up, only to find a
            determined posse hot on their heels.',
  title: 'The Great Train Robbery'
}

从输出文档中排除字段

要排除特定字段，请在 $project 阶段将字段的值设置为 0。

以下示例返回排除 type 字段的文档：

const pipeline = [
  {
    $project: {
      type: 0
    }
  }
];
const cursor = collection.aggregate(pipeline);
return cursor;

默认下，结果文档包含 _id字段。以下示例返回不包含 _id字段但包含 plot 和 title 字段的文档：

const pipeline = [
  {
    $project: {
      _id: 0, 
      title: 1,
      plot: 1 
    }
  }
];
const cursor = collection.aggregate(pipeline);
return cursor;

输出文档类似于以下示例：

{
  plot: 'A group of bandits stage a brazen train hold-up, only to find a
            determined posse hot on their heels.',
  title: 'The Great Train Robbery'
}

从嵌入式文档中排除字段

要排除嵌入式文档中的字段，请在 $project 阶段将字段路径的值设置为 0。

注意

使用字符串作为嵌入字段

要在嵌入式文档中投影字段，请将字段路径指定为字符串。

以下示例返回排除 imdb.id 和 type 字段的文档：

const pipeline = [
  {
    $project: {
      "imdb.id": 0, 
      type: 0
    }
  }
];
const cursor = collection.aggregate(pipeline);
return cursor;

输出文档类似于以下示例：

{
  plot: 'A group of bandits stage a brazen train hold-up, only to find a
            determined posse hot on their heels.',
  title: 'The Great Train Robbery',
  imdb: { rating: 7.4000000000000004, votes: 9847 }
}

有条件地排除字段

要有条件地排除字段，请将包含变量 REMOVE 的条件逻辑分配到字段名称。

const pipeline = [
  {
    $project: {
      title: 1,
      "imdb.id": 1, 
      "imdb.rating": 1,
      "imdb.votes": {
        $cond: {
          if: { $eq: ["$imdb.votes", ""] },
          then: "$REMOVE",
          else: "$imdb.votes"
        }
      }
    }
  }
];
const cursor = collection.aggregate(pipeline);
return cursor;

如果文档包含 imdb.votes 字段，管道将返回类似于以下示例输出的文档：

{
  _id: new ObjectId('573a1390f29313caabcd42e8'),
  title: 'The Great Train Robbery',
  imdb: { rating : 7.4000000000000004, id: 439, votes: 9847 }
}

如果文档不包含 imdb.votes字段，管道将返回类似于以下示例输出的文档：

{
  _id: new ObjectId('573a1390f29313caabcd42e8'),
  title: 'This Is Spinal Tap',
  imdb: { rating: 8.0, id: 88258 }
}

包含已计算字段

要在结果文档中包含计算字段，请将表达式分配给存储结果的字段。

以下示例将 _id 和 title 字段投影到同名的新字段中，并计算出新字段 leadActor。然后，该示例返回包含这些字段的文档：

const pipeline = [
  {
    $project: {
      _id: "$_id",
      title: "$title",
      leadActor: { $arrayElemAt: ["$cast", 0] }
    }
  }
];
const cursor = collection.aggregate(pipeline);
return cursor;

{
  _id: new ObjectId('573a1390f29313caabcd42e8'),
  title: 'The Great Train Robbery',
  leadActor: 'A.C. Abadie'
}

投影新数组字段

要在结果文档中投影新的数组字段，请将计算新的数组字段的表达式分配给存储数组的字段。

以下示例返回文档包含一个新数组字段 crew 的文档，该字段合并了 directors 和 writers 字段中的值：

const pipeline = [
  {
    $project: {
      _id: "$_id",
      title: "$title",
      leadActor: { $arrayElemAt: ["$cast", 0] },
      crew: { $concatArrays: ["$directors", "$writers"] }
    }
  }
];
const cursor = collection.aggregate(pipeline);
return cursor;

示例输出：

{
  _id: new ObjectId('573a1395f29313caabce2297'),
  title: 'The Chalk Garden',
  leadActor: 'Deborah Kerr',
  crew: ['Ronald Neame', 'John Michael Hayes (screenplay)', 'Enid Bagnold (from the play by)']
}

如果大量规范包含文档中没有的字段，则管道会将 null 替换为该字段的值。示例，以下示例将字段 directors、writers 和不存在的字段makeupArtists 投影为名为 crew 的新字段中的元素：

const pipeline = [
  {
    $project: {
      crew: ["$directors", "$writers", "$makeupArtists"]
    }
  }
];
const cursor = collection.aggregate(pipeline);
return cursor;

示例输出：

{
  _id: new ObjectId('573a1399f29313caabced0d9'),
  crew: [['Bill Kroyer'], ['Jim Cox (screenplay)', 'Diana Young (original stories)'], null]
}

了解详情

有关常见聚合任务的更多信息，请参阅完整的聚合管道教程。

要学习；了解有关此页面上的表达式和变量的更多信息，请参阅：

$ 项目 （聚合阶段）

定义

兼容性

语法

行为

包含字段

_id字段

排除字段

有条件地排除字段

添加新字段或重置现有字段

字面值

字段重命名

新的数组字段

嵌入式文档字段

嵌入式字段中的路径冲突错误

$ 项目阶段布局

空规格

数组索引

示例

在输出文档中包含特定字段

抑制输出文档中的_id字段

从输出文档中排除字段

从嵌入式文档中排除字段

有条件地排除字段

包含嵌入文档中的特定字段

包含已计算字段

投影新数组字段

在输出文档中包含特定字段

从输出文档中排除字段

从嵌入式文档中排除字段

有条件地排除字段

包含已计算字段

投影新数组字段

在输出文档中包含特定字段

从输出文档中排除字段

从嵌入式文档中排除字段

有条件地排除字段

包含已计算字段

投影新数组字段

了解详情

$ 项目（聚合阶段）