运行聚合管道
您可以使用 Atlas 用户界面通过构建聚合管道来处理数据。聚合管道根据所选管道阶段将文档转换为聚合结果。
Atlas 聚合管道构建器主要用于构建管道，而不是执行管道。管道构建器提供了一种导出管道以在驱动程序中执行的简单方法。
所需角色
要在 Atlas 用户界面中创建并执行聚合管道，您必须具有Project Data Access Read Only角色或更高级别。
要在管道中使用$out阶段，您必须具有Project Data Access Read/Write角色。
访问聚合管道构建器
为该集合选择数据库。
主面板和左侧的 Namespaces 列出数据库中的集合。
从左侧或主面板中选择集合。
主面板显示 Find、Indexes 和 Aggregation 视图。
选择 Aggregation（聚合）视图。
当您首次打开Aggregation视图时，Atlas 会显示一个空的聚合管道。
创建聚合管道
选择聚合阶段。
从左下角面板的 Select（选择）下拉菜单中选择聚合阶段。
下拉列表右侧的切换指示是否已启用该阶段。
根据需要为管道添加其他阶段。
有两种方法可以向管道添加附加阶段：
单击管道底部的 Add Stage 按钮，在管道末端添加新阶段：
单击一个阶段上的 按钮可在该阶段之后直接添加新阶段。
要删除某一管道阶段，请对所需阶段单击 Delete。
为每个其他阶段重复步骤 1 和 2。
排序规则
使用排序规则指定特定于语言的字符串比较规则，例如字母大小写和重音符号规则。
要指定排序规则文档，请点击管道构建器顶部的 Collation（排序规则）。
排序规则文档包含以下字段：
{ locale: <string>, caseLevel: <boolean>, caseFirst: <string>, strength: <int>, numericOrdering: <boolean>, alternate: <string>, maxVariable: <string>, backwards: <boolean> }
locale字段为必填字段；所有其他排序规则字段都是可选的。有关字段的说明，请参阅排序规则文档。
从文本导入 Aggregation Pipeline
您可以将聚合管道从纯文本导入到管道构建器中，以轻松修改和验证管道。
要从纯文本导入管道，请执行以下操作：
打开 New Pipeline from Text 对话框。
单击管道构建器顶部加号图标旁边的箭头。
单击 New Pipeline from Text（连接）。
![从文本对话框打开新管道的截图。]()
点击放大
在此对话框中键入或粘贴管道。
您的管道必须与db.collection.aggregate()方法的pipeline参数的语法匹配。
单击 Create New。
在随后的对话框中单击 Confirm（确认）。
重置管道
要使管道返回到初始空白状态，单击管道构建器顶部的“+”图标。
将聚合管道导出为驱动程序语言
您可以使用聚合管道构建器将完成的管道导出为支持的驱动程序语言之一； Java、Node、C# 和 Python 3 。使用此功能来格式化和导出管道，以便在应用程序中使用。
要导出聚合管道，请执行以下操作：
构建聚合管道。
有关聚合管道的说明，请参阅创建聚合管道（Create an Aggregation Pipeline）。
单击管道构建器顶部的 Export to Language（导出到语言）。
选择所需的导出语言。
在 Export Pipeline To 下拉菜单中，选择所需的语言。
左侧的My Pipeline窗格以mongosh语法显示您的管道。
右侧窗格将以所选语言显示您的管道。
如果需要，可包括 import 语句。
（可选） ：选中 Include Import Statements 选项，以包含选定语言所需的导入语句。
点击 Copy 按钮。
单击管道右上方的 Copy（复制）按钮，从而将所选语言的管道复制到剪贴板。现在，您可将管道集成到应用程序中。
单击 Close，返回到聚合管道创建器。
配置聚合管道设置
您可以在 Atlas 用户界面中配置聚合管道设置。
限制
Atlas 将以下阶段的预览输入文档数量限制为 100,000 个：
此限制支持预览更快地运行。当管道运行时，Atlas 不会应用限制。
您无法在 Atlas 用户界面中更改预览输入文档的限制。要使用Compass更改输入文档的限制，请参阅聚合管道构建器设置。
修改聚合管道设置
修改 aggregation pipeline 构建者设置：
单击管道构建器右上方的 图标。
根据需要修改管道设置。
您可以在 Atlas 用户界面中修改以下设置：
设置 | 说明 | 默认 |
|---|---|---|
Comment Mode | 启用后，Atlas 会向每个阶段添加助手注释。 注意更改此设置只会影响新阶段，而不会修改已添加到管道中的阶段。 | On（开启） |
Number of Preview Documents | 每个阶段的预览中所显示的文档数。 注意每个阶段最多只能预览 20 个文档。 | 10 |